· 2 min read
Nocturne outputs pure static HTML. That means you can host it for free on Cloudflare Pages.
Here's the full walkthrough.
Prerequisites
- Nocturne installed locally
- A GitHub account
- A Cloudflare account (free)
Step 1 — Push to GitHub
git init
git add .
git commit -m "initial commit"
git remote add origin https://github.com/YOUR_USERNAME/nocturne-docs.git
git push -u origin main
Step 2 — Test the Build
npm run build
You should see:
[SUCCESS] Generated static files in "build".
Step 3 — Connect to Cloudflare Pages
- Go to pages.cloudflare.com
- Click Create a project
- Click Connect to Git
- Authorize Cloudflare
- Select your repository
Step 4 — Configure Build
| Setting | Value |
|---|---|
| Framework preset | Docusaurus |
| Build command | npm run build |
| Build output directory | build |
| Node version | 18 |
Step 5 — Deploy
Click Save and Deploy.
After 1–2 minutes, your site is live at:
https://your-project.pages.dev
Step 6 — Custom Domain
- Project → Custom domains
- Click Set up a domain
- Enter your domain
- Follow the DNS instructions
Automatic Rebuilds
Every push to main triggers a new build:
git add .
git commit -m "Update docs"
git push
Cloudflare rebuilds automatically.