1. Work
  2. This Website
  3. Docs

This Website

Static Astro site that holds every project's summary, install steps and docs, built on the ADM UI Kit.

1 min read

What it does

  • Shows every curated project with a summary, install steps, full docs and an update log.
  • Lists coursework and blog posts, with an RSS feed and a sitemap.
  • Follows the system light or dark theme. A button lets you change it.

How it works

scripts/import.mjs reads projects.json. For each entry, it copies the project README into src/content/projects/<slug>/index.md, tidies it, and copies the images. It never overwrites a file that exists, so manual edits stay. It also writes the recent git commits to src/data/updates/<slug>.json.

Astro content collections check the frontmatter with a schema. Each page is static HTML. The only JavaScript is the theme script and the copy button on code blocks.

The styles use the ADM UI Kit tokens (--adm-* CSS variables). The fonts are self-hosted, so the page makes no third-party requests.

Commands

Command Result
npm install Installs the pinned packages.
npm run dev Starts the dev server at http://localhost:4321.
npm run build Writes the static site to dist/.
npm run check Runs the Astro and TypeScript checks.
npm run import Imports new projects from the sibling repo folders.

Security

public/_headers sets a strict content security policy, HSTS, X-Frame-Options: DENY, nosniff, a referrer policy and a permissions policy. The site has no forms, no backend and no analytics.

Back to top