Runic Artifex Website
The static marketing site for the Runic SDK products, served at
https://runic-artifex.eu.
Built with SvelteKit, Svelte 5, and @sveltejs/adapter-static.
Develop and verify
Use Node from .node-version and Bun from package.json:
bun install --frozen-lockfile
bun run dev
bun run lint
bun run check
bun run test
bun run test builds the site and checks the rendered routes and links. After dependencies are installed, builds need no network access or sibling repository. On NixOS in the shared workspace, reuse the locked application SDK environment with direnv exec ../runic-sdk bun run test.
Run bun install --frozen-lockfile separately in docs/, then use
bun run docs:check and bun run docs:test from this repository root.
The two applications have separate locks and CI artifacts; neither requires
building product SDK packages. See the ownership and cutover plan.
Changes reach main only through pull requests that pass the verify check;
see CONTRIBUTING.md. Report vulnerabilities as described in
SECURITY.md.
Maintain content
The homepage explains what Runic does, shows it working, and links into the
documentation. Update product names, descriptions and links in
src/lib/products.ts. The first screen shows the application template's
counter page: src/lib/seam.ts holds excerpts of its C# ViewModel and of each
frontend, so update them when the template's counter page changes.
Installation details, package availability, and portal guides live in
docs/, published at
docs.runic-artifex.eu. Package READMEs,
specifications and canonical Translations guides remain product-owned and are
linked from the portal. The marketing site has no generated release or CI
state to synchronize.
Brand
The palette, fonts, wordmark and product glyphs come from
runic-brand, whose guidelines
explain the system. Its sync script writes src/lib/brand/tokens.css,
src/lib/brand/marks.json, static/brand/marks/, static/favicon.svg,
static/icon.png and static/og.png here, and the same files under docs/.
Do not edit those files by hand; change the brand source and run
npm run sync:workspace in runic-brand.
Deployment contract
runic-artifex.eu serves the static build/ output from this repository.www.runic-artifex.eu redirects permanently to the apex origin.docs.runic-artifex.eu serves the independent docs/build/ output from this repository./schemas/translations/* on the apex is included in root build/ by deterministically mirroring the portal's pinned Translations schemas (currently Runic Translations 0.8.0) plus retained legacy schemas such as editor-state-v1, which a newer pin no longer ships but whose URL stays published. Preserve these public schema URLs when changing deployments./ci/ remains a lightweight link to SDK Actions for existing bookmarks.
License
MIT.
