# Haute Lumière — install

A self-contained editorial design system. No build step, no package manager,
no dependency on any other design system.

## One line

```html
<script src="ds-base.js"></script>
```

That loads `styles.css`, which imports the whole token layer: fonts, the seven
registers, type, space, motion, surfaces, the eight platform surfaces, print
geometry. The loader resolves its path from its own URL, so it works from the
project root, a subfolder, or a bundled copy without being edited.

Then choose a register and a surface on the root element:

```html
<html data-register="dusk" data-surface="ios">
```

Registers: `aurora` · `daylight` · `solstice` · `dusk` · `vespers` · `midnight` · `nocturne`
Surfaces: `web` · `app` · `ios` · `android` · `desktop` · `watch` · `eink`

The two are orthogonal — any register on any surface. Nothing else in the
document needs to change; the palette, the rules, the grain blend mode and the
photographic grade all follow.

## What is in the box

| Path | What it is |
|---|---|
| `styles.css` | The entry point. `@import` lines only. |
| `ds-base.js` | The one-line loader. |
| `tokens/` | fonts · colors (7 registers) · typography · spacing · motion · surfaces · platform · print |
| `components/` | `editorial/` `layout/` `data/` `apparatus/` `chrome/` `app/` — React sources, `.d.ts` contracts, and per-component prompt notes |
| `guidelines/` | 30 specimen cards: registers, photographic grades, type, spacing, brand, print, platform |
| `templates/issue/` | A complete 24-spread issue, running on the system, ready to re-fill |
| `readme.md` | The full brand context, voice, doctrine and index |
| `SKILL.md` | The agent manifest — read this first if you are a model |

## Fonts

Cormorant Garamond and Manrope are served from Google Fonts at the exact weights
the system uses. No binaries were supplied with the source material. If licensed
originals become available, drop `.woff2` files into `assets/fonts/` and replace
the `@font-face` rules in `tokens/fonts.css`.

## Using it in a new project

Copy this folder in whole. Nothing points outside it.

To start an issue, copy `templates/issue/` and re-fill it — the page kinds,
the register bar, the constellation index, the Works Cited apparatus and the
PDF export are already wired.

## The rules that are not negotiable

1. Seven registers on `<html data-register>`. **Gold is a mark, never a fill.**
2. If a human would read it aloud, it is serif.
3. Bleed (`object-position: 50% 0%`) or uncut (`object-fit: contain`). Never cut the top of a head. Never reuse a photograph across issues.
4. Radius zero, one shadow, hairline rules — on app surfaces too.
5. Every issue carries a Works Cited spread, never trimmed to fit.
6. On glass the hit area grows and the mark never does.
