projects-hub

Umbrella GitHub Pages site serving multiple projects under one custom domain:

https://projects.lalitkumar.dev/{project}/

Each project keeps its source in its own repository. On every push to that project's main branch, a CI workflow builds the project and pushes the built output into this repo under /<project-name>/. GitHub Pages on this repo serves the merged tree.

Projects

Populated as each project is wired up.

Path	Source repo
none yet	none yet

How a project gets added

1. In the project repo, set the build's base path to /<project-name>/ (e.g. base: '/contact-details-page/' in vite.config).
2. Add HUB_DEPLOY_TOKEN (a fine-grained PAT with write access to this repo) as a secret on the project repo.
3. Add .github/workflows/deploy-to-hub.yml to the project repo (see the pattern in docs/per-project-workflow.yml if checked in, or the plan file).
4. Push or workflow_dispatch it. The output lands in <project-name>/ on this repo's main branch and Pages republishes.

Architecture

project repo --build--> dist/  --(actions-gh-pages, keep_files: true)-->  projects-hub/<project>/
                                                                                   |
                                                                                   v
                                                                  projects.lalitkumar.dev/<project>/

keep_files: true in the deploy action is critical — without it, each project push would wipe every other project's directory.