Shared frontend for ISO/TC 211 Astro sites — the successor to the jekyll-theme-isotc211 gem. Target stack: Astro 7 + Vite 8 + Vue islands + Tailwind 4.
packages/astro-ui/— the publishable npm package@isotc211/astro-uipackages/playground/— private Astro site consuming the package viaworkspace:*; living integration test and the copy-paste template for site ports
pnpm install
pnpm dev # playground dev server
pnpm build # playground production build (integration gate)
pnpm check # astro checkReleases via changesets: open a PR with pnpm changeset, merge the automated Version PR on main to publish.
- Ship unbundled source —
exportspoints at.astro/.vue/.ts/.csssources; the consuming site's Vite pipeline compiles them. Do not add a library build step. - No utility classes in package templates — package markup uses BEM component classes from
src/components/*.css. If a utility is unavoidable inside a package template, the consuming site's Tailwind must scan this package (@source "../node_modules/@isotc211/astro-ui") — prefer avoiding utilities entirely. - CSS is ported verbatim from the gem where possible; keep the dark variant (
@custom-variant dark), the@themetokens, and theiso-tc211-themelocalStorage key stable — existing visitors' preferences depend on them.