Skip to main content
Version: Current

Deployment Guide

1. Local Development & Build

Development Environment

npm start

Uses the Create React App dev server with hot reload. Default URL: http://localhost:3000.

Production Build

npm run build

Output goes to the build/ directory, including optimized HTML, JS, CSS, and static assets.


2. Production Deployment (Cloudflare Pages)

Production is hosted on Cloudflare Pages.

ConfigurationValue
Build commandnpm run build
Output directorybuild
SPA supportSupported by default, no extra config

Deployment Steps

  1. Create a Pages project in the Cloudflare Dashboard
  2. Connect your GitHub repo and select the branch
  3. Set the build command and output directory as in the table above
  4. Each push will trigger an automatic build and deploy

Environment Variables

If needed, configure them under SettingsEnvironment variables in the project.


Appendix: Other Hosting Options

PlatformBuild commandOutput directoryNotes
Netlify / Vercelnpm run buildbuildConnect Git to deploy
GitHub Pagesnpm run buildbuildUse gh-pages or Actions
Nginx self-hostedbuild/ directoryRequires SPA fallback config

Nginx SPA Fallback

For self-hosting, unmatched routes must serve index.html:

location / {
try_files $uri $uri/ /index.html;
}