> ## Documentation Index
> Fetch the complete documentation index at: https://shipfree.revoks.dev/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Configuration

> Where ShipFree stores its runtime and product configuration.

# 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.

<Warning>
  Do not read `process.env` directly in app code. Use `env` from `src/config/env.ts` to keep validation consistent.
</Warning>