Setup GitHub Pages for free hosting

Host static sites or frontend builds (HTML/CSS/JS, React/Next static export) for free on GitHub Pages.

1. Repo: Push your project to a GitHub repository. Ensure the build output (e.g. dist/, out, or build/) is generated by npm run build or pnpm run build.
2. Settings: In the repo go to Settings → Pages. Under "Build and deployment" choose "GitHub Actions" (recommended) or deploy from a branch (e.g. main → /root or /docs).
3. GitHub Actions: Add a workflow file (e.g. .github/workflows/deploy.yml) that runs pnpm install && pnpm run build and uploads the build artifact to the gh-pages branch or uses peaceiris/actions-gh-pages. The site will be at https://<username>.github.io/<repo>/.
4. Custom domain (optional): Add a CNAME record pointing to <username>.github.io and set the custom domain in Pages settings.

Ideal for project demos, portfolios, and static frontends; not for dynamic backends or databases.