Cloudflare App Starter

First time setup

mv .env.example .env # setup environment variables
npm install
npm run db:init

Search + replace "cf-app-starter" and "Cloudflare App Starter" with your project name.

Running the dev server

npm run dev

Open a browser to to http://localhost:3000/.

Routing conventions

Routes are flat (no nested directories) and use dot segments for nested paths.

src/routes/
  __root.tsx
  index.tsx
  auth.tsx
  dashboard.route.tsx
  dashboard.index.tsx
  dashboard.todos.tsx
  api.auth.$.ts

Deployment

Deployment is configured via GitHub Actions to run on every push to the main branch.

Before the first deployment, ask the coding agent to make sure we're ready for deployment. It will create the necessary resources in the Cloudflare account (e.g. D1 database, R2 buckets, etc) using the wrangler CLI.