This website is a static Docusaurus site, built with GitHub Actions and hosted on GitHub Pages at radel.dev.
- 01Change & testFeature branch → pull requestMap tests · build · browser checks
- 02Build on mainGitHub Actions · Ubuntu · Node 18npm ci --force → npm run build
- 03Publishbuild/ → gh-pagespeaceiris action · GITHUB_TOKEN
- 04ServeGitHub Pages · HTTPSradel.dev · custom domain
Merging to main triggers the deployment. GitHub Pages serves the generated files.
Libraries & content
- Docusaurus 3 + React 18: routing, documentation, blog pages, and reusable components.
- Markdown + MDX: posts and documentation; CSS Modules + Infima provide the styling, and Prism highlights code.
- React + SVG: the landing-page impact diagram and interactive travel map. Country outlines come from local Natural Earth data, without a map API.
- Static output: HTML, CSS, JavaScript, and images in
build/. No application server or database.
Testing before a merge
- Map tests:
node --test src/components/TravelMap/mapUtils.test.mjschecks destinations, coordinates, pan/zoom limits, and regional views. - Production build:
npm run buildcompiles the site and rejects broken internal URLs. - Browser checks: review desktop, tablet, and phone layouts, navigation, images, and map interactions with
npm run serve. - CI coverage: the deployment workflow runs the production build; the map tests and browser checks are currently local pre-merge checks.
Deployment & hosting
- Trigger: every push to
main, including a merged pull request, starts the Deploy to GitHub Pages workflow. - Runner: Ubuntu checks out the repository with
actions/checkout@v4and installs Node.js 18 withactions/setup-node@v4and npm caching. - Build:
npm ci --forceinstalls the locked dependencies;npm run buildgeneratesbuild/. - Publish:
peaceiris/actions-gh-pages@v3usesGITHUB_TOKENwithcontents: writeto publishbuild/to thegh-pagesbranch. - Domain: the publish action writes
CNAMEforradel.dev; GitHub Pages serves the branch root over HTTPS, with the domain’s DNS pointing to Pages.
