Get started

Quickstart

Run it on your machine and check a change.

  1. Install the dependencies.

    Terminal
    npm install
  2. Create the local database. It applies every migration to a local copy of D1.

    Terminal
    npm run db:migrate:local
  3. Add local secrets. Create .dev.vars next to package.json.

    .dev.vars
    EDIT_PASSCODE=choose-a-long-passcode
  4. Start the app and open http://localhost:3000.

    Terminal
    npm run dev

Checks before a change

Terminal
npm run typecheck
npm run lint
npm run build

Run and validate

Terminal
npm install
npm run db:migrate:local
npm run dev
npm run cf-typegen
npm run typecheck
npm run lint
npm run build
npx opennextjs-cloudflare build
npx wrangler deploy --dry-run --env=""

Only the production D1 binding, article-catalog-db, is part of the Worker configuration. Apply its remote migrations before deploying production. The removed development Worker environment is intentionally not deployable from this repository. The public custom domain is article-journal.appneurox.com.

The committed production D1 resource ID is the deployment source of truth. Keep remote migrations current and configure EDIT_PASSCODE as a Worker secret. Item fallbacks are routed through *.articles.appneural.com/*, matching the managed wildcard certificate for the production hostname. The corresponding subdomain-catalog entry is promoted to Production only after the repository, D1 database, Worker, DNS, TLS, API, and content are independently live-verified.

Last updated 2 November 2026