reactonrails.com

Production site workspace for reactonrails.com, built with Docusaurus.

Architecture

• Canonical markdown source stays in react_on_rails/docs/
• This repo syncs docs at build time into prototypes/docusaurus/docs
• Site-owned pages live here (landing page, examples, Pro page)
• Pro docs are public under docs/pro/

Local Development

1. Install site dependencies:
   • npm run install:site
2. Sync docs from monorepo and prepare local docs tree:
   • npm run prepare
3. Run the site:
   • npm run dev

Build

• Build from prepared docs:
  • npm run build
• Full build from fresh docs sync:
  • npm run build:full

Docs Sync Source Resolution

scripts/sync-docs.mjs resolves the monorepo in this order:

1. REACT_ON_RAILS_REPO env var
2. sibling directory ../react_on_rails
3. shallow clone from REACT_ON_RAILS_REPO_URL (default: upstream GitHub repo)

Cloudflare Pages

• Project: reactonrails-com
• Build output directory: prototypes/docusaurus/build
• One-off deploy from local machine:
  • npm run cloudflare:deploy

For GitHub Actions deploy, configure these repository secrets:

• CLOUDFLARE_API_TOKEN
• CLOUDFLARE_ACCOUNT_ID

Optional repository variable:

• CLOUDFLARE_PAGES_PROJECT (defaults to reactonrails-com)