Skip to content
SimplerSuite Wishlist

Installation

Install the SDK

Terminal window
npm install @simplersuite/wishlist-react
# or
pnpm add @simplersuite/wishlist-react
# or
yarn add @simplersuite/wishlist-react

Get your credentials

1. Storefront Key (for guest access)

  1. Open Settings in the SimplerSuite Wishlist dashboard
  2. Scroll to Headless Access
  3. Click Create Key and copy the sfk_... key ID

Storefront keys are public — safe to embed in client-side code. They only grant guest-level access.

2. API Key + Secret (for customer auth)

  1. Go to Settings → API Keys
  2. Create a new API key and save the secret
  3. Use these server-side to exchange for customer JWTs

Never expose your API secret in client-side code.

Environment variables

Add to your .env:

Terminal window
# Headless API URL (from SST deploy output)
PUBLIC_WISHLIST_API=https://xxx.execute-api.us-east-1.amazonaws.com


# Public storefront key (safe for client-side)
PUBLIC_WISHLIST_STOREFRONT_KEY=sfk_your_key_here


# Server-side only (for customer token exchange)
WISHLIST_API_KEY=key_your_key_here
WISHLIST_API_SECRET=sk_your_secret_here