Deployment

Configure Project Name

Update the wrangler.jsonc file with your project name:

{
  "name": "your-project-name" // Change to your project name
}

Configure Custom Domain

Update the wrangler.jsonc file with your website domain:

"routes": [
  {
    "pattern": "your-domain.com", // Change to your domain
    "custom_domain": true
  }
],

Setup Environment Variables

Copy .env to .env.production and update values with production settings:

cp .env .env.production

# Edit .env.production with production values
# VITE_BASE_URL='https://your-domain.com'
# STRIPE_SECRET_KEY='your-stripe-live-secret-key'
# Other variables - carefully check and update as needed for production

Set Build-time Environment Variables

Run the following command to sync build-time environment variables to GitHub Secrets:

pnpm sync-github-secrets

This script performs two operations internally:

1. Sync deploy.yml with .env.production: Ensures the GitHub Actions workflow's env block includes all build-time variables (VITE_*, CLOUDFLARE_*) defined in .env.production. Missing environment variables are automatically added.
2. Push secrets to GitHub: Reads all non-empty variables from .env.production and sets them as GitHub Secrets via gh secret set.

Ensure .env.production exists and gh is installed and authenticated.

Set Runtime Environment Variables

Run the following command to set runtime environment variables for the Worker:

pnpm sync-worker-secrets

This command internally executes wrangler secret bulk .env.production, reading non-empty variables from .env.production and bulk-setting them as Worker runtime secrets via the Wrangler CLI.

Build & Deploy

pnpm run deploy