Black-stage Astro site. The works generate the visual variation; the interface stays monochrome. Stack: Astro + MDX + vanilla CSS/TS. Nothing else.

npm install
npm run dev       # http://localhost:4321/art/
npm run build     # static output in dist/
npm run preview   # serve the build
npm run check     # type-check

Deploy: push to master — .github/workflows/deploy.yml builds art/ and publishes the whole site (repo root + art/dist/ at /art/) to GitHub Pages. One-time: Settings → Pages → Source = "GitHub Actions".

All content is MDX files in src/content/. Edit a file, push, done. Media files (images, videos) go in src/assets/media/ and are referenced by file name. Facts come only from supplied source material; mark gaps with <p class="todo">…</p> — never invent.

EN is the default (unprefixed URLs), IT lives under /it/. The entry page redirects to the browser language; a manual choice in the header switch (EN/IT codes) is stored and overrides the browser thereafter. Deep links never redirect. Content without a translation falls back to the only language available — Italian source prose shows on English pages, English-only strings on Italian ones.

To add a language: add its code to locales in src/lib/i18n.ts, add its ui dictionary, and mirror the page wrappers from src/pages/it/ into src/pages/<code>/.

Create src/content/works/my-work.mdx:

---
title: My Work
year: 2025
practice: dowse            # optional — links the work to a practice
hero:
  type: image              # image | video | peertube | svg | code | hasciicam
  src: my-image.png        # file in src/assets/media/
  alt: Describe the image for screen readers.
---

MDX body — prose, or components: <Statement> <Essay> <FullBleed>
<Media> <Caption> <Meta> <RelatedWorks>.

The one practice: line is the whole association: the practice page lists the work, the work page shows the practice. Nothing else to edit.

Create src/content/practices/my-practice.mdx — same shape, plus statement: (one or two sentences, shown on the stage) and optional yearFrom, status: ongoing|archived, currentRealization: <work-slug>. To show it on the homepage stage, add its slug to sequence in src/pages/index.astro.

src/content/exhibitions/my-exhibition.mdx with title, optional curator, showings: (list of year / venue / city), and works: (slugs).

Self-hosted, plays through a plain <video>:

type: video
sources: [{ src: my-clip.webm, type: video/webm }]
poster: my-poster.png     # optional
aspect: 16 / 9
autoplay: false           # autoplay only ever plays muted
muted: true
loop: false
controls: true

PeerTube — lazy by design (poster first, iframe only on activation):

type: peertube
host: video.example.org   # instance hostname
uuid: 9c9de5e8-....       # video UUID
title: Title of the video
poster: my-poster.png     # optional
aspect: 16 / 9

Use either in a hero: or inline in MDX: <Media media={{ … }} />.

The visitor's own camera rendered as ASCII by the WASM build of hasciicam (glue + binary vendored from the dyne.org CI demo into public/hasciicam/). The poster shows until the camera runs and stays as fallback; the camera starts when the media becomes visible/active and every track stops when it is swiped away, hidden, or the page is left. Under reduced-motion or save-data it does not auto-start — a start button appears instead. Frames never leave the browser.

type: hasciicam
poster: hasciicam-eye.png  # fallback/poster, file in src/assets/media/
alt: Describe the live image for screen readers.

To refresh the vendored runtime, download hasciicam.js and hasciicam.wasm from https://dyne.org/hasciicam/demo/ into public/hasciicam/.

• Italian source prose stays in Italian inside <div lang="it">.
• Interface stays monochrome (--black/--white/--grey); colour comes only from artworks. No cards, grids, shadows, badges, hamburger menus.
• Smoke tests (dev only): node stage-test.mjs, a11y-test.mjs, vt-test.mjs, pages-test.mjs, hasciicam-test.mjs against npm run preview.