This repo hosts the marketing / landing pages for my projects. Each project is a self-contained Astro site in its own directory under src/, with its own toolchain and its own deploy workflow, published as a subpath of https://mintware-de.github.io.
├── .github/workflows/<project>.yml # one Pages workflow per project
└── src/
└── <project>/ # a standalone Astro site
├── README.md # project-specific docs (commands, structure, config)
├── astro.config.mjs
└── ...
| Project | Source | Live at |
|---|---|---|
| catalyst_builder | src/catalyst_builder/ |
mintware-de.github.io/catalyst_builder/ |
Each project directory is fully self-contained — package.json, lockfile, config, sources. Everything about a specific site (commands, file layout, i18n, deployment details) lives in its own README.
Every site follows the same shape so they stay interchangeable:
- Static output —
output: 'static', built todist/inside the project (git-ignored). - Subpath hosting — the repo is a user site (
*.github.io), so each project setsbase: /<project>inastro.config.mjsand its workflow stages the artifact nested at that path. The URL prefix appears in exactly three places per project:astro.config.mjs(site/base),public/robots.txt(Sitemap:line), and the workflow's staging path. - One workflow per project —
.github/workflows/<project>.ymlbuilds fromsrc/<project>/and uploads the Pages artifact; repo Pages → Source is GitHub Actions. - Multi-locale sites roll their own
[lang]routing viagetStaticPathswith English as fallback (both page-leveli18n.fallbackand key-level merge), and keep an i18n parity check wired intonpm run check.
- Create
src/<project>/as a fresh Astro site (copying an existing project is the fastest start) and setbase: /<project>. - Add
public/robots.txtwith the matchingSitemap:line. - Add
.github/workflows/<project>.yml— copy an existing one and swap the project name in the paths. - Write a
README.mdinside the project (that's the canonical doc for it) and add a row to the table above.
All commands run inside the project directory:
cd src/<project>
npm install
npm run dev # dev server with hot reload
npm run check # type check (+ any project-specific checks)
npm run build # static build to dist/