Cloudflare Pages provides global CDN acceleration, free SSL certificates, and unlimited bandwidth for personal blogs.

Prerequisites

• Code hosted on GitHub or GitLab
• A Cloudflare account
• site configured in src/config/siteConfig.ts with your official domain

Important

Mandatory Node.js Version Variable Cloudflare Pages build runners default to an older Node.js runtime. You must specify NODE_VERSION = 22 in project Environment variables to meet engine requirements.

Method 1: Git Integration

1. In the Cloudflare Dashboard, navigate to Workers & Pages → Create → Pages → Connect to Git.

2. Select your Git provider, authorize Cloudflare, and choose your Shirone repository.

3. Configure build settings:

   Setting	Value
   Project name	Your project name (determines <name>.pages.dev)
   Production branch	main
   Build command	pnpm build
   Build output directory	dist

4. Under Environment variables, add NODE_VERSION = 22 to satisfy Node.js ≥ 22.12 requirements.

   Important: The default Node.js version in Cloudflare build images is older than 22. Adding this variable is required.

5. Click Save and Deploy.

Method 2: Wrangler CLI

pnpm add -g wrangler

# Build locally
pnpm install
pnpm build

# Deploy output directory
wrangler pages deploy dist --project-name=<your-project-name>

Custom Domains

1. Go to your Pages project in Cloudflare Dashboard and select Custom domains → Set up a custom domain.
2. If your DNS is managed on Cloudflare, DNS records and SSL are configured automatically.
3. If DNS is hosted externally, add a CNAME pointing to <project>.pages.dev.

Troubleshooting

Build Error: Node Version Unsupported

Ensure NODE_VERSION is set to 22 in project Environment variables (under Settings → Environment variables).

Copyright

Copyright Ownership:matsuzaka-yuki

License under:Attribution 4.0 International (CC-BY-4.0)

Contributors: matsuzaka-yuki

Previous pageGitHub Pages

Next pageEdgeOne Pages