Deployment site for 1hour.guide — Learn anything in 1 hour.

This repository is a thin deployment layer that combines:

• Framework: jiusanzhou/tutorial-kit (as framework/ submodule)
• Content: jiusanzhou/1hour-guide-content (as content/ submodule)

1hour-guide/
├─ framework/          # tutorial-kit submodule (Next.js app)
├─ content/            # 1hour-guide-content submodule (MDX tutorials)
├─ build.sh            # Cloudflare Pages build script
├─ package.json        # Convenience scripts
└─ README.md

git clone --recurse-submodules https://github.com/jiusanzhou/1hour-guide.git
cd 1hour-guide
cd framework && pnpm install

If you forgot --recurse-submodules:

git submodule update --init --recursive

./build.sh

Or step by step:

cd framework
CONTENT_DIR=../../content pnpm build

pnpm preview
# Open http://localhost:8000

cd framework
CONTENT_DIR=../../content pnpm dev

pnpm update:content
git push

pnpm update:framework
git push

1. Go to Cloudflare Dashboard → Pages
2. Create a new project → Connect to Git
3. Select this repository
4. Build settings:

5. Environment variables (optional):

   • NODE_VERSION: 22

6. Important: Enable Include submodules in the Git settings.

When content is updated in 1hour-guide-content:

1. Update this repo's submodule: pnpm update:content
2. Push to main
3. Cloudflare rebuilds automatically

Or set up a GitHub Action to auto-bump submodules on content pushes (see .github/workflows/bump-content.yml — TODO).

1. Cloudflare Pages → Your project → Custom domains → Set up a custom domain
2. Add 1hour.guide (and www.1hour.guide if desired)
3. If your domain uses Cloudflare DNS: auto-configured
4. Otherwise: add CNAME 1hour-guide.pages.dev

Content: CC BY-SA 4.0 Framework: MIT