Getting Started

1. Install dependencies

pnpm install

2. Provision local resources

pnpm run setup

The script asks for a project name, then creates (or reuses) a D1 database, R2 bucket, and KV namespace, generates the auth secret, and writes the results to .env and wrangler.jsonc.

If you are not logged in to Cloudflare it warns you but continues — local development uses a SQLite-backed D1 and needs no real resources. To log in:

pnpm exec wrangler login

3. Start the dev server

pnpm dev

Open http://localhost:3000. If the database was not initialized, run it manually:

pnpm exec wrangler d1 migrations apply DB --local

4. Customize the site

All site identity lives in src/config/website.ts:

// src/config/website.ts
export function createWebsiteConfig(env: PublicEnv): WebsiteConfig {
  return {
    baseUrl: env.VITE_BASE_URL,
    metadata: {
      name: 'Jerbix',                        // ← your site name
      images: { ogImage: '/logo.png', /* … */ },
    },
    docs: { enabled: true },                 // ← set false to drop the docs site
    // …
  }
}

See Website Config for every field.

5. Deploy

pnpm deploy

This runs production env validation → build → client bundle leak check → wrangler deploy.

Local .env values do not become production secrets. Configure them separately with wrangler secret put, and never put a secret behind a VITE_ prefix — those are inlined into the browser bundle.

To deploy automatically on push to main, see Cloudflare · CI deployment.