Skip to content
Jylhis Docs

Development

The site is an Astro Starlight project living at projects/docs-site/ in a monorepo. Tooling (bun, node) comes from the project’s devenv shell; recipes are run with just.

Preview locally

Section titled “Preview locally”

From projects/docs-site/:

Terminal window
just dev

The site is served at http://localhost:4321 with hot reload.

Verify

Section titled “Verify”
Terminal window
just check

This runs astro check (type-checking) and astro build. The build also validates internal links: a broken link to a missing page fails the build.

Styling

Section titled “Styling”

The visual theme comes from the Jylhis design system: src/styles/design/ holds vendored copies of tokens.css, fonts.css (self-hosted Literata + JetBrains Mono), and colors_and_type.css. src/styles/starlight-theme.css maps Starlight’s --sl-* variables onto those tokens. When the design system changes, re-vendor the files from its repository.

Deployment

Section titled “Deployment”

Merging to main deploys the site: CI discovers the project by its wrangler.jsonc, builds it with bun, and pushes it to a Cloudflare Worker serving the static assets. docs.j10s.io is bound to that Worker as a custom domain.