.env.example

# Spree API Configuration (server-side only - not exposed to browser)
SPREE_API_URL=http://localhost:3000
SPREE_PUBLISHABLE_KEY=your_publishable_api_key

# Wholesale B2B portal (opt-in addon - powers the gated /wholesale surface)
#
# SPREE_WHOLESALE_CHANNEL is the ON/OFF switch. There is no default: leave it
# unset and the storefront runs DTC-only — every wholesale entry point (nav,
# footer, homepage section) is hidden and the /wholesale routes 404. Set it to
# the code of a gated Spree channel to enable the portal. Requests to that
# surface carry the code via the X-Spree-Channel header.
#
# SPREE_WHOLESALE_PUBLISHABLE_KEY is optional. The channel header alone selects
# the channel, so this falls back to SPREE_PUBLISHABLE_KEY when unset; set it
# only to bind a channel-scoped publishable key.
#
# SPREE_WHOLESALE_CHANNEL=wholesale
# SPREE_WHOLESALE_PUBLISHABLE_KEY=

# Store defaults (should match your Spree store settings)
# These are used by the middleware for initial redirects before API data is loaded
# Set these to your store's default_country_iso and default_locale
NEXT_PUBLIC_DEFAULT_COUNTRY=us
NEXT_PUBLIC_DEFAULT_LOCALE=en
NEXT_PUBLIC_SITE_URL=https://your-store.com
NEXT_PUBLIC_STORE_NAME=Spree Store
NEXT_PUBLIC_STORE_DESCRIPTION=A modern e-commerce storefront powered by Spree Commerce and Next.js.

# Store SEO settings
STORE_SEO_TITLE=
STORE_META_DESCRIPTION=
STORE_META_KEYWORDS=

# Store social / Organization JSON-LD (optional)
STORE_TWITTER=
STORE_FACEBOOK=
STORE_INSTAGRAM=
STORE_LOGO_URL=
STORE_SUPPORT_EMAIL=

# Google Tag Manager (leave empty to disable)
GTM_ID=

# Transactional Emails via Webhooks (optional - uses Resend + react-email)
#
# Development setup:
#   1. Install cloudflared: brew install cloudflared
#   2. Expose your storefront: cloudflared tunnel --url http://localhost:3001
#   3. Create a webhook in Spree Admin → Settings → Developers → Webhooks:
#      URL: https://<your-tunnel-id>.trycloudflare.com/api/webhooks/spree
#      Events: order.completed, order.canceled, order.shipped
#   4. Copy the webhook secret key below
#   5. Emails are written to .next/emails/ as HTML files (no Resend key needed in dev)
#
# Production: set RESEND_API_KEY and EMAIL_FROM to send real emails.
#
SPREE_WEBHOOK_SECRET=your_webhook_endpoint_secret_key
RESEND_API_KEY=
EMAIL_FROM=Your Store <orders@your-domain.com>

# Stripe (optional - required for Stripe payment method)
NEXT_PUBLIC_STRIPE_PUBLISHABLE_KEY=pk_test_your_stripe_publishable_key

# Sentry Error Tracking (optional - set DSN to enable)
SENTRY_DSN=https://examplePublicKey@o0.ingest.sentry.io/0
SENTRY_ORG=your-org
SENTRY_PROJECT=your-project
SENTRY_AUTH_TOKEN=your-auth-token

# Send PII (IP addresses, cookies, user data) to Sentry (default: false)
# Set to "true" only if you have user consent or a privacy policy covering this.
SENTRY_SEND_DEFAULT_PII=false
NEXT_PUBLIC_SENTRY_SEND_DEFAULT_PII=false