Customization

Project defaults — `store.config.ts`

Treat this like a typed _config.yml. Safe to commit; shared across environments:

const storeConfig = {
  site: {
    defaultRegion: "us",
    url: "https://your-store.example.com",
    defaultLocale: "en-US",
  },
  brand: {
    name: "Your Brand",
    tagline: "…",
    contactEmail: "hello@example.com",
    // social links…
  },
  media: {
    publicBaseUrl: "", // or https://img.example.com for CDN
  },
  features: {
    stripe: true,
    paypal: true,
    inpost: false,
    blog: true,
  },
};

Do not put API keys here — use .env / Wrangler secrets.

Live settings — Admin → Settings

Operators change day-to-day shop data without redeploying:

Store profile and announcements
Shipping rates
Discount codes

Stored in D1.

Theme / UI

Storefront: Tailwind CSS v4 + React islands under src/modules and src/pages
Admin: Ant Design 5 + ProComponents under src/admin

Swap fonts, colors, and section layouts in those trees; keep payment and session secrets out of the client bundle.