Skip to main content

​
Configuration

ShipFree centralizes configuration in src/config/ and exposes utilities in src/lib/.

​
Brand config

src/config/branding.ts defines brand metadata and theme colors used by UI and email templates.
  • name, logoUrl, supportEmail
  • theme colors for primary, accent, and background

​
Feature flags

src/config/feature-flags.ts exposes helpers that read validated env values.
  • isBillingEnabled
  • isEmailVerificationEnabled
  • isStripeConfigured, isPolarConfigured

​
Payments catalog

src/config/payments.ts defines plans, features, pricing, and provider product IDs. Update this file when you add or change tiers, pricing, or trial settings.

​
Environment validation

src/config/env.ts uses @t3-oss/env-nextjs and zod to validate runtime variables.
Do not read process.env directly in app code. Use env from src/config/env.ts to keep validation consistent.