Ebook AtlasDocs

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, ebook-catalog-db, is part of the Worker configuration. Its committed resource ID is the production source of truth and its remote migrations must be current before deployment. The public custom domain is ebook-atlas.appneurox.com, with item fallbacks routed through *.ebooks.appneural.com/*.

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