diff --git a/CHANGELOG.md b/CHANGELOG.md index 9c8193a5..b0113e95 100644 --- a/CHANGELOG.md +++ b/CHANGELOG.md @@ -10,6 +10,7 @@ All notable changes to DreamCoder will be documented in this file. - **Sessions are nested in the sidebar.** Sessions the agent started, and conversations you forked, appear under the session they came from, with an icon for each kind and a count that collapses or expands them. Messages from another session appear in the conversation as a one-line row with the sender, which expands to the full text (#239). - **Project board.** Each project gets a persistent board of tasks and sub-tasks that you and your sessions share; every worktree of the project uses the same board. Open it from the project in the sidebar. A task records its owner, reviewer and creator, acceptance criteria, priority, dependencies, progress, and the owner's and reviewer's reports. Sessions read and update the board with four tools (`KanbanList`, `KanbanGet`, `KanbanCreate`, `KanbanUpdate`): they split work into sub-tasks, record progress, block a task with a question, submit their work and review it. The board notifies the sessions involved when they are assigned, when work is submitted, blocked, sent back, reset or cancelled, and when you comment. `StartSession` can start a session as a task's owner or reviewer. The board page has a board view and a hierarchy view, opens a task in the side panel, and lists what waits on you under "Needs me": blocked tasks, deliveries to accept and tasks whose owner session is gone. You approve every time a session creates the board, starts a session on a task, cancels a task, changes acceptance criteria it did not set, or makes itself a reviewer; only a task's creator or you choose its reviewer (#242). - **Side chats.** Start a side chat from the side panel's new-tab page, or select text in the conversation and choose **Start a side chat** to quote it in a new one, to ask about something without interrupting the session: it continues from the session's latest message, in the same working folder, with the same tools, and opens as a tab in the session's side panel. It shows only its own messages; the model still has the whole conversation. A session can have several. Pages, files and browser tabs a side chat opens appear in the same panel. The tab is named `btw: ` plus your first message; right-click it to rename it, or to detach it into a regular forked session in the sidebar. Closing the tab deletes the side chat, and deleting a session deletes its side chats. Side chats stay out of the sidebar, search and board pickers; `ListSessions` shows a session its own side chats so it can message them. Cmd+. stops the conversation that has the focus. +- **Slides.** The agent can make a slide deck as an artifact with the new `/slides` skill, from scratch or from a bundled slide template; the Artifacts page has a Slides entry next to Design, with the slide templates, previews and the design system library. A deck opens in the side browser with controls to page through the slides, see them all in an overview and present full screen, where elements can appear step by step. It exports as a PDF with one page per slide, a PNG of the current slide, or one HTML file that pages and presents on its own. A comment on a slide tells the agent which slide it is about, and the tab stays on your slide while the agent changes the deck. ### Changed @@ -19,12 +20,19 @@ All notable changes to DreamCoder will be documented in this file. - The card with a turn's changed files in the conversation starts as one line with the number of files, the lines added and removed and the undo button. Click the line to list the files, now in compact rows with the folder in a lighter color; a file's diff no longer repeats the file name above it. - **Line comments are lighter.** A comment icon appears beside the line number under the pointer in code and diffs; clicking the number opens a small box with the line label, where Enter adds the comment, Shift+Enter starts a new line and Escape cancels. An empty box closes when you click elsewhere. - **Skill details have an Overview and a Contents tab.** Overview shows the description and the other frontmatter fields, with the source, plugin, slash command, version, size and location beside them; Contents shows the skill's files in a tree beside a preview, where Markdown opens rendered and can switch to its source, images show as images, and binary or oversized files say they cannot be previewed instead of showing their bytes as text. The page no longer repeats the same facts in stat cards and metadata cards. +- **Starting from the Design page waits for you.** Using a template, starting from scratch or cloning a website opens a new chat with your choice as a chip in the message box and a question to answer, instead of sending a message with a folder path at once. The artifact is created when you send; you can also send the chip alone, or remove it. The chat shows the chip and your words, and is titled from them. The Slides page starts the same way, and typing `/design` or `/slides` in the message box turns it into the same chip. - The "open project" button in the session header is a split button: the icon opens the project in the editor you used last, the arrow lists the other editors and file managers. - **A message you send while the agent is working waits for the next turn.** It used to be slipped into the running turn. Queued messages are listed above the message box, where you can withdraw one or send the queue now, which stops the current turn and starts the next one; Stop does the same while messages are queued. Queued messages survive a model or permission change that restarts the agent at the end of the turn (#239). ### Fixed +- The slash menu on the new task page lists the built-in commands such as `/design`; it used to list only skills on disk. - A deleted session no longer comes back as an empty session in the sidebar. It happened to sessions with a title you had set that were deleted while their agent was still running. +- Exporting an artifact as a PNG image shows the whole page. On a page taller than the side panel, everything below the visible part used to repeat the visible part. The image now shows the page as it loads, without what you clicked or typed in the tab. +- A canvas the agent opened in a tab follows the app theme, refreshes in place when its files change, and saves the boards you move. +- Exporting an artifact as standalone HTML includes the pages it embeds from its own folder. +- An artifact tab that has gone to another page is no longer reloaded when the artifact changes and no longer offers to export that page. +- The full-screen view of a canvas no longer offers export, like the canvas tab. Open a board in its own tab to export it. - Terminal text is no longer spaced out. The terminal measured its character width with a fallback font instead of the mono font it draws with. - A terminal tab starts one shell. When a terminal was started again before the first start finished, for example because its working folder arrived late or Restart was clicked twice, two terminals and two shells were created, the second showing as a dark strip under the first. - The reply-to-selection button appears when a text selection in a message ends outside the message. diff --git a/THIRD_PARTY_NOTICES.md b/THIRD_PARTY_NOTICES.md index e6613dbc..d1327c12 100644 --- a/THIRD_PARTY_NOTICES.md +++ b/THIRD_PARTY_NOTICES.md @@ -179,6 +179,17 @@ template contributors, bundled in its template folder as `LICENSE`: - `aster-atelier` +## beautiful-html-templates slide templates + +DreamCoder bundles 34 slide templates converted from https://github.com/zarazhangrui/beautiful-html-templates +(commit e5e204fb1f3b06290846e7dcd7aceddabeceec8c, folder `templates/`). The repository is MIT licensed, +Copyright (c) 2026 Zara Zhang; the full text is bundled as +`design-templates/LICENSE-beautiful-html-templates.txt`. Each template's example deck (`template.html`) +was split into one file per slide and a shared `deck.css`, sized for a 1920 by 1080 stage, with its +navigation script, slide counter and page-number text replaced by the DreamCoder deck stage. Its design +note (`design.md`) is bundled as `DESIGN.md` with a notice about the conversion added after its front +matter. + ## Open Design design systems DreamCoder bundles 151 design systems (`DESIGN.md` and `tokens.css` each, with the name, diff --git a/desktop/design-templates/8-bit-orbit/DESIGN.md b/desktop/design-templates/8-bit-orbit/DESIGN.md new file mode 100644 index 00000000..383f6a17 --- /dev/null +++ b/desktop/design-templates/8-bit-orbit/DESIGN.md @@ -0,0 +1,564 @@ +--- +version: alpha +name: 8-Bit Orbit +description: A retro-futuristic pixel-art presentation system that fuses 16-bit arcade nostalgia with editorial discipline. Display type runs in Tektur (a chunky geometric display face built on pixel-grid logic) paired with Chakra Petch for body and Space Mono for code-flavored labels and tabular data. The palette pivots on a deep cosmic navy (`#0F1B3D` / `#0A0E27`) lit by three saturated neons — cyan, hot pink, and a high-key yellow — with a soft lavender pastel for warm reprieves. Depth is built from stacked hard offset shadows in 4px increments (the pixel unit), CRT scanlines, atmospheric grain, vignettes, and animated starfields. The effect sits between an arcade cabinet and a Tron-era boardroom — unmistakably digital, intentionally lo-fi, and engineered to feel as if it just booted up. + +colors: + dark-void: "#0A0E27" + deep-navy: "#0F1B3D" + neon-cyan: "#5EDCF4" + neon-pink: "#F0A6CA" + neon-yellow: "#F4D03F" + soft-lavender: "#E2D5F2" + white: "#FFFFFF" + +shadows: + pixel-stack-cyan-yellow: "4px 0 0 0 {colors.deep-navy}, 0 4px 0 0 {colors.deep-navy}, 4px 4px 0 0 {colors.deep-navy}, 8px 4px 0 0 {colors.neon-yellow}, 4px 8px 0 0 {colors.neon-yellow}, 8px 8px 0 0 {colors.neon-yellow}" + pixel-stack-pink-cyan: "4px 0 0 0 {colors.deep-navy}, 0 4px 0 0 {colors.deep-navy}, 4px 4px 0 0 {colors.deep-navy}, 8px 4px 0 0 {colors.neon-cyan}, 4px 8px 0 0 {colors.neon-cyan}, 8px 8px 0 0 {colors.neon-cyan}" + pixel-l-shape: "4px 0 0 0 {colors.deep-navy}, 0 4px 0 0 {colors.deep-navy}, 4px 4px 0 0 {colors.deep-navy}" + pixel-text-shadow: "4px 4px 0 {colors.neon-yellow}, 8px 8px 0 {colors.deep-navy}" + pixel-text-shadow-small: "3px 3px 0 {colors.deep-navy}" + card-offset: "6px 6px 0 rgba(15, 27, 61, 0.15)" + card-featured: "8px 8px 0 {colors.neon-yellow}" + +typography: + pixel-hero: + fontFamily: "'Tektur', cursive" + fontSize: "clamp(48px, 10vw, 128px)" + fontWeight: 900 + lineHeight: 1.05 + letterSpacing: 0.04em + display: + fontFamily: "'Tektur', cursive" + fontSize: "clamp(32px, 5vw, 64px)" + fontWeight: 700 + lineHeight: 1.15 + headline: + fontFamily: "'Tektur', cursive" + fontSize: "clamp(24px, 3.5vw, 45px)" + fontWeight: 700 + lineHeight: 1.15 + subhead: + fontFamily: "'Tektur', cursive" + fontSize: "clamp(17.6px, 2vw, 24px)" + fontWeight: 700 + lineHeight: 1.15 + stat-number: + fontFamily: "'Tektur', cursive" + fontSize: "clamp(32px, 4vw, 56px)" + fontWeight: 900 + lineHeight: 1 + body: + fontFamily: "'Chakra Petch', sans-serif" + fontSize: "clamp(14.4px, 1.2vw, 18.4px)" + fontWeight: 400 + lineHeight: 1.7 + hero-tagline: + fontFamily: "'Chakra Petch', sans-serif" + fontSize: "clamp(14.4px, 1.5vw, 19.2px)" + fontWeight: 400 + lineHeight: 1.8 + quote-body: + fontFamily: "'Chakra Petch', sans-serif" + fontSize: "clamp(17.6px, 2.2vw, 25.6px)" + fontWeight: 500 + lineHeight: 1.8 + label-pill: + fontFamily: "'Space Mono', monospace" + fontSize: 12px + fontWeight: 700 + lineHeight: 1 + letterSpacing: 0.2em + textTransform: uppercase + label-eyebrow: + fontFamily: "'Space Mono', monospace" + fontSize: 13.6px + fontWeight: 400 + lineHeight: 1 + letterSpacing: 0.3em + textTransform: uppercase + badge: + fontFamily: "'Space Mono', monospace" + fontSize: 11.2px + fontWeight: 400 + lineHeight: 1 + letterSpacing: 0.1em + textTransform: uppercase + chart-value: + fontFamily: "'Space Mono', monospace" + fontSize: 12px + fontWeight: 700 + lineHeight: 1 + chart-label: + fontFamily: "'Space Mono', monospace" + fontSize: 11.2px + fontWeight: 400 + lineHeight: 1 + letterSpacing: 0.05em + date-chip: + fontFamily: "'Space Mono', monospace" + fontSize: 11.2px + fontWeight: 400 + lineHeight: 1 + counter: + fontFamily: "'Space Mono', monospace" + fontSize: 12.8px + fontWeight: 400 + lineHeight: 1 + letterSpacing: 0.15em + +spacing: + pixel-unit: 4px + pad-slide-y: "3vh" + pad-slide-x: "4vw" + pad-card-lg: "32px 40px" + pad-card-md: "28px" + pad-card-sm: "16px 20px" + gap-grid-lg: 32px + gap-grid-md: 24px + gap-grid-sm: 16px + content-max-width: 1200px + +canvas: + width: 100vw + height: 100vh + +components: + label-pill: + background: "{colors.deep-navy}" + color: "{colors.neon-yellow}" + padding: "6px 14px" + fontSize: 12px + fontWeight: 700 + letterSpacing: 0.2em + textTransform: uppercase + fontFamily: "'Space Mono', monospace" + description: "Universal section tag. Default fill is deep-navy with neon-yellow text. Variant fills swap text color so the pill stays legible (e.g., navy bg with cyan text, navy bg with pink text)." + pixel-button: + background: "{colors.neon-cyan}" + color: "{colors.deep-navy}" + padding: "16px 36px" + fontFamily: "'Tektur', cursive" + fontWeight: 700 + letterSpacing: 0.08em + textTransform: uppercase + boxShadow: "{shadows.pixel-stack-cyan-yellow}" + description: "The signature stacked-shadow CTA. The pink variant swaps cyan body for pink and yellow shadow halo for cyan halo." + pixel-corner-bracket: + width: 24px + height: 24px + borderWidth: 4px + description: "Two outward-facing L-shapes (top-left + bottom-right) bracketing a region. Default color is neon-cyan; yellow and pink variants exist. Sits 8px outside the bracketed element." + feature-card: + background: "rgba(255, 255, 255, 0.15)" + backdropFilter: "blur(8px)" + padding: "32px 24px" + border: "2px solid rgba(15, 27, 61, 0.2)" + description: "Frosted-glass card with inset navy L-brackets (top-left + bottom-right) replacing rounded corners. Used on light-surface slides." + stat-block: + background: "rgba(94, 220, 244, 0.08)" + border: "2px solid rgba(94, 220, 244, 0.2)" + padding: "32px 16px" + description: "Cyan-tinted glass stat tile with cyan L-bracket accents at opposite corners. Used on dark surfaces. Stat numeral uses the pixel-text-shadow-small treatment." + bar-track-light: + height: 32px + background: "rgba(15, 27, 61, 0.1)" + description: "Horizontal track for hbar charts on light surfaces. Fill is solid navy/cyan/pink with a yellow offset shadow." + bar-vertical: + background: "{colors.neon-cyan}" + boxShadow: "{shadows.pixel-l-shape}" + description: "Vertical chart bar with three-piece navy L-shadow. Color cycles cyan → pink → yellow." + timeline-node: + width: 24px + height: 24px + background: "{colors.neon-cyan}" + border: "4px solid {colors.deep-navy}" + description: "Square pixel node on timeline rails. Active state swaps fill to neon-yellow." + timeline-rail: + width: 4px + background: "repeating-linear-gradient(to bottom, {colors.deep-navy} 0px, {colors.deep-navy} 16px, transparent 16px, transparent 24px)" + description: "Dashed pixel rail running between timeline nodes." + date-chip: + background: "{colors.deep-navy}" + color: "{colors.neon-cyan}" + padding: "2px 10px" + fontFamily: "'Space Mono', monospace" + fontSize: 11.2px + description: "Small inline date marker on timeline events." + hero-badge: + border: "2px solid {colors.neon-yellow}" + color: "{colors.neon-yellow}" + padding: "8px 16px" + fontFamily: "'Space Mono', monospace" + fontSize: 11.2px + letterSpacing: 0.1em + textTransform: uppercase + description: "Outline-only chip used in clusters under hero headlines." + bg-grid: + backgroundColor: "{colors.dark-void}" + backgroundImage: "linear-gradient(rgba(94, 220, 244, 0.07) 1px, transparent 1px), linear-gradient(90deg, rgba(94, 220, 244, 0.07) 1px, transparent 1px)" + backgroundSize: "40px 40px" + description: "40px cyan-on-navy grid wallpaper for dark surfaces. Pink, cyan, and lavender variants invert the relationship (colored ground with low-opacity navy grid lines)." + scanlines: + background: "repeating-linear-gradient(0deg, transparent 0px, transparent 2px, rgba(10, 14, 39, 0.04) 2px, rgba(10, 14, 39, 0.04) 4px)" + mixBlendMode: multiply + description: "Horizontal CRT scanline overlay applied via ::after at z-index 50. Always present on every slide." + grain: + opacity: 0.035 + description: "SVG fractal-noise grain layer applied via ::before at z-index 49. Always present on every slide." + crt-glow: + background: "radial-gradient(ellipse at center, transparent 50%, rgba(10, 14, 39, 0.25) 100%)" + description: "Radial vignette that darkens the corners to mimic a CRT bulge. Applied to dark-surface slides via ::after at z-index 51." + starfield: + description: "Container of small 4-6px colored squares (cyan, yellow, pink) positioned absolutely with a 3s twinkle keyframe. Lives on dark surfaces only." + pixel-particles: + description: "Floating 8px colored squares with an 8s float keyframe. Decorative ambient layer on hero and CTA-type surfaces." + nav-dot: + width: 12px + height: 12px + border: "2px solid {colors.neon-cyan}" + background: transparent + description: "Hollow square pip with a 2px inset cyan fill on active state. Fixed vertical rail at right edge." + quote-line: + width: 60px + height: 4px + background: "{colors.neon-yellow}" + boxShadow: "4px 4px 0 {colors.deep-navy}" + description: "Short yellow rule with navy offset shadow, used as a separator under quote bodies." +--- + +> This design note comes from [beautiful-html-templates](https://github.com/zarazhangrui/beautiful-html-templates) (MIT, Copyright (c) 2026 Zara Zhang). The template in this folder was converted to the DreamCoder deck format: a fixed 1920 by 1080 stage, one file per slide under slides/, all styles in deck.css, no scripts in slides, and page numbers from the stage counters. Where this note talks about viewport units, navigation, slide counters, scripts or a single HTML file, the deck format wins; colors, type and decoration are as described here. + +## Overview + +8-Bit Orbit is a **retro-futuristic pixel-art presentation system**. Its foundational premise is the **4-pixel unit**: every shadow offset, every border, every corner bracket, every label height resolves to a multiple of 4px. Layouts feel as if they were rasterized on an old CRT and dragged into HTML — and atmospheric overlays (scanlines, grain, vignette glow, animated starfields) reinforce the illusion on every surface. + +The type stack is three faces working in concert. **Tektur** is the display face — a chunky, geometric, semi-pixelated grotesque that carries headlines, hero text, stat numerals, and any text that needs to feel like it was drawn on the pixel grid. **Chakra Petch** is the body face — a humanist sans with subtle geometric cuts that reads cleanly at small sizes and avoids fighting Tektur for attention. **Space Mono** is the system face — used exclusively for labels, captions, badges, chart values, dates, and counters. The mono treatment + wide tracking on these elements makes them feel like HUD readouts, not editorial captions. + +The palette is built around **deep navy as ground** (`{colors.dark-void}` and `{colors.deep-navy}`) lit by **three saturated neons** — cyan, hot pink, yellow — plus a soft lavender pastel. Surfaces alternate: a dark navy surface (cyan grid wallpaper, white text, neon accents glowing in front) followed by a colored surface (pink, cyan, or lavender ground with navy text and navy grid lines etched at low opacity). The neons never appear as body text — they are reserved for headlines, stat numerals, accent rules, and label fills. The result is high contrast without being harsh: the neons feel illuminated rather than printed. + +Depth is the system's signature trick: **stacked hard offset shadows in the pixel unit**. The flagship pattern is a six-piece shadow on buttons — three navy offsets stepping down-right at 4px, then three colored halo offsets stepping further at 8px. Hero text gets a two-layer text shadow (yellow at +4/+4, navy at +8/+8). Cards get either a 6px navy box shadow or an 8px yellow box shadow on the featured tier. Every shadow is hard-edged, zero blur, locked to the 4px grid. Atmospheric depth comes from the always-on **scanlines + grain + CRT glow** overlay trio that subtly modulates every surface. + +**Density philosophy: moderately dense, atmospherically loaded.** The system reads as broken when surfaces are clean and unaccompanied — without scanlines, grain, vignette, particles, or a colored grid behind, the type loses its arcade context and starts to look like generic web typography. Always layer the atmosphere. Within content regions, however, breathing room matters: cards are widely spaced (24-32px gaps), stat tiles get heavy internal padding, and hero text is allowed to dominate. A typical slide carries one display moment + a small constellation of supporting elements (badges, labels, a chart, or a small grid), all sitting on a fully decorated atmospheric background. + +**Key Characteristics:** +- Three-font stack: Tektur (display), Chakra Petch (body), Space Mono (HUD/labels) — never substitute, never mix outside their roles. +- Navy ground (`{colors.dark-void}` / `{colors.deep-navy}`) alternates with colored-grid surfaces (pink, cyan, lavender) — both carry the 40px etched grid. +- Three neons (cyan, pink, yellow) reserved for display, stats, rules, and label fills — never for body text. +- All measurements snap to the 4px pixel unit: borders 2-4px, shadow offsets 4px / 8px, corner brackets 24×24 with 4px stroke. +- Stacked hard offset shadows are the system's depth language — never blurred, never colored on text shadows except in the yellow→navy cascade. +- Every slide carries the persistent scanline + grain + CRT-vignette trio at z-index 49-51. +- L-shaped corner brackets (`{components.pixel-corner-bracket}`) replace rounded corners and frame regions, cards, and stat tiles. +- A monospace label pill (`{components.label-pill}`) sits as the universal eyebrow on every region — navy fill, neon text, 0.2em tracking, uppercase. +- Animated starfields and floating particle squares wallpaper dark surfaces — ambient, not decorative. + +## Colors + +### Palette + +- **Dark Void** (`{colors.dark-void}` — `#0A0E27`): The deepest ground, used on `` and as the base for dark-grid surfaces. Reads as black-with-blue-bias under the CRT vignette. +- **Deep Navy** (`{colors.deep-navy}` — `#0F1B3D`): The structural color — all shadow stacks, label fills, dark cards, button text on neon surfaces, and chart bar text. Slightly warmer than the void; the two read as ground and figure when stacked. +- **Neon Cyan** (`{colors.neon-cyan}` — `#5EDCF4`): The system's primary glow. Used for headlines on dark surfaces, primary button fill, stat numerals, primary chart bars, timeline nodes, navigation dots, corner brackets, and grid lines on dark surfaces (at 7% opacity). +- **Neon Pink** (`{colors.neon-pink}` — `#F0A6CA`): The warm accent. Used as a colored surface ground (40px navy-on-pink grid), secondary button fill, secondary chart bars, mouth detail in pixel avatars, and tertiary corner brackets. +- **Neon Yellow** (`{colors.neon-yellow}` — `#F4D03F`): The high-key alert color. Used in shadow halos behind buttons and on featured tier cards, as the active timeline-node fill, on hero badges, in label-pill text variants, in the quote-line, and as Tektur text-shadow layer 1. +- **Soft Lavender** (`{colors.soft-lavender}` — `#E2D5F2`): The calm pastel surface — used as ground for slides that need a softer reprieve from the neon-on-navy intensity. Carries the same etched-navy grid wallpaper as the other colored surfaces. +- **White** (`{colors.white}` — `#FFFFFF`): Text color on dark/neon surfaces only. Never used as a slide background. + +### Defaults + +- **Default surface background**: `{colors.dark-void}` with the 40px cyan grid (`{components.bg-grid}`). Always apply scanlines + grain + crt-glow on top. +- **Default headline color on dark surfaces**: `{colors.neon-cyan}`, with the `{shadows.pixel-text-shadow-small}` or `{shadows.pixel-text-shadow}` treatment for hero-scale text. +- **Default headline color on colored grids (pink/cyan/lavender)**: `{colors.deep-navy}` — neon text becomes illegible on neon grounds. +- **Default body text color on dark surfaces**: `rgba(255, 255, 255, 0.7)` — softened white, not pure white. +- **Default body text color on colored grids**: `rgba(15, 27, 61, 0.75)` — softened navy. +- **Default label-pill fill**: `{colors.deep-navy}` with `{colors.neon-yellow}` text. On colored grids the text can swap to cyan or pink as long as contrast against navy holds. +- **Default accent color for callouts and stat numerals**: `{colors.neon-cyan}`. +- **Default chart palette order**: cyan → pink → yellow (in that order across series). +- **Default corner bracket color**: `{colors.neon-cyan}`. Yellow and pink variants exist for thematic accents. + +When a slide needs to feel softer or warmer, switch the colored grid from cyan-on-navy (default) to navy-on-pink, navy-on-cyan, or navy-on-lavender — the structural relationship inverts (grid lines become navy at low opacity) but the typographic rules stay the same. + +## Typography + +### Font Family +The system runs three faces, each locked to its role. + +**Tektur** is the display face — a wide-bodied, semi-geometric grotesque with subtle pixel-grid cuts. Used for every hero title, headline, stat numeral, quote mark, and large numeral. Tektur's chunky personality is what makes the system feel arcade-native; replacing it with Inter or Space Grotesk breaks the entire aesthetic. + +**Chakra Petch** is the body face — a humanist sans with mild geometric/squared character that reads cleanly at 14-22px and has enough personality to sit next to Tektur without disappearing. Used for paragraphs, hero taglines, quote bodies, and any longer-form prose. + +**Space Mono** is the HUD face — a monospace used exclusively for labels, badges, chart values/axes, page counters, date chips, and any element that should feel like a system readout. The mono + wide-tracked uppercase combination is the system's "interface" voice. + +Never use Tektur for body, never use Chakra Petch for chrome/HUD, never use Space Mono for headlines. The three-role separation is the typographic structure. + +### Typography Scale + +| Token | Size (clamp) | Family | Weight | Use | +|---|---|---|---|---| +| `{typography.pixel-hero}` | 48–128px | Tektur | 900 | Hero or cover display title — always carries the two-layer text shadow | +| `{typography.display}` | 32–64px | Tektur | 700 | Large section opener | +| `{typography.headline}` | 24–45px | Tektur | 700 | Primary section headline | +| `{typography.subhead}` | 17.6–24px | Tektur | 700 | Region-level subheading or card title | +| `{typography.stat-number}` | 32–56px | Tektur | 900 | Stat tile numeral — pairs with the small text shadow | +| `{typography.body}` | 14.4–18.4px | Chakra Petch | 400 | Paragraph body | +| `{typography.hero-tagline}` | 14.4–19.2px | Chakra Petch | 400 | Hero subtitle / lede paragraph below a pixel-hero | +| `{typography.quote-body}` | 17.6–25.6px | Chakra Petch | 500 | Quote text | +| `{typography.label-pill}` | 12px | Space Mono | 700 | Text inside the navy label pill | +| `{typography.label-eyebrow}` | 13.6px | Space Mono | 400 | Standalone uppercase eyebrow above a headline (heavier tracking than the pill) | +| `{typography.badge}` | 11.2px | Space Mono | 400 | Outline-only hero badge text | +| `{typography.chart-value}` | 12px | Space Mono | 700 | Chart bar value numerals | +| `{typography.chart-label}` | 11.2px | Space Mono | 400 | Chart axis or category labels | +| `{typography.date-chip}` | 11.2px | Space Mono | 400 | Date marker on timeline events | +| `{typography.counter}` | 12.8px | Space Mono | 400 | Persistent slide counter (NN / NN) | + +### Defaults + +- **Default size for a hero or cover title**: `{typography.pixel-hero}` (48–128px clamp) — always Tektur weight 900 with the two-layer text shadow. +- **Default size for a primary section headline**: `{typography.headline}` (24–45px clamp) — Tektur weight 700. +- **Default size for paragraph body**: `{typography.body}` (14.4–18.4px clamp) — Chakra Petch weight 400. +- **Default size for a stat numeral**: `{typography.stat-number}` (32–56px clamp) — Tektur weight 900, always carries the 3px navy text shadow. +- **Default size for an eyebrow label**: `{typography.label-pill}` (12px) housed in the navy pill — or `{typography.label-eyebrow}` (13.6px) if the eyebrow sits standalone. +- **Default tracking for any Space Mono label**: 0.1em (badges) to 0.3em (eyebrow labels). Mono without wide tracking reads as code, not HUD. +- **Default body weight**: 400 for Chakra Petch, 500 for quote bodies. +- **Default display weight**: 700 for headlines, 900 for hero scale and stat numerals. + +When unsure which display token to reach for, default to `{typography.headline}` — it's the section-level workhorse. Reserve `{typography.pixel-hero}` for cover and CTA moments only. + +### Signature Treatments + +These treatments are **non-optional whenever the corresponding element type is used**: + +- **Every pixel-hero element carries the stacked text-shadow.** The pattern is `4px 4px 0 {colors.neon-yellow}, 8px 8px 0 {colors.deep-navy}` on cyan text. A pixel-hero element without this two-layer cascade reads as untreated display type and breaks the arcade voice. +- **Every stat numeral carries the small text-shadow.** The pattern is `3px 3px 0 {colors.deep-navy}` on cyan text. Stat numerals on dark surfaces need this shadow to feel illuminated; without it they read flat. +- **Every Space Mono element is uppercase with wide tracking** — minimum 0.05em for chart labels, 0.08–0.2em for pills and badges, 0.3em for standalone eyebrow labels. Sentence-case mono does not exist in this system. +- **Every Tektur display element keeps its native letter-spacing or slight positive (+0.04em on hero scale).** Tektur is wide-bodied by design — adding negative tracking compresses it into something that no longer reads as the same face. +- **Every Chakra Petch body block uses line-height ≥ 1.6.** The face is dense; tighter line-height on body bleeds into unreadable. +- **Every label pill uses Space Mono at 12px with 0.2em letter-spacing.** No exceptions — the pill is the system's most recognizable small chrome and any deviation in size or tracking breaks it. +- **Every chart bar value / axis label uses Space Mono.** Numerical chrome is mono, never Tektur or Chakra Petch. + +### Typography Principles + +The voice contrast is **chunky display ↔ humanist body ↔ wide-tracked mono chrome**. Switching any of the three roles to a different face flattens the system into a generic dark-mode aesthetic. Italic is never used in display or body — the only italic that appears anywhere is implicit in the slight tilt on pixel-art decorative elements. + +Tektur should always feel **planted** — left-aligned, generous line-height, never centered for body-length runs (centering is permitted on hero and CTA titles only). Chakra Petch should always feel **calm** — left-aligned by default, no all-caps treatment, no letter-spacing. + +## Layout + +### Canvas System +The system targets `100vw × 100vh` per slide. Slides are stacked vertically inside a `slides-container` and translated via `transform: translateY(...)` for navigation. Only one slide occupies the viewport at a time, with cubic-bezier `(0.22, 1, 0.36, 1)` easing on an 800ms transition. + +Default slide padding is `3vh 4vw`. The inner `slide-content` caps at `max-width: 1200px` and centers, so on wide displays content keeps editorial column width while the colored background fills the viewport. + +### Pixel Unit +Every measurement in the system snaps to a **4px grid**. Border widths are 2px or 4px. Shadow offsets are 4px or 8px. Corner brackets are 24×24 with 4px stroke. The background grid is 40px (10 × pixel-unit). Card padding usually resolves to multiples of 8 (16, 24, 32, 48). This discipline is what makes the system feel rasterized rather than vector. + +### Persistent Chrome +Three elements appear on every slide: +- **Navigation dot rail** — vertical stack of 12×12 cyan-bordered squares, fixed at `right: 24px`, vertically centered. Active state fills the inner 8×8 with cyan. +- **Slide counter** — Space Mono `01 / 10` format, fixed at `bottom: 24px`, horizontally centered, dark-navy semi-transparent pill background. +- **Nav hint** — `USE KEYS ↑ ↓`, Space Mono 11px at 50% opacity, fixed at `bottom: 24px right: 24px`. + +The cursor across the entire deck is `crosshair` — an additional arcade signal. + +### Atmospheric Overlay Stack +Every slide carries (in z-order): +1. Surface background — either `{components.bg-grid}` (cyan-on-navy) or one of the colored grid variants. +2. Grain layer at z-index 49, opacity 0.035. +3. Scanlines at z-index 50, multiply blend mode. +4. CRT vignette glow at z-index 51 (dark surfaces only). +5. Optional starfield / pixel particles at z-index 1 inside the surface. +6. `.slide-content` at z-index 10 above the atmospheric layers. + +This overlay stack is the system's identity. A slide rendered without it looks like a wireframe. + +## Depth and Elevation + +### Stacked Hard Offset Shadow (Signature) +The system uses **stacked, multi-step hard offset shadows** in the 4px pixel unit. Every shadow value is composed in one of three patterns: + +- **Three-step navy L-shape** (`{shadows.pixel-l-shape}`) — three offsets at `4px 0`, `0 4px`, `4px 4px` in deep-navy, zero blur. Used on chart bars and small elevated chrome to suggest a single-layer drop. +- **Six-step button cascade** (`{shadows.pixel-stack-cyan-yellow}` / `{shadows.pixel-stack-pink-cyan}`) — three navy offsets at 4px stepping then three colored halo offsets at 8px stepping behind. Creates a two-layer pixel-bevel effect. Used exclusively on `{components.pixel-button}`. +- **Two-layer text-shadow** (`{shadows.pixel-text-shadow}` / `{shadows.pixel-text-shadow-small}`) — yellow layer at +4/+4 then navy layer at +8/+8 (or just navy at +3/+3 for stat-scale numerals). Used on every Tektur display element. + +All shadows are zero-blur, hard-edged, locked to the pixel unit. A blurred drop shadow does not exist anywhere in the system. + +### Card Shadows +Two simpler patterns serve cards: +- `{shadows.card-offset}` = `6px 6px 0 rgba(15, 27, 61, 0.15)` — soft navy offset for non-featured tier cards on light surfaces. +- `{shadows.card-featured}` = `8px 8px 0 {colors.neon-yellow}` — neon-yellow offset for featured tier cards, paired with a `-12px` translateY lift. + +### Corner Brackets as Depth +The L-shaped corner brackets (`{components.pixel-corner-bracket}`) replace traditional border treatments on regions and cards. Two brackets at opposite corners imply a frame without enclosing it — the eye fills in the missing edges. On stat blocks and feature cards, brackets sit inset at `top: -2px / left: -2px` and `bottom: -2px / right: -2px` so they break the cell edge slightly, reinforcing the pixel-bevel feel. + +### Atmospheric Depth +The scanline + grain + CRT-vignette stack provides ambient depth on every surface without requiring shadow on individual elements. Animated starfields and floating particles layer additional spatial cues behind content. None of these are decorative add-ons — they are core to the depth perception of the system. + +## Shapes and Treatment + +### Border Radius +Effectively zero. The only round shape that appears anywhere is the donut-style nav dot inner-fill (which is still a square in this system — the nav dots are square pips, not circles). Rounded buttons, rounded cards, or rounded pill chips break the pixel-art aesthetic immediately. + +The pixel-face avatar zone uses square eyes and a rectangular mouth — anatomy rendered in pixels, not curves. + +### Border Weights +- **2px solid** — used on feature-card outlines, hero badges, nav dots, stat-block frames, chart bars (inline edges). +- **3px stroke** — used for chart axes inside SVG charts (deep-navy). +- **4px solid** — used on corner brackets, timeline node borders, the quote-line, and the inner pixel-bevel of buttons. + +Borders are always solid, always navy or neon, never dashed except for the timeline rail (`{components.timeline-rail}`) which is intentionally rendered as a 16px-on, 8px-off repeating linear gradient to mimic a pixel-dashed line. + +### Decorative Element Types + +**Pixel corner bracket** — Two outward L-shapes (top-left + bottom-right) bracketing a region. 24×24 with 4px stroke. Default color is cyan; yellow and pink variants exist. The bracket pattern is the system's most distinctive non-typographic mark. + +**Label pill** — Navy rectangle with neon-yellow Space Mono text at 12px / 0.2em. The universal section eyebrow. Variants flip the text color to cyan or pink while keeping the navy fill. + +**Hero badge** — Outline-only 2px yellow border with yellow Space Mono text. Appears in clusters under hero titles as feature tags. + +**Stat block** — Cyan-tinted glass tile (8% cyan fill, 20% cyan border) with cyan corner brackets at top-left and bottom-right. Holds a large stat numeral over a Space Mono pink label. + +**Feature card** — Frosted-glass white card (15% white fill, blur) with navy corner brackets at opposite corners. Used on colored-grid surfaces. + +**Pixel button** — Cyan rectangle with the six-step stacked shadow cascade. On hover, the button translates +2/+2 and the shadow collapses to a 4-step cascade — simulating a key-press in pixel art. + +**Quote-line** — A 60×4 yellow rectangle with a 4×4 navy offset shadow. Used as a separator beneath quote bodies. + +**Timeline node** — 24×24 cyan square with a 4px navy border, positioned on a dashed navy rail. Active state swaps fill to yellow. + +**Date chip** — Inline 2px-padded navy pill with cyan Space Mono text, used to mark timeline events. + +**Pixel face** — A 120×120 grouping of square "facial features" (cyan eyes, pink mouth) rendered as absolutely positioned divs inside a navy avatar zone. Functions as both a friendly mascot and a system-signature decorative module. + +**Tier card** — White rectangle, 6px navy offset shadow. Featured tier swaps fill to deep-navy and shadow to 8px yellow, with a `-12px` translateY lift. Tier features use a `+` ::before glyph in cyan instead of standard bullets. + +**Pixel landscape** — A row of variable-height navy mountains at the bottom of CTA-class surfaces, opacity 0.3. Pure decoration suggesting an arcade horizon. + +## Do's and Don'ts + +### Do + +- Apply the scanlines + grain + CRT-vignette overlay stack to every slide. The atmosphere is the design system; surfaces without it look like wireframes. +- Use `{colors.neon-cyan}` as the default headline color on dark surfaces and `{colors.deep-navy}` as the default headline color on colored grids (pink/cyan/lavender). +- Apply `{shadows.pixel-text-shadow}` to every pixel-hero element and `{shadows.pixel-text-shadow-small}` to every stat numeral. Tektur display type without its text-shadow reads flat. +- Snap every measurement to the 4px pixel unit — border widths, shadow offsets, padding, corner-bracket dimensions. Off-grid values break the rasterized feel. +- Use Tektur for display, Chakra Petch for body, Space Mono for chrome — exclusively. Cross-mixing the three voices flattens the system. +- Wrap eyebrows in the `{components.label-pill}` (navy bg, yellow Space Mono text, 0.2em tracking, uppercase) as the universal section tag. +- Pair the navy ground with at least one neon glow per region — text, chart bar, corner bracket, or button shadow halo. Pure navy without a neon accent reads as dead screen. +- Layer animated starfields and pixel-particle floaters on dark hero and CTA surfaces. The motion is part of the atmosphere. +- Render charts with cyan → pink → yellow series order and Space Mono numerals/labels. The neon trio is the chart palette. +- Bracket cards and stat tiles with the L-shaped corner brackets at opposite corners instead of fully outlining them. The implied frame is the system's signature card treatment. + +### Don't + +- Don't substitute fonts. Tektur, Chakra Petch, and Space Mono are the three voices — replacing any of them with Inter, Roboto, or Space Grotesk collapses the system. +- Don't round any corner. The pixel aesthetic depends on square edges. Border-radius is reserved for SVG donut chart geometry only. +- Don't blur any shadow. Every shadow is hard-edged at zero blur. `0 4px 12px rgba(0,0,0,0.1)` does not exist here. +- Don't place neon text on neon surfaces. Cyan headlines on the pink grid become illegible — switch to deep-navy on colored grounds. +- Don't use Tektur in sentence-case body runs or Chakra Petch in chrome/labels. Each face has a single role. +- Don't introduce a fourth neon. The palette is cyan + pink + yellow + lavender pastel. Adding green or orange breaks the curated neon trio. +- Don't omit the atmospheric overlay stack on any slide, even chart-heavy or table-heavy slides. The overlays are non-negotiable. +- Don't use uppercase Chakra Petch body text. Body always sentence-case; uppercase is reserved for Space Mono and Tektur display. +- Don't drop the navy label pill in favor of a plain text eyebrow. The pill is the most recognizable small chrome in the system. +- Don't shadow text or chrome with off-axis offsets. Every shadow steps down-right in 4px increments — left or upward offsets do not exist. + +## Responsive Behavior + +8-Bit Orbit is a **viewport-fluid system** built around `vw/vh`-based sizing and CSS `clamp()` ranges. There are no hard breakpoints for the deck itself — every font size, padding value, and gap interpolates between a minimum and maximum based on viewport width. + +### Scaling Behavior +- Hero text scales 48px → 128px on viewport width. +- Stat numerals scale 32px → 56px. +- Body scales 14.4px → 18.4px. +- The 4px pixel unit, 40px grid size, scanline 4px stripe, and corner-bracket dimensions are fixed — they do not scale, which means at larger viewports the pixel chrome appears proportionally finer (intentionally — the larger the canvas, the smaller and more refined the pixels read). + +### Component Breakpoints +Three component-level breakpoints exist: +- `max-width: 1024px` — feature grid collapses 4→2 columns, two-column split layouts stack. +- `max-width: 900px` — feature grid further collapses, hbar chart label column shrinks. +- `max-width: 500px` — feature grid becomes single column, stats grid stacks. + +### Presenter Behavior +- Slides advance via `ArrowDown`, `ArrowRight`, or `Space`. +- Slides reverse via `ArrowUp` or `ArrowLeft`. +- `Home` jumps to first, `End` to last. +- Vertical swipe on touch devices advances/reverses with a 50px threshold. +- Mouse wheel scroll advances/reverses with an 800ms debounce lock. +- Slide transitions use 800ms cubic-bezier `(0.22, 1, 0.36, 1)` on a translateY transform. + +### Animation Triggers +Chart bars and stat counters animate in on slide entry with `setTimeout` staggers (100-150ms between items). When a slide is exited, its bars/counters reset to 0 so re-entry replays the animation. The `prefers-reduced-motion` media query disables transitions and the starfield/particle twinkle keyframes. + +### Print Behavior +The system has no `@media print` rule. The deck is screen-first; printing produces only the active slide. For static export, screenshots of each slide preserve all atmospheric overlays (scanlines and grain are CSS-rendered, not assets). + +## CJK & International Content + +When using this template for Chinese (or other CJK) content, swap the Latin typeface stack for an equivalent Chinese pairing and apply universal CJK adjustments. All recommended Chinese fonts load via CDN — no install required. + +### Recommended Chinese Pairing + +| Role | Latin (default) | Chinese counterpart | +|---|---|---| +| Display / hero / stat numerals | Tektur 700–900 | 思源黑体 Noto Sans SC 900 | +| Body / hero tagline / quote body | Chakra Petch 400–500 | 思源黑体 Noto Sans SC 400 | +| HUD labels / badges / chart values / counter | Space Mono 400–700 (uppercase + wide tracking) | 思源黑体 Noto Sans SC 500 (no transform, no tracking) — see Known CJK Gap below | + +### Mixed-Content Strategy + +**Strategy A** — single CJK family with built-in Latin glyph coverage. Set every text element to `font-family: 'Noto Sans SC', sans-serif`. 思源黑体 ships Latin glyphs that read cleanly alongside Chinese characters, so a sentence like `使用 Tektur 字体` renders in one consistent face rather than font-switching mid-word. This system normally runs three faces (display / body / HUD); collapsing to one CJK face is the right tradeoff because none of the three Latin faces have credible Chinese counterparts, and visual hierarchy still works through weight (900 / 700 / 500 / 400) plus the system's signature shadow stacks. + +### Loading + +Add to the template's ``: + +```html + + + +``` + +### Universal CJK Adjustments + +- **Line-height**: increase by ~15–25% from the Latin spec. Body 1.75–1.85 (up from 1.7–1.8), display 1.15–1.25 (up from 1.05–1.15). CJK characters are square and visually full — they crowd vertically more than Latin. +- **Letter-spacing**: set to 0 on every CJK run. The template's positive tracking on Tektur display (+0.04em) and 0.1–0.3em mono tracking on Space Mono labels looks broken on square CJK glyphs — they're already evenly spaced by design. +- **Text transform**: don't apply `uppercase` to Chinese text — CJK has no case. Every Space Mono label in this system uses `text-transform: uppercase`; remove it for CJK runs. +- **Punctuation**: use full-width Chinese punctuation (,。:;!?「」()). +- **No period on display headlines**: Chinese typography convention omits trailing 。 on display-scale headlines. +- **Space between CJK and Latin (盘古之白)**: insert an ASCII space between every Chinese character and adjacent Latin character or digit. Write `8 位赛博 / 1989 模式` not `8位赛博/1989模式`. +- **One font per sentence**: 思源黑体 covers both CJK and Latin glyphs in a unified style — let it handle mixed sentences. Don't let the browser fall back to Tektur or Space Mono mid-sentence for ASCII characters. + +### Aesthetic Notes for This System + +The system's identity rests on three voices — Tektur (chunky arcade display), Chakra Petch (humanist body), Space Mono (HUD readouts) — and a CJK build cannot preserve that three-face contrast. Compensate by leaning harder on the **non-typographic** signature elements: the stacked text-shadow (yellow at +4/+4, navy at +8/+8) still works on 思源黑体 900 headlines and is what carries the arcade voice when the face itself is generic. Keep all atmospheric overlays (scanlines, grain, CRT vignette, starfields, grid wallpaper) — they do more identity work in a CJK build than in the Latin original. + +The system's Space Mono label-pill (navy fill, neon-yellow text, 0.2em tracking, uppercase) is the most recognizable small chrome and translates poorly: CJK characters won't accept the wide tracking or uppercase transform. Render Chinese label-pills with 思源黑体 weight 500 at 0 tracking, no transform, and a slightly tighter fontSize (10–11px instead of 12px) to preserve the chip's compact silhouette. The colored pill background and corner-bracket framing carry the recognition load. + +### Known CJK Gap + +- **No CDN-loadable Chinese pixel font.** The system's arcade aesthetic depends on Tektur's semi-pixel grotesque character — there is no equivalent Chinese face on Google Fonts or major CDNs that reads as "pixel-art" while remaining legible. 思源黑体 at weight 900 gives heft but loses the pixel-grid signal entirely. The atmospheric overlays (scanlines, grain, vignette, starfields) and pixel-bevel shadow stacks must carry the arcade voice on their own. +- **No CDN Chinese monospace face for HUD labels.** Space Mono's "system readout" voice depends on monospaced rhythm + uppercase + 0.1–0.3em tracking — none of which transfer to CJK. The label-pill loses its mono character; lean on the navy fill + neon text + corner-bracket framing to keep chrome recognizable. + +## Iteration Guide + +1. Any new slide gets the full atmospheric overlay trio (scanlines + grain + crt-glow on dark surfaces, scanlines + grain on colored surfaces) and a 40px etched grid surface. Don't skip the overlays. +2. Any new display element uses Tektur. Any new body element uses Chakra Petch. Any new label, badge, counter, or chart value uses Space Mono. Never cross the role boundaries. +3. Any new headline gets `{colors.neon-cyan}` on dark surfaces or `{colors.deep-navy}` on colored grids — both with the appropriate Tektur weight and (for hero scale) the stacked text-shadow. +4. Any new eyebrow uses the `{components.label-pill}` — navy fill, neon-yellow Space Mono text at 12px / 0.2em / uppercase. Don't substitute a plain h-tag. +5. Any new card or region gets the L-shaped corner brackets at opposite corners (top-left + bottom-right) instead of a full outline. The implied frame is the system's signature. +6. Any new measurement snaps to the 4px pixel unit. Borders 2-4px, shadow offsets 4px / 8px, corner brackets 24px, grid 40px. Off-grid values feel wrong. +7. Any new shadow is hard-edged at zero blur. For buttons use the six-step cascade; for cards use 6px navy or 8px yellow; for text use the two-layer cascade. +8. Any new chart cycles cyan → pink → yellow in series order. Numerical labels and axis labels are always Space Mono. +9. If a surface needs to feel warmer or softer, switch to the pink, cyan, or lavender etched grid variant — but keep all typographic rules intact (navy headlines, softened-navy body). +10. Animated elements (starfield, particles, chart bar grow, counter rollup) should respect `prefers-reduced-motion`. Atmospheric overlays (scanlines, grain, vignette) are not animated and stay on always. + +## Known Gaps + +- **Tektur, Chakra Petch, and Space Mono are Google Fonts** loaded via a preconnect + ``. The system has no fallback strategy beyond `cursive` / `sans-serif` / `monospace` — in environments where Google Fonts fail (offline, restricted networks), the aesthetic collapses to system defaults and loses its character. +- **Starfield and pixel-particle elements are generated by inline JS** that creates a fixed count of absolutely-positioned divs with random positions and animation delays. The animation keyframes are present in CSS, but the elements are only created if the JS runs successfully. +- **The chart system is hardcoded**: bar heights, hbar widths, and stat counter targets are stored in `data-*` attributes and animated via `setTimeout` staggers triggered by slide-index matching. There is no data-binding layer — adding a new chart requires copying the HTML pattern and updating the JS slide-index matcher. +- **The pixel-landscape on CTA surfaces is JS-generated** from a hardcoded heights array `[30, 50, 70, ...]`. Width varies per mountain (60 + (i % 3) * 20px). Replacing the landscape requires editing the JS heights array. +- **The CRT vignette glow uses a fixed dark-navy radial gradient.** Adjusting it requires editing the CSS gradient stops; there is no tokenized vignette intensity. +- **The cursor is set to `crosshair` deck-wide** for atmospheric reasons. This may conflict with text-selection expectations in contexts where the deck is embedded. +- **No keyboard navigation hint exists for the wheel/touch fallback.** The nav-hint reads `USE KEYS ↑ ↓` even though wheel and touch are also wired up. +- **The slide counter format is fixed at `NN / NN` zero-padded.** Decks with more than 99 slides would render with a layout-shifting counter. +- **The pixel-corner-bracket sizing is fixed at 24×24 with 4px stroke** and does not scale with viewport. On very large or very small viewports the brackets may feel proportionally off. diff --git a/desktop/design-templates/8-bit-orbit/artifact.json b/desktop/design-templates/8-bit-orbit/artifact.json new file mode 100644 index 00000000..34f388b9 --- /dev/null +++ b/desktop/design-templates/8-bit-orbit/artifact.json @@ -0,0 +1,19 @@ +{ + "version": 1, + "id": "2a912a09-0c38-4381-8e68-1bee3cd27b00", + "kind": "deck", + "title": "8-Bit Orbit", + "entry": "index.html", + "slides": [ + "cover", + "intro", + "engines", + "growth", + "allocation", + "roadmap", + "vitals", + "quote", + "pricing", + "closing" + ] +} diff --git a/desktop/design-templates/8-bit-orbit/deck.css b/desktop/design-templates/8-bit-orbit/deck.css new file mode 100644 index 00000000..2d7fd1fc --- /dev/null +++ b/desktop/design-templates/8-bit-orbit/deck.css @@ -0,0 +1,901 @@ +@import url("https://fonts.googleapis.com/css2?family=Chakra+Petch:ital,wght@0,300;0,400;0,500;0,600;0,700;1,400&family=Space+Mono:wght@400;700&family=Tektur:wght@400;500;600;700;800;900&display=swap"); + +:root { + --neon-pink: #F0A6CA; + --neon-cyan: #5EDCF4; + --neon-yellow: #F4D03F; + --deep-navy: #0F1B3D; + --dark-void: #0A0E27; + --soft-lavender: #E2D5F2; + --pixel-size: 8px; + --font-display: 'Tektur', 'Arial Black', sans-serif; + --font-body: 'Chakra Petch', 'Segoe UI', sans-serif; + --font-mono: 'Space Mono', 'Courier New', monospace; +} + +.slide, .slide *, .slide *::before, .slide *::after { margin: 0; padding: 0; box-sizing: border-box; } + +.slide { + overflow: hidden; + display: flex; + flex-direction: column; + justify-content: center; + align-items: center; + padding: 32px 77px 72px; + font-family: var(--font-body); + color: var(--dark-void); + background: var(--dark-void); +} + +.scanlines::after { + content: ""; + position: absolute; + inset: 0; + background: repeating-linear-gradient( + 0deg, + transparent 0px, + transparent 4px, + rgba(10, 14, 39, 0.04) 4px, + rgba(10, 14, 39, 0.04) 8px + ); + pointer-events: none; + z-index: 50; + mix-blend-mode: multiply; +} + +.grain::before { + content: ""; + position: absolute; + inset: 0; + background-image: url("data:image/svg+xml,%3Csvg viewBox='0 0 256 256' xmlns='http://www.w3.org/2000/svg'%3E%3Cfilter id='n'%3E%3CfeTurbulence type='fractalNoise' baseFrequency='0.9' numOctaves='4' stitchTiles='stitch'/%3E%3C/filter%3E%3Crect width='100%25' height='100%25' filter='url(%23n)'/%3E%3C/svg%3E"); + opacity: 0.035; + pointer-events: none; + z-index: 49; +} + +.crt-glow::after { + content: ""; + position: absolute; + inset: 0; + background: radial-gradient(ellipse at center, transparent 50%, rgba(10, 14, 39, 0.25) 100%); + pointer-events: none; + z-index: 51; +} + +.bg-grid { + background-color: var(--dark-void); + background-image: + linear-gradient(rgba(94, 220, 244, 0.07) 1px, transparent 1px), + linear-gradient(90deg, rgba(94, 220, 244, 0.07) 1px, transparent 1px); + background-size: 40px 40px; +} + +.bg-grid-pink { + background-color: var(--neon-pink); + background-image: + linear-gradient(rgba(15, 27, 61, 0.06) 1px, transparent 1px), + linear-gradient(90deg, rgba(15, 27, 61, 0.06) 1px, transparent 1px); + background-size: 40px 40px; +} + +.bg-grid-cyan { + background-color: var(--neon-cyan); + background-image: + linear-gradient(rgba(15, 27, 61, 0.08) 1px, transparent 1px), + linear-gradient(90deg, rgba(15, 27, 61, 0.08) 1px, transparent 1px); + background-size: 40px 40px; +} + +.bg-grid-lavender { + background-color: var(--soft-lavender); + background-image: + linear-gradient(rgba(15, 27, 61, 0.05) 1px, transparent 1px), + linear-gradient(90deg, rgba(15, 27, 61, 0.05) 1px, transparent 1px); + background-size: 40px 40px; +} + +.starfield { + position: absolute; + inset: 0; + overflow: hidden; + z-index: 1; +} + +.starfield .star { + position: absolute; + width: 6px; + height: 6px; + background: var(--neon-cyan); + opacity: 0.6; +} + +.starfield .star:nth-child(2n) { background: var(--neon-yellow); } +.starfield .star:nth-child(3n) { background: var(--neon-pink); } +.starfield .star:nth-child(4n) { width: 9px; height: 9px; } + +.pixel-particles { + position: absolute; + inset: 0; + overflow: hidden; + z-index: 1; + pointer-events: none; +} + +.pixel-particles .p { + position: absolute; + width: 12px; + height: 12px; + opacity: 0.4; +} + +.pixel-btn { + display: inline-block; + font-family: var(--font-display); + font-weight: 700; + font-size: 26px; + letter-spacing: 0.08em; + text-transform: uppercase; + padding: 24px 48px; + background: var(--neon-cyan); + color: var(--deep-navy); + border: none; + position: relative; + box-shadow: + 4px 0 0 0 var(--deep-navy), + 0 4px 0 0 var(--deep-navy), + 4px 4px 0 0 var(--deep-navy), + 8px 4px 0 0 var(--neon-yellow), + 4px 8px 0 0 var(--neon-yellow), + 8px 8px 0 0 var(--neon-yellow); +} + +.pixel-btn.pink-btn { + background: var(--neon-pink); + box-shadow: + 4px 0 0 0 var(--deep-navy), + 0 4px 0 0 var(--deep-navy), + 4px 4px 0 0 var(--deep-navy), + 8px 4px 0 0 var(--neon-cyan), + 4px 8px 0 0 var(--neon-cyan), + 8px 8px 0 0 var(--neon-cyan); +} + +.pixel-hero-text { + font-family: var(--font-display); + font-weight: 900; + font-size: 150px; + line-height: 1.05; + color: var(--neon-cyan); + text-shadow: + 4px 4px 0 var(--neon-yellow), + 8px 8px 0 var(--deep-navy); + letter-spacing: 0.04em; +} + +.pixel-corners { + position: relative; +} + +.pixel-corners::before, +.pixel-corners::after { + content: ""; + position: absolute; + width: 32px; + height: 32px; + border: 4px solid var(--neon-cyan); +} + +.pixel-corners::before { + top: -8px; + left: -8px; + border-right: none; + border-bottom: none; +} + +.pixel-corners::after { + bottom: -8px; + right: -8px; + border-left: none; + border-top: none; +} + +.pixel-corners.yellow-corners::before, +.pixel-corners.yellow-corners::after { border-color: var(--neon-yellow); } + +.pixel-corners.pink-corners::before, +.pixel-corners.pink-corners::after { border-color: var(--neon-pink); } + +.pixel-label { + font-family: var(--font-mono); + font-size: 22px; + font-weight: 700; + letter-spacing: 0.2em; + text-transform: uppercase; + color: var(--neon-yellow); + background: var(--deep-navy); + padding: 8px 20px; + display: inline-block; + margin-bottom: 24px; +} + +.slide-content { + position: relative; + z-index: 10; + width: 100%; + max-width: 1500px; + display: flex; + flex-direction: column; + justify-content: center; + align-items: center; +} + +:where(.slide) h1, :where(.slide) h2, :where(.slide) h3, :where(.slide) h4 { + font-family: var(--font-display); + font-weight: 700; + line-height: 1.15; +} + +:where(.slide) h1 { font-size: 64px; } +:where(.slide) h2 { font-size: 64px; } +:where(.slide) h3 { font-size: 36px; } +:where(.slide) p, :where(.slide) li { + font-family: var(--font-body); + font-size: 26px; + line-height: 1.7; + font-weight: 400; +} + +.page-number { + position: absolute; + bottom: 24px; + left: 50%; + transform: translateX(-50%); + font-family: var(--font-mono); + font-size: 22px; + color: var(--neon-cyan); + background: rgba(10, 14, 39, 0.8); + padding: 8px 24px; + z-index: 100; + letter-spacing: 0.15em; +} + +.page-number::after { + content: counter(dc-slide, decimal-leading-zero) " / " counter(dc-slides, decimal-leading-zero); +} + +.hero-subtitle { + font-family: var(--font-mono); + font-size: 24px; + letter-spacing: 0.3em; + color: var(--neon-pink); + text-transform: uppercase; + margin-bottom: 24px; +} + +.hero-tagline { + font-family: var(--font-body); + font-size: 30px; + color: rgba(255,255,255,0.7); + max-width: 880px; + text-align: center; + margin-top: 32px; + line-height: 1.8; +} + +.hero-badges { + display: flex; + gap: 24px; + margin-top: 48px; + flex-wrap: wrap; + justify-content: center; +} + +.hero-badge { + font-family: var(--font-mono); + font-size: 22px; + letter-spacing: 0.1em; + text-transform: uppercase; + padding: 12px 24px; + border: 2px solid var(--neon-yellow); + color: var(--neon-yellow); +} + +.split-layout { + display: grid; + grid-template-columns: 1fr 1fr; + gap: 77px; + align-items: center; + width: 100%; + height: 100%; + max-width: 1500px; +} + +.pixel-avatar-zone { + width: 100%; + aspect-ratio: 1; + max-width: 520px; + margin: 0 auto; + background: var(--deep-navy); + position: relative; + display: flex; + align-items: center; + justify-content: center; +} + +.pixel-avatar-zone::before { + content: ""; + position: absolute; + inset: 0; + background: + repeating-linear-gradient( + 45deg, + transparent, + transparent 10px, + rgba(94, 220, 244, 0.1) 10px, + rgba(94, 220, 244, 0.1) 20px + ); +} + +.pixel-face { + width: 160px; + height: 160px; + position: relative; +} + +.pixel-face .eye { + position: absolute; + width: 32px; + height: 32px; + background: var(--neon-cyan); + top: 40px; +} + +.pixel-face .eye.left { left: 20px; } +.pixel-face .eye.right { right: 20px; } + +.pixel-face .mouth { + position: absolute; + width: 80px; + height: 20px; + background: var(--neon-pink); + bottom: 32px; + left: 50%; + transform: translateX(-50%); +} + +.feature-grid { + display: grid; + grid-template-columns: repeat(4, 1fr); + gap: 32px; + width: 100%; + max-width: 1500px; +} + +.feature-card { + background: rgba(255,255,255,0.15); + backdrop-filter: blur(8px); + padding: 40px 28px; + text-align: center; + position: relative; + border: 2px solid rgba(15, 27, 61, 0.2); +} + +.feature-card::before { + content: ""; + position: absolute; + top: -2px; + left: -2px; + width: 16px; + height: 16px; + border-top: 4px solid var(--deep-navy); + border-left: 4px solid var(--deep-navy); +} + +.feature-card::after { + content: ""; + position: absolute; + bottom: -2px; + right: -2px; + width: 16px; + height: 16px; + border-bottom: 4px solid var(--deep-navy); + border-right: 4px solid var(--deep-navy); +} + +.feature-icon { + width: 64px; + height: 64px; + margin: 0 auto 24px; + position: relative; +} + +.feature-icon.cube { + background: var(--deep-navy); + box-shadow: 8px 8px 0 var(--neon-yellow); +} + +.feature-icon.diamond { + background: var(--neon-cyan); + transform: rotate(45deg); + width: 48px; + height: 48px; + margin-bottom: 30px; + margin-top: 8px; +} + +.feature-icon.cross { + background: var(--neon-pink); + position: relative; +} + +.feature-icon.cross::before, +.feature-icon.cross::after { + content: ""; + position: absolute; + background: var(--deep-navy); +} + +.feature-icon.cross::before { inset: 13px 5px; } +.feature-icon.cross::after { inset: 5px 13px; } + +.feature-icon.circle { + border: 8px solid var(--neon-yellow); + border-radius: 0; + background: transparent; + position: relative; +} + +.feature-icon.circle::after { + content: ""; + position: absolute; + inset: 11px; + background: var(--neon-yellow); +} + +.feature-card h3 { + font-size: 32px; + margin-bottom: 12px; + color: var(--deep-navy); +} + +.feature-card p { + font-size: 24px; + color: rgba(15, 27, 61, 0.75); + line-height: 1.6; +} + +.chart-slide-layout { + width: 100%; + max-width: 1300px; + display: flex; + flex-direction: column; + align-items: center; +} + +.pixel-chart-title { + text-align: center; + margin-bottom: 48px; +} + +.pixel-chart-title h2 { + color: var(--neon-cyan); + margin-bottom: 8px; +} + +.pixel-chart-title .subtitle { + font-family: var(--font-mono); + font-size: 22px; + color: var(--neon-pink); + letter-spacing: 0.15em; +} + +.pixel-bar-chart { + width: 100%; + display: flex; + align-items: flex-end; + justify-content: center; + gap: 40px; + height: 460px; + padding: 0 20px; + position: relative; +} + +.pixel-bar-chart::before { + content: ""; + position: absolute; + bottom: 0; + left: 0; + right: 0; + height: 2px; + background: var(--neon-cyan); + opacity: 0.5; +} + +.chart-bar-group { + display: flex; + flex-direction: column; + justify-content: flex-end; + align-items: center; + gap: 12px; + flex: 1; + max-width: 160px; + height: 100%; +} + +.chart-bar { + width: 100%; + height: calc((100% - 120px) * var(--value) / 100); + background: var(--neon-cyan); + position: relative; + box-shadow: 4px 0 0 0 var(--deep-navy), 0 4px 0 0 var(--deep-navy), 4px 4px 0 0 var(--deep-navy); +} + +.chart-bar.alt { background: var(--neon-pink); } +.chart-bar.alt2 { background: var(--neon-yellow); } + +.chart-bar-label { + font-family: var(--font-mono); + font-size: 22px; + color: rgba(255,255,255,0.8); + text-align: center; + letter-spacing: 0.05em; +} + +.chart-value { + font-family: var(--font-mono); + font-size: 28px; + font-weight: 700; + color: var(--neon-yellow); + margin-bottom: 4px; +} + +.pixel-hbar-chart { + width: 100%; + display: flex; + flex-direction: column; + gap: 28px; +} + +.hbar-row { + display: grid; + grid-template-columns: 200px 1fr 90px; + align-items: center; + gap: 24px; +} + +.hbar-label { + font-family: var(--font-mono); + font-size: 24px; + color: var(--deep-navy); + text-align: right; + font-weight: 700; +} + +.hbar-track { + height: 44px; + background: rgba(15, 27, 61, 0.1); + position: relative; +} + +.hbar-fill { + height: 100%; + background: var(--deep-navy); + position: relative; + box-shadow: 4px 4px 0 var(--neon-yellow); +} + +.hbar-fill.alt { background: var(--neon-cyan); box-shadow: 4px 4px 0 var(--deep-navy); } +.hbar-fill.alt2 { background: var(--neon-pink); box-shadow: 4px 4px 0 var(--deep-navy); } + +.hbar-value { + font-family: var(--font-mono); + font-size: 26px; + font-weight: 700; + color: var(--deep-navy); +} + +.timeline-container { + width: 100%; + max-width: 1300px; + position: relative; +} + +.timeline-line { + position: absolute; + left: 50%; + top: 0; + bottom: 0; + width: 4px; + background: repeating-linear-gradient( + to bottom, + var(--deep-navy) 0px, + var(--deep-navy) 16px, + transparent 16px, + transparent 24px + ); + transform: translateX(-50%); +} + +.timeline-events { + display: flex; + flex-direction: column; + gap: 28px; + position: relative; +} + +.timeline-event { + display: grid; + grid-template-columns: 1fr 80px 1fr; + align-items: center; + gap: 32px; +} + +.timeline-event:nth-child(even) .timeline-text { grid-column: 3; text-align: left; } +.timeline-event:nth-child(even) .timeline-spacer { grid-column: 2; } +.timeline-event:nth-child(even) .timeline-empty { grid-column: 1; } + +.timeline-event:nth-child(odd) .timeline-text { grid-column: 1; text-align: right; } +.timeline-event:nth-child(odd) .timeline-spacer { grid-column: 2; } +.timeline-event:nth-child(odd) .timeline-empty { grid-column: 3; } + +.timeline-node { + width: 32px; + height: 32px; + background: var(--neon-cyan); + border: 4px solid var(--deep-navy); + justify-self: center; + position: relative; + z-index: 2; +} + +.timeline-node.current { background: var(--neon-yellow); } + +.timeline-text h4 { + font-size: 32px; + color: var(--deep-navy); + margin-bottom: 4px; +} + +.timeline-text p { + font-size: 24px; + color: rgba(15, 27, 61, 0.7); + line-height: 1.5; +} + +.timeline-text .date { + font-family: var(--font-mono); + font-size: 22px; + color: var(--neon-cyan); + background: var(--deep-navy); + display: inline-block; + padding: 2px 12px; + margin-bottom: 8px; +} + +.stats-grid { + display: grid; + grid-template-columns: repeat(4, 1fr); + gap: 40px; + width: 100%; + max-width: 1500px; +} + +.stat-block { + text-align: center; + padding: 48px 16px; + background: rgba(94, 220, 244, 0.08); + border: 2px solid rgba(94, 220, 244, 0.2); + position: relative; +} + +.stat-block::before { + content: ""; + position: absolute; + top: -2px; + left: -2px; + width: 24px; + height: 24px; + border-top: 4px solid var(--neon-cyan); + border-left: 4px solid var(--neon-cyan); +} + +.stat-block::after { + content: ""; + position: absolute; + bottom: -2px; + right: -2px; + width: 24px; + height: 24px; + border-bottom: 4px solid var(--neon-cyan); + border-right: 4px solid var(--neon-cyan); +} + +.stat-number { + font-family: var(--font-display); + font-size: 88px; + font-weight: 900; + color: var(--neon-cyan); + line-height: 1; + margin-bottom: 16px; + text-shadow: 3px 3px 0 var(--deep-navy); +} + +.stat-label { + font-family: var(--font-mono); + font-size: 22px; + letter-spacing: 0.12em; + text-transform: uppercase; + color: var(--neon-pink); +} + +.quote-container { + max-width: 1100px; + text-align: center; + position: relative; + padding: 72px; +} + +.quote-mark { + font-family: var(--font-display); + font-size: 200px; + line-height: 1; + color: var(--deep-navy); + opacity: 0.15; + position: absolute; + top: -20px; + left: 50%; + transform: translateX(-50%); +} + +.quote-text { + font-family: var(--font-body); + font-size: 42px; + font-weight: 500; + color: var(--deep-navy); + line-height: 1.6; + position: relative; + z-index: 2; +} + +.quote-author { + margin-top: 32px; + font-family: var(--font-mono); + font-size: 24px; + color: rgba(15, 27, 61, 0.7); + letter-spacing: 0.1em; +} + +.quote-line { + width: 80px; + height: 6px; + background: var(--neon-yellow); + margin: 32px auto 0; + box-shadow: 4px 4px 0 var(--deep-navy); +} + +.tier-grid { + display: grid; + grid-template-columns: repeat(3, 1fr); + gap: 40px; + width: 100%; + max-width: 1400px; +} + +.tier-card { + background: white; + padding: 36px 32px; + position: relative; + text-align: center; +} + +.tier-card.featured { + background: var(--deep-navy); + color: white; + transform: translateY(-12px); + box-shadow: 8px 8px 0 var(--neon-yellow); +} + +.tier-card:not(.featured) { + box-shadow: 6px 6px 0 rgba(15, 27, 61, 0.15); +} + +.tier-name { + font-family: var(--font-display); + font-size: 36px; + margin-bottom: 8px; +} + +.tier-price { + font-family: var(--font-mono); + font-size: 56px; + font-weight: 700; + color: var(--neon-cyan); + margin-bottom: 4px; +} + +.tier-price span { + font-size: 24px; + color: rgba(15, 27, 61, 0.5); +} + +.tier-card.featured .tier-price span { color: rgba(255,255,255,0.5); } + +.tier-desc { + font-size: 24px; + color: rgba(15, 27, 61, 0.6); + margin-bottom: 20px; + line-height: 1.5; +} + +.tier-card.featured .tier-desc { color: rgba(255,255,255,0.6); } + +.tier-features { + list-style: none; + text-align: left; + margin-bottom: 24px; +} + +.tier-features li { + font-size: 24px; + line-height: 1.5; + padding: 6px 0 6px 28px; + border-bottom: 1px dashed rgba(15, 27, 61, 0.15); + position: relative; +} + +.tier-features li::before { + content: "+"; + position: absolute; + left: 0; + font-family: var(--font-mono); + color: var(--neon-cyan); + font-weight: 700; +} + +.tier-card.featured .tier-features li { border-color: rgba(255,255,255,0.1); } + +.cta-content { + text-align: center; + max-width: 1200px; +} + +.cta-content h2 { + font-size: 96px; + color: var(--neon-cyan); + margin-bottom: 32px; + text-shadow: 8px 8px 0 var(--deep-navy), 16px 16px 0 var(--neon-yellow); +} + +.cta-content p { + color: rgba(255,255,255,0.7); + margin-bottom: 80px; + font-size: 35px; +} + +.cta-buttons { + display: flex; + gap: 40px; + justify-content: center; + flex-wrap: wrap; +} + +.pixel-landscape { + position: absolute; + bottom: 0; + left: 0; + right: 0; + height: 240px; + display: flex; + align-items: flex-end; + justify-content: center; + gap: 0; + z-index: 2; + opacity: 0.3; + pointer-events: none; +} + +.mountain { + background: var(--deep-navy); + width: 160px; + position: relative; +} diff --git a/desktop/design-templates/8-bit-orbit/index.html b/desktop/design-templates/8-bit-orbit/index.html new file mode 100644 index 00000000..03f45ca7 --- /dev/null +++ b/desktop/design-templates/8-bit-orbit/index.html @@ -0,0 +1,10 @@ + + + + +Deck + + + + + diff --git a/desktop/design-templates/8-bit-orbit/slides/allocation.html b/desktop/design-templates/8-bit-orbit/slides/allocation.html new file mode 100644 index 00000000..2501a1b5 --- /dev/null +++ b/desktop/design-templates/8-bit-orbit/slides/allocation.html @@ -0,0 +1,49 @@ +
+
+
+
+ System Load +

Resource Allocation

+

Percentage distribution across operational units

+
+
+
+
Compute
+
+
+
+
88%
+
+
+
Storage
+
+
+
+
72%
+
+
+
Network
+
+
+
+
95%
+
+
+
Memory
+
+
+
+
61%
+
+
+
Graphics
+
+
+
+
44%
+
+
+
+
+
+
diff --git a/desktop/design-templates/8-bit-orbit/slides/closing.html b/desktop/design-templates/8-bit-orbit/slides/closing.html new file mode 100644 index 00000000..77760444 --- /dev/null +++ b/desktop/design-templates/8-bit-orbit/slides/closing.html @@ -0,0 +1,96 @@ +
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+

Ready Player
One?

+

Deploy your first 8-BIT ORBIT deck in under sixty seconds. No dependencies. No friction. Just pure presentation power.

+
+ + +
+
+
+
+
diff --git a/desktop/design-templates/8-bit-orbit/slides/cover.html b/desktop/design-templates/8-bit-orbit/slides/cover.html new file mode 100644 index 00000000..3ff52b7f --- /dev/null +++ b/desktop/design-templates/8-bit-orbit/slides/cover.html @@ -0,0 +1,83 @@ +
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
Pixel Perfect Presentation System
+

8-BIT
ORBIT

+

A retro-futuristic deck engine for bold storytellers. Built for arcades, engineered for boardrooms.

+
+ 10 Slides + CSS Native + Zero Dependencies +
+
+
+
diff --git a/desktop/design-templates/8-bit-orbit/slides/engines.html b/desktop/design-templates/8-bit-orbit/slides/engines.html new file mode 100644 index 00000000..9ccdc813 --- /dev/null +++ b/desktop/design-templates/8-bit-orbit/slides/engines.html @@ -0,0 +1,31 @@ +
+
+
+ Core Systems +

Four Engines Running

+
+
+
+
+

Modular Blocks

+

Swap components without breaking the grid. Every element is containerized and responsive by default.

+
+
+
+

Crisp Vectors

+

All visual effects are native CSS. No image assets required for borders, shadows, or patterns.

+
+
+
+

Live Data

+

Chart slides accept dynamic values. Bars grow with CSS transitions triggered on navigation.

+
+
+
+

Retro Atmosphere

+

Scanlines, CRT vignettes, starfields, and noise layers create an immersive viewing environment.

+
+
+
+
+
diff --git a/desktop/design-templates/8-bit-orbit/slides/growth.html b/desktop/design-templates/8-bit-orbit/slides/growth.html new file mode 100644 index 00000000..25ac3636 --- /dev/null +++ b/desktop/design-templates/8-bit-orbit/slides/growth.html @@ -0,0 +1,71 @@ +
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ Analytics Core +

Quarterly Growth Metrics

+

Fiscal performance across four sectors — normalized index

+
+
+
+
78
+
+
Alpha
+
+
+
92
+
+
Beta
+
+
+
64
+
+
Gamma
+
+
+
85
+
+
Delta
+
+
+
56
+
+
Epsilon
+
+
+
+
+
+
diff --git a/desktop/design-templates/8-bit-orbit/slides/intro.html b/desktop/design-templates/8-bit-orbit/slides/intro.html new file mode 100644 index 00000000..d1ecb77c --- /dev/null +++ b/desktop/design-templates/8-bit-orbit/slides/intro.html @@ -0,0 +1,24 @@ +
+
+
+
+
+
+
+
+
+
+
+ Mission Brief +

Rewiring How We Share Ideas

+

+ Every presentation is an opportunity to transport your audience. This template fuses the tactile nostalgia of 16-bit aesthetics with modern typographic discipline. +

+

+ No canvas limits. No cookie-cutter layouts. Just pure CSS architecture delivering cinematic slide transitions and atmospheric depth through scanlines, grain, and glowing grids. +

+
+
+
+
+
diff --git a/desktop/design-templates/8-bit-orbit/slides/pricing.html b/desktop/design-templates/8-bit-orbit/slides/pricing.html new file mode 100644 index 00000000..0a641076 --- /dev/null +++ b/desktop/design-templates/8-bit-orbit/slides/pricing.html @@ -0,0 +1,48 @@ +
+
+
+ Access Tiers +

Choose Your Loadout

+
+
+
+
Rookie
+
$0/mo
+
For solo explorers testing the waters.
+
    +
  • 5 slide maximum
  • +
  • Standard grid themes
  • +
  • Community support
  • +
  • Static export only
  • +
+ +
+ +
+
Boss
+
$79/mo
+
Enterprise-grade control and compliance.
+
    +
  • Everything in Arcade
  • +
  • White-label export
  • +
  • SSO & audit logs
  • +
  • Dedicated pipeline
  • +
+ +
+
+
+
+
diff --git a/desktop/design-templates/8-bit-orbit/slides/quote.html b/desktop/design-templates/8-bit-orbit/slides/quote.html new file mode 100644 index 00000000..378ada0a --- /dev/null +++ b/desktop/design-templates/8-bit-orbit/slides/quote.html @@ -0,0 +1,13 @@ +
+
+
+
"
+

+ The best presentations do not merely inform. They immerse. They transform the conference room into an arcade cabinet where every slide is a new level waiting to be unlocked. +

+
+
— Lead Creative Technologist, Studio Orbital
+
+
+
+
diff --git a/desktop/design-templates/8-bit-orbit/slides/roadmap.html b/desktop/design-templates/8-bit-orbit/slides/roadmap.html new file mode 100644 index 00000000..697ba712 --- /dev/null +++ b/desktop/design-templates/8-bit-orbit/slides/roadmap.html @@ -0,0 +1,58 @@ +
+
+
+ Chronology +

Development Roadmap

+
+
+
+
+
+
+ Q1 2026 +

Concept & Architecture

+

Wireframes, palette selection, and core grid system established.

+
+
+
+
+
+
+
+
+
+
+
+
+ Q2 2026 +

Asset Generation

+

Pixel components, iconography, and atmospheric effects coded.

+
+
+
+
+ Q3 2026 +

Data Integration

+

Charting engine, animated counters, and dynamic state binding.

+
+
+
+
+
+
+
+
+
+
+
+
+ Q4 2026 +

Global Launch

+

Public release with full documentation and community support.

+
+
+
+
+
+
+
diff --git a/desktop/design-templates/8-bit-orbit/slides/vitals.html b/desktop/design-templates/8-bit-orbit/slides/vitals.html new file mode 100644 index 00000000..be97c56b --- /dev/null +++ b/desktop/design-templates/8-bit-orbit/slides/vitals.html @@ -0,0 +1,65 @@ +
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ Live Telemetry +

Platform Vitals

+

Real-time aggregate figures from active deployments

+
+
+
+
847
+
Active Worlds
+
+
+
12.4M
+
Pixels Rendered
+
+
+
99.9%
+
Uptime Score
+
+
+
2048
+
Max Resolution
+
+
+
+
+
diff --git a/desktop/design-templates/LICENSE-beautiful-html-templates.txt b/desktop/design-templates/LICENSE-beautiful-html-templates.txt new file mode 100644 index 00000000..cb9abe0d --- /dev/null +++ b/desktop/design-templates/LICENSE-beautiful-html-templates.txt @@ -0,0 +1,21 @@ +MIT License + +Copyright (c) 2026 Zara Zhang + +Permission is hereby granted, free of charge, to any person obtaining a copy +of this software and associated documentation files (the "Software"), to deal +in the Software without restriction, including without limitation the rights +to use, copy, modify, merge, publish, distribute, sublicense, and/or sell +copies of the Software, and to permit persons to whom the Software is +furnished to do so, subject to the following conditions: + +The above copyright notice and this permission notice shall be included in all +copies or substantial portions of the Software. + +THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR +IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, +FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE +AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER +LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, +OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE +SOFTWARE. diff --git a/desktop/design-templates/biennale-yellow/DESIGN.md b/desktop/design-templates/biennale-yellow/DESIGN.md new file mode 100644 index 00000000..74e555a2 --- /dev/null +++ b/desktop/design-templates/biennale-yellow/DESIGN.md @@ -0,0 +1,570 @@ +--- +version: alpha +name: Biennale Yellow +description: "A literary-editorial presentation system in the visual register of an art biennale catalogue or quiet exhibition poster. The aesthetic is built on warm parchment grounds (`#E9E5DB`) flooded with soft solar yellow (`#F1EE2E`) radial blooms, set against a single deep indigo navy ink color. Display type is Instrument Serif — a contemporary high-contrast serif with tall ascenders and elegant italics — paired with Archivo for sans-serif chrome and JetBrains Mono for numerical and metadata callouts. No drop shadows, no rounded corners, no bordered cards: the only structural lines are hairline 1px rules in ink. The mood sits between a folded museum brochure, a slow-reading literary quarterly, and a Mediterranean exhibition poster — confident, atmospheric, and deeply restrained." + +colors: + paper: "#E9E5DB" + paper-deep: "#DCD6C4" + sun: "#F1EE2E" + sun-soft: "#F8F39B" + haze: "#F0DA7C" + ink: "#1B2566" + ember: "#E26B4A" + +color-aliases: + line: ink + +typography: + display: + fontFamily: "'Instrument Serif', Georgia, serif" + fontWeight: 400 + fontSize: "clamp(120px, min(14.6vw, 22vh), 240px)" + lineHeight: 0.86 + letterSpacing: -0.018em + display-md: + fontFamily: "'Instrument Serif', Georgia, serif" + fontWeight: 400 + fontSize: "clamp(80px, min(10vw, 16vh), 200px)" + lineHeight: 0.86 + letterSpacing: -0.018em + display-sm: + fontFamily: "'Instrument Serif', Georgia, serif" + fontWeight: 400 + fontSize: "clamp(110px, min(11vw, 18vh), 200px)" + lineHeight: 0.86 + letterSpacing: -0.018em + display-it: + fontFamily: "'Instrument Serif', Georgia, serif" + fontWeight: 400 + fontStyle: italic + fontSize: "clamp(56px, min(7vw, 11vh), 120px)" + lineHeight: 1.04 + letterSpacing: -0.005em + numeral-jumbo: + fontFamily: "'Instrument Serif', Georgia, serif" + fontWeight: 400 + fontSize: "clamp(220px, min(28vw, 64vh), 720px)" + lineHeight: 0.84 + letterSpacing: -0.04em + numeral-lg: + fontFamily: "'Instrument Serif', Georgia, serif" + fontWeight: 400 + fontSize: "clamp(120px, min(15vw, 22vh), 280px)" + lineHeight: 0.9 + letterSpacing: -0.04em + numeral-md: + fontFamily: "'Instrument Serif', Georgia, serif" + fontWeight: 400 + fontSize: "clamp(72px, min(7vw, 12vh), 144px)" + lineHeight: 0.92 + letterSpacing: -0.01em + headline: + fontFamily: "'Instrument Serif', Georgia, serif" + fontWeight: 400 + fontSize: "clamp(40px, min(4.6vw, 7vh), 88px)" + lineHeight: 1.06 + letterSpacing: -0.005em + headline-sm: + fontFamily: "'Instrument Serif', Georgia, serif" + fontWeight: 400 + fontSize: "clamp(32px, min(3.6vw, 6vh), 56px)" + lineHeight: 1 + date-rail: + fontFamily: "'Instrument Serif', Georgia, serif" + fontWeight: 400 + fontSize: "clamp(48px, min(5.2vw, 9vh), 96px)" + lineHeight: 0.96 + letterSpacing: -0.005em + ledger-title: + fontFamily: "'Instrument Serif', Georgia, serif" + fontWeight: 400 + fontSize: "clamp(20px, 1.6vw, 30px)" + lineHeight: 1.15 + strand-title: + fontFamily: "'Instrument Serif', Georgia, serif" + fontWeight: 400 + fontSize: "clamp(22px, 1.7vw, 32px)" + lineHeight: 1.1 + strand-num: + fontFamily: "'Instrument Serif', Georgia, serif" + fontWeight: 400 + fontSize: "clamp(28px, 2vw, 38px)" + lineHeight: 1 + body-lede: + fontFamily: "'Archivo', sans-serif" + fontWeight: 400 + fontSize: "clamp(15px, 1.05vw, 18px)" + lineHeight: 1.55 + body: + fontFamily: "'Archivo', sans-serif" + fontWeight: 400 + fontSize: "clamp(14px, 0.95vw, 16px)" + lineHeight: 1.5 + body-sm: + fontFamily: "'Archivo', sans-serif" + fontWeight: 400 + fontSize: "clamp(11px, 0.78vw, 13px)" + lineHeight: 1.5 + micro-label: + fontFamily: "'Archivo', sans-serif" + fontWeight: 600 + fontSize: "clamp(11px, 0.85vw, 14px)" + lineHeight: 1.2 + letterSpacing: 0.18em + textTransform: uppercase + micro-label-tight: + fontFamily: "'Archivo', sans-serif" + fontWeight: 600 + fontSize: "clamp(10px, 0.72vw, 12px)" + lineHeight: 1.2 + letterSpacing: 0.16em + textTransform: uppercase + rail-label: + fontFamily: "'Archivo', sans-serif" + fontWeight: 600 + fontSize: "clamp(11px, 0.85vw, 13px)" + lineHeight: 1 + letterSpacing: 0.32em + textTransform: uppercase + mono-data: + fontFamily: "'JetBrains Mono', ui-monospace, monospace" + fontWeight: 400 + fontSize: "clamp(12px, 0.85vw, 14px)" + lineHeight: 1.4 + letterSpacing: 0.04em + mono-date: + fontFamily: "'JetBrains Mono', ui-monospace, monospace" + fontWeight: 400 + fontSize: "clamp(13px, 0.95vw, 16px)" + lineHeight: 1.4 + letterSpacing: 0.02em + pagenum: + fontFamily: "'JetBrains Mono', ui-monospace, monospace" + fontWeight: 400 + fontSize: "clamp(11px, 0.85vw, 13px)" + lineHeight: 1 + letterSpacing: 0.08em + +spacing: + pad-edge: "clamp(40px, 4vw, 76px)" + pad-region: "clamp(40px, 4.2vw, 80px)" + pad-foot: "clamp(56px, 5vh, 88px)" + pad-strand-y: "clamp(12px, 1.6vh, 22px)" + gap-region: "clamp(20px, 2.5vw, 48px)" + gap-strand: "clamp(14px, 1.8vh, 22px)" + gap-footer-col: "clamp(20px, 2.4vw, 44px)" + pagenum-bottom: "clamp(22px, 2.4vh, 42px)" + pagenum-right: "clamp(24px, 2.4vw, 48px)" + +canvas: + width: 100vw + height: 100vh + background: "{colors.paper}" + +components: + pagenum: + position: "absolute, right + bottom" + color: "{colors.ink}" + opacity: 0.75 + fontFamily: "'JetBrains Mono', ui-monospace, monospace" + fontSize: "clamp(11px, 0.85vw, 13px)" + letterSpacing: 0.08em + description: "Single mono pagenum NN / NN pinned to bottom-right of every slide at 75% opacity. The only persistent chrome on every surface." + hairline-rule: + border: "1px solid {colors.ink}" + description: "1px solid ink horizontal or vertical rule. The system's only border treatment — separates header bands from content, footer columns from each other, ledger rows from each other. No thicker rule exists." + hairline-rule-soft: + border: "1px solid rgba(27, 37, 102, 0.18-0.2)" + description: "1px ink at 18-20% opacity. Used for between-row separators inside dense ledger or strand lists where a full-weight rule would feel oppressive." + sun-bloom: + background: "radial-gradient using {colors.sun} {colors.sun-soft} {colors.haze} blending to transparent on {colors.paper}" + description: "Large soft radial bloom of solar yellow placed off-center or behind a focal element. The system's primary atmospheric layer. Sized 42-70% of viewport in the larger axis." + ember-bloom: + background: "radial-gradient using {colors.ember} at 15-22% opacity blending to transparent" + description: "Small warm peach bloom used as a counter-temperature accent in a corner opposite the sun bloom. Always subordinate; never dominant." + block-tile: + background: "{colors.sun} at 40-70% opacity" + description: "Geometric blocks of translucent solar yellow placed on an 8-row × 4-column grid behind cover or colophon surfaces. Suggests a layered poster underprint." + yellow-panel: + background: "{colors.sun}" + color: "{colors.ink}" + description: "Full-bleed yellow panel covering a column or third of the slide. The strongest possible color statement — used when a region needs to read as poster-fill, not paper." + bar-ink: + background: "{colors.ink}" + height: "clamp(14px, 1.6vh, 22px)" + description: "Solid ink horizontal bar for data charts. Width carries the data value." + bar-lit: + background: "{colors.sun}" + border: "1px solid {colors.ink}" + height: "clamp(14px, 1.6vh, 22px)" + description: "Highlighted variant of bar-ink — yellow fill with 1px ink stroke. Used to mark the current or featured row in a series." + strand-row: + layout: "grid 56px 1fr, gap clamp(14px, 1.4vw, 24px), border-bottom hairline-soft, padding-bottom clamp(12px, 1.6vh, 22px)" + description: "Numbered editorial list row — numeral cell + content cell separated by hairline-soft. Used for programmes, agendas, and curated lists." + ledger-row: + layout: "grid 92px 1.6fr 0.9fr 80px, gap clamp(14px, 1.4vw, 28px), border-bottom hairline-soft, padding clamp(10px, 1.3vh, 18px) 0" + description: "Four-column tabular row for calendars and itineraries. Date column is mono, title is serif, venue is sans, duration is mono right-aligned." + footer-band: + layout: "grid 4-column with hairline-rule top border on each cell, gap clamp(20px, 2.4vw, 44px)" + description: "Four-column metadata strip pinned to the bottom of cover and colophon surfaces. Each cell has a tiny uppercase tag + a brief plain-English statement." + vertical-rail: + transform: "rotate(-90deg) translateY(-50%) at left edge" + fontFamily: "'Archivo', sans-serif" + fontSize: "clamp(11px, 0.85vw, 13px)" + letterSpacing: 0.32em + textTransform: uppercase + description: "Rotated vertical text label running up the left edge. Used on chapter/divider surfaces as a section marker." + date-rail-stack: + fontFamily: "'Instrument Serif', Georgia, serif" + fontSize: "clamp(48px, min(5.2vw, 9vh), 96px)" + lineHeight: 0.96 + textAlign: right + description: "Large serif date or date-range stacked at top-right of cover surfaces. Uses an en-dash to indicate spans." +--- + +> This design note comes from [beautiful-html-templates](https://github.com/zarazhangrui/beautiful-html-templates) (MIT, Copyright (c) 2026 Zara Zhang). The template in this folder was converted to the DreamCoder deck format: a fixed 1920 by 1080 stage, one file per slide under slides/, all styles in deck.css, no scripts in slides, and page numbers from the stage counters. Where this note talks about viewport units, navigation, slide counters, scripts or a single HTML file, the deck format wins; colors, type and decoration are as described here. + +## Overview + +Biennale Yellow is a **literary-editorial presentation system** modeled on the visual language of European art biennale catalogues, slow exhibition posters, and quarterly literary publications. There are no cards, no buttons, no shadows, no rounded corners. The structural vocabulary is just three things: paper, ink, and yellow. + +The typographic system pivots on **Instrument Serif**, a contemporary high-contrast serif with tall ascenders, elegant italics, and slightly flared terminals. It carries every display moment, every numeral, every quote — at scales ranging from headline-small (40px) to jumbo numerals over 700px. Set tight (line-height 0.86, letter-spacing −0.018em), it reads as confident editorial display; set looser in italic (line-height 1.04, letter-spacing −0.005em), it becomes a slow-reading quotation face. **Archivo** is the sans companion — used for body paragraphs and as small, wide-tracked uppercase labels (the "micro-label" treatment). **JetBrains Mono** handles all numerical and metadata callouts: dates, ledger figures, page numbers. The three-face system is rigid and disciplined; the contrast between them is the entire typographic story. + +The color world is built on **warm parchment** (`{colors.paper}` — `#E9E5DB`) as the universal ground, marked by a single **ink** color (`{colors.ink}` — `#1B2566`, a deep indigo navy) used for every line of type and every rule. The system's signature color is **sun** (`{colors.sun}` — `#F1EE2E`), a highly saturated solar yellow used as a flooded panel, as a soft blooming radial gradient, or as a geometric tile underprint. A **soft ember peach** (`{colors.ember}` — `#E26B4A`) appears only as a subordinate counter-temperature accent, always at 15-22% opacity in a corner radial bloom. Inverted color treatments are not used; the system commits to navy ink on a warm ground. + +Depth is **atmospheric, not structural**. There are no drop shadows anywhere in the system. Depth comes from layered radial gradients of yellow (the sun-bloom and ember-bloom components) and the optional block-tile underprint on cover-class surfaces. Cards have no borders; regions are separated only by 1px hairline rules in ink. The lack of border weight is itself the aesthetic — the design feels printed, not engineered. + +**Density philosophy: editorial-restrained.** This system reads as elegant when sparse and broken when crowded. A typical surface holds one large display moment + a handful of supporting elements (a micro-label, a body paragraph, an ordered list, or a single radial bloom). Crowding the canvas with cards, buttons, panels, or stacked components turns the system into a different aesthetic entirely. Even dense surfaces (a calendar or programme) achieve density through tabular repetition, not visual richness — many quiet rows of hairline-separated metadata, not many bordered cells. Generous edge padding (40-76px) and wide footer/header bands let the canvas breathe. + +**Key Characteristics:** +- Warm parchment ground (`{colors.paper}`) on every surface; never white, never gray. +- Single ink color (`{colors.ink}`) for all text and all rules — no secondary text colors. +- Solar yellow (`{colors.sun}`) deployed three ways: as a flooded panel, as a soft radial bloom, as a translucent geometric tile underprint. +- Instrument Serif handles every display moment at scales from 40px to 720px+. +- Archivo Bold uppercase + 0.16–0.32em tracking is the universal label voice. +- JetBrains Mono is reserved exclusively for dates, ledger numerals, and page numbers. +- 1px hairline rules in `{colors.ink}` are the only border treatment — used for header bands, ledger rows, footer columns, and strand separators. +- No drop shadows, no rounded corners, no card outlines, no buttons. Decoration is atmospheric (radial blooms) or geometric (translucent tile blocks). +- Persistent `01 / NN` JetBrains Mono pagenumber at bottom-right of every surface at 75% opacity. +- Optional vertical rotated rail-label at the left edge of chapter/divider surfaces. + +## Colors + +### Palette + +- **Paper** (`{colors.paper}` — `#E9E5DB`): The warm parchment canvas. The default and near-universal background. Reads as a softened off-white with strong warmth — never neutral, never cold. +- **Paper-deep** (`{colors.paper-deep}` — `#DCD6C4`): A slightly darker parchment tone, available as a secondary surface or to suggest a shadow band without using actual shadow. Reserved for moments that need surface differentiation while staying within the warm-paper family. +- **Ink** (`{colors.ink}` — `#1B2566`): The single text and line color across the entire system. A deep indigo navy that reads as confident editorial black-with-blue-bias. Used for headlines, body, micro-labels, monos, hairline rules, and ink-bar fills. The `--line` CSS variable resolves to this same color. +- **Sun** (`{colors.sun}` — `#F1EE2E`): The system's signature solar yellow. Highly saturated, slightly green-leaning. Used three ways: as a flooded full-bleed or column-bleed panel, as the core of soft radial blooms, and as 40-70% opacity geometric tile blocks. +- **Sun-soft** (`{colors.sun-soft}` — `#F8F39B`): A paler buttery yellow used in the middle stops of sun-bloom gradients to soften the transition from saturated sun to paper. +- **Haze** (`{colors.haze}` — `#F0DA7C`): A warmer mustard-leaning yellow used in the outermost stops of sun-bloom gradients to extend the bloom into the paper without a hard edge. +- **Ember** (`{colors.ember}` — `#E26B4A`): A warm peach-orange used only as a subordinate counter-temperature accent in 15-22% opacity radial blooms. Never used as a fill color, never as a text color. Its job is to balance a sun-bloom on the opposite side of the canvas. + +### Defaults + +- **Default surface background**: `{colors.paper}`. Every surface starts here. +- **Default headline color**: `{colors.ink}`. Always. Headlines never appear in yellow, ember, or paper-deep — only ink. +- **Default body text color**: `{colors.ink}`. Body uses the same color as display; the contrast is achieved through size and weight, not color. +- **Default rule color**: `{colors.ink}` (1px solid) for primary separators, ink at 18-20% opacity for secondary row separators. +- **Default accent surface for poster moments**: `{colors.sun}` — a flooded panel of solar yellow with `{colors.ink}` text on top. +- **Default atmospheric layer**: a single `{components.sun-bloom}` placed off-center on the surface, with an optional `{components.ember-bloom}` in the opposite corner. +- **Default chart bar color**: `{colors.ink}`. The featured/current bar uses `{components.bar-lit}` (yellow fill, ink stroke). +- **Default label color**: `{colors.ink}` for the text, no fill. Labels are tracking + uppercase + weight 600, not filled pills. + +The system never inverts: ink text on a sun panel is correct (and a key signature treatment), but yellow text on an ink ground does not exist. Text is always ink; the variability lives in what's behind the text, not in the text color itself. + +## Typography + +### Font Family Stack +The system runs three faces, each with a tightly defined role. + +**Instrument Serif** (Google Fonts, italic + roman) is the display and editorial face. Its high contrast, tall ascenders, and slightly flared terminals give it a contemporary literary register — closer to a magazine masthead than a traditional book serif. Roman is used for headlines, numerals, ledger titles, and date rails. Italic is used for manifesto quotes and certain emphasis moments. Set tight (line-height ≤ 1.06, negative letter-spacing −0.005 to −0.04em). + +**Archivo** (Google Fonts) is the sans companion. Used at weight 400 for body paragraphs (line-height 1.5) and at weight 600 for the universal micro-label treatment (uppercase, 0.16-0.32em tracking, 10-14px). Never used at intermediate weights, never used for headlines. + +**JetBrains Mono** (Google Fonts) is the numerical/metadata face. Used exclusively for dates in ledgers, mono numerical callouts in data slides, page numbers, and the nav-hint. Its slab character gives editorial weight to numerical content without leaning on bold styling. + +### Typography Scale + +| Token | Size (clamp) | Family | Weight | Use | +|---|---|---|---|---| +| `{typography.display}` | 120–240px | Instrument Serif | 400 | Cover-scale display title | +| `{typography.display-sm}` | 110–200px | Instrument Serif | 400 | Editorial display in a panel context | +| `{typography.display-md}` | 80–200px | Instrument Serif | 400 | Closing-statement display | +| `{typography.display-it}` | 56–120px | Instrument Serif italic | 400 | Manifesto-scale italic quote body | +| `{typography.numeral-jumbo}` | 220–720px | Instrument Serif | 400 | Chapter-divider ordinal numeral | +| `{typography.numeral-lg}` | 120–280px | Instrument Serif | 400 | Decorative quotation mark, oversized punctuation | +| `{typography.numeral-md}` | 72–144px | Instrument Serif | 400 | Hero stat figure | +| `{typography.headline}` | 40–88px | Instrument Serif | 400 | Primary section headline, large quote body | +| `{typography.headline-sm}` | 32–56px | Instrument Serif | 400 | Region headline, ledger/calendar topbar | +| `{typography.date-rail}` | 48–96px | Instrument Serif | 400 | Date or date-range stacked at top of a surface | +| `{typography.ledger-title}` | 20–30px | Instrument Serif | 400 | Title cell inside a calendar/ledger row | +| `{typography.strand-title}` | 22–32px | Instrument Serif | 400 | Title inside a numbered strand/list row | +| `{typography.strand-num}` | 28–38px | Instrument Serif | 400 | Numeral cell inside a strand row | +| `{typography.body-lede}` | 15–18px | Archivo | 400 | Lede paragraph following a chapter headline | +| `{typography.body}` | 14–16px | Archivo | 400 | Standard body paragraph | +| `{typography.body-sm}` | 11–13px | Archivo | 400 | Footer-band body text, dense metadata | +| `{typography.micro-label}` | 11–14px | Archivo | 600 | Universal uppercase eyebrow label | +| `{typography.micro-label-tight}` | 10–12px | Archivo | 600 | Smaller uppercase label inside footer cells | +| `{typography.rail-label}` | 11–13px | Archivo | 600 | Vertical rotated rail label | +| `{typography.mono-data}` | 12–14px | JetBrains Mono | 400 | Chart year/value labels, mono inline data | +| `{typography.mono-date}` | 13–16px | JetBrains Mono | 400 | Date column in calendar ledgers | +| `{typography.pagenum}` | 11–13px | JetBrains Mono | 400 | Persistent page number | + +### Defaults + +- **Default size for a cover-scale display headline**: `{typography.display}` (120–240px clamp). Anything smaller reads as section-level, not cover-level. +- **Default size for a primary section headline**: `{typography.headline}` (40–88px clamp). +- **Default size for a chapter-divider numeral**: `{typography.numeral-jumbo}` (220–720px clamp). Don't shrink — the jumbo numeral is the point of a divider surface. +- **Default size for a hero statistic**: `{typography.numeral-md}` (72–144px clamp). Stat figures share the same serif as headlines — they are display moments, not data chrome. +- **Default size for a paragraph body**: `{typography.body}` (14–16px). For a lede after a chapter headline, step up to `{typography.body-lede}` (15–18px). +- **Default size for any eyebrow label**: `{typography.micro-label}` (11–14px) at weight 600, uppercase, 0.18em tracking. +- **Default weight for any Archivo body**: 400. Archivo body at any other weight breaks the rhythm. +- **Default weight for any micro-label**: 600. Labels at weight 400 or 700 read as either timid or oversized. +- **Default tracking for any uppercase label**: 0.16em minimum, 0.32em maximum. Labels without wide tracking read as code, not editorial. + +When unsure which display token to reach for, default to `{typography.headline}` (40–88px) for the primary moment, and `{typography.numeral-md}` (72–144px) for a single hero statistic. The display, display-sm, and display-md tokens are reserved for cover/colophon/poster-scale moments. + +### Signature Treatments + +These treatments are **non-optional whenever the corresponding element type is used**: + +- **Every display, numeral, headline, and ledger-title element is Instrument Serif at weight 400.** Bold serif display does not exist in this system — the face's contrast is its weight signal. Setting Instrument Serif at weight 700 collapses the entire elegance. +- **Every Instrument Serif display element uses tight line-height (0.84–1.06).** Generous line-height on display destroys the editorial poster feel — large serif headlines must feel stacked, not aerated. +- **Every Instrument Serif display element uses negative letter-spacing.** Display, headline, jumbo numerals at −0.018 to −0.04em; italic display at −0.005em. Without negative tracking, the wide-bodied glyphs read as untreated. +- **Every micro-label is uppercase Archivo weight 600 with tracking ≥ 0.16em.** No exceptions. A label without uppercase + tracking is not a label in this system; it's a stray sans element. +- **Every numerical metadata element (date, page number, chart value, calendar date) is JetBrains Mono.** Serif numerals are for display moments; mono numerals are for data chrome. Don't cross the line. +- **Every italic manifesto-scale quote uses `{typography.display-it}`.** Setting an italic quote at headline scale (40–88px) reads as a smaller moment; the italic is meant to dominate. +- **Every body paragraph is Archivo weight 400 with line-height ≥ 1.45.** Body in Instrument Serif does not exist — Instrument is for display only. + +### Typography Principles + +The voice contrast is **slow elegant serif ↔ wide-tracked uppercase sans ↔ tabular mono**. Italic Instrument is the system's "feeling" voice (reserved for quotes and manifesto moments); roman Instrument is the "statement" voice; Archivo upper-tracked is the "label" voice; mono is the "data" voice. Each has a single job. + +Mixing rules are tight: an `` inside an Instrument Serif headline stays in italic Instrument Serif (no face switch). An `` inside an Archivo body paragraph becomes italic Archivo, not a serif. Don't mix faces inline. + +Color is locked to ink on every element. There is no "accent color text" treatment in this system — accent is delivered through atmospheric blooms and panel fills, not text color. + +## Layout + +### Canvas System +The system targets `100vw × 100vh` per slide. Slides are absolutely positioned and crossfade via opacity transition (280ms ease). Only one slide is `.active` at a time. Every measurement uses CSS `clamp()` with both vw and vh terms — typography clamps include `min(...vw, ...vh)` patterns so display type scales by whichever viewport axis is shorter. + +### Padding and Margin Scale + +| Token | Range | Use | +|---|---|---| +| `{spacing.pad-edge}` | 40–76px | Standard edge padding from any slide edge to content | +| `{spacing.pad-region}` | 40–80px | Internal padding inside a flooded yellow panel or major region | +| `{spacing.pad-foot}` | 56–88px | Bottom padding when the footer band is present | +| `{spacing.gap-region}` | 20–48px | Gap between two major content columns/regions | +| `{spacing.gap-strand}` | 14–22px | Gap between strand rows in a numbered list | +| `{spacing.gap-footer-col}` | 20–44px | Gap between columns of the footer-band metadata strip | +| `{spacing.pagenum-bottom}` | 22–42px | Bottom inset of the persistent pagenum | +| `{spacing.pagenum-right}` | 24–48px | Right inset of the persistent pagenum | + +### Persistent Chrome +The **pagenum** is the only persistent on-canvas element. It appears at `bottom-right` of every slide in JetBrains Mono at 11–13px, color ink, opacity 0.75. A **nav-hint** (`← / → · space`) appears once, fixed to the bottom-left of the viewport in JetBrains Mono at 10–12px / opacity 0.4. The nav-hint is not part of the slide composition — it lives outside the `.stage`. + +### Edge Discipline +Every meaningful element respects a minimum 40px (mobile) to 76px (desktop) edge inset. The system's elegance depends on negative space at the edges — pushing content to the bleed (other than full-bleed panels, blooms, and tile blocks) breaks the catalogue feel. + +### Atmospheric Layer +Every slide may carry one or both atmospheric layers behind content: +- A **sun-bloom** (`{components.sun-bloom}`) — a large soft radial gradient of solar yellow, sized 42-70% of viewport, placed off-center or behind a focal element. +- An **ember-bloom** (`{components.ember-bloom}`) — a small warm peach radial gradient at 15-22% opacity, placed in a corner opposite the sun bloom. + +These layers are not optional decoration — they are the system's primary depth mechanism. A surface without a bloom reads as flat parchment. + +## Depth and Elevation + +### No Drop Shadows +The system has **zero drop shadows**. No `box-shadow`, no `text-shadow`, no `filter: drop-shadow(...)`. Depth is delivered atmospherically. + +### Atmospheric Depth (Sun Bloom) +The primary depth mechanism is the **sun-bloom** — a large soft radial gradient of solar yellow blooming from a point on the canvas. Bloom anatomy is a layered radial gradient with three or four color stops: +- 0%: `{colors.sun}` at 70-95% opacity (the hot core) +- ~30-40%: `{colors.sun}` at 40-65% opacity (the bloom) +- ~55-65%: `{colors.haze}` at 18-22% opacity (the soft extension) +- 80-90%: `{colors.paper}` at 0% (smooth fade into ground) + +Bloom size and position varies by surface need: cover surfaces use a centered or slightly-off-center bloom 42% × 38% of viewport; chapter surfaces use a corner-anchored 720px-radius bloom; closing surfaces use a bottom-anchored 55% × 50% bloom rising from below. + +### Counter-Temperature Accent (Ember Bloom) +An optional **ember-bloom** in a corner opposite the sun-bloom provides warm-cool color tension without raising the saturation of the canvas. Always at 15-22% opacity, always smaller than the sun-bloom, always subordinate. + +### Geometric Underprint (Block Tiles) +On cover and colophon surfaces, an additional **block-tile** layer can appear behind content — translucent solar yellow rectangles placed on an 8-row × 4-column grid system at 40-70% opacity. This layer suggests a layered poster underprint without committing to a solid panel. The tiles are decorative geometry, not active content regions. + +### Yellow Panel (Structural Color) +For surfaces that need the strongest possible color statement, a **yellow-panel** flood (`{components.yellow-panel}`) covers a column, half, or third of the canvas in saturated `{colors.sun}`. This is the only "hard" color treatment in the system — when a panel is used, ink text sits on top at full opacity. Panels do not have borders or shadows; they meet the paper edge or another panel edge directly. + +### Hairline Rules +Internal structural depth is delivered by **1px solid ink hairline rules** separating header bands from content, ledger rows from each other, and footer columns from each other. Rules are never thicker than 1px. Between secondary list rows (e.g., strand separators), the rule drops to `rgba(27, 37, 102, 0.18-0.2)` — same color, lower opacity. + +## Shapes and Treatment + +### Border Radius +**Zero, on everything.** Every shape is a strict rectangle. The radial blooms are technically circles but they have no visible edge — they fade into paper. + +### Border Weights +- **1px solid `{colors.ink}`** — the universal rule. Used for header-band underlines, ledger row separators, footer-column tops, and the bordered chart bar accent on the lit row. +- **1px solid `rgba(27, 37, 102, 0.18-0.2)`** — soft variant of the same rule. Used for secondary row separators inside dense lists where full-weight ink would feel heavy. + +The system has **no thicker borders**. There are no 2px, 3px, or 4px outlines anywhere. The visual structure depends on the lightness of the hairline. + +### Decorative Element Types + +**Sun-bloom** — Large soft radial gradient of solar yellow placed off-center or behind a focal element. The system's primary depth mechanism. Always one per surface, sometimes paired with a counter-bloom. + +**Ember-bloom** — Small warm peach radial gradient at 15-22% opacity, placed in a corner opposite the sun-bloom. Subordinate atmospheric balance. + +**Block-tile underprint** — Translucent solar yellow rectangles placed on an 8×4 grid system. Decorative geometry suggesting a layered poster, used on cover and colophon-type surfaces. + +**Yellow panel** — A full-bleed column, half, or third of the canvas flooded with `{colors.sun}`. The system's strongest color statement. Carries ink text on top. + +**Hairline rule** — 1px solid ink. Used for header-band underlines, ledger separators, footer column tops. The system's only border. + +**Footer band** — A four-column metadata strip at the bottom of cover/colophon surfaces. Each cell has a `{components.hairline-rule}` top border, an Archivo micro-label, and a short body statement. + +**Strand row** — Numbered editorial list row with serif numeral cell + serif title + sans body, separated from the next row by a hairline-soft rule. + +**Ledger row** — Four-column tabular calendar/itinerary row: mono date + serif title + sans venue + mono duration (right-aligned), separated by hairline-soft rules. + +**Vertical rail label** — Rotated Archivo uppercase text running up the left edge of a chapter-divider surface, with 0.32em tracking. + +**Date rail** — Large serif date or date-range stacked at top-right of cover surfaces, often using an en-dash to indicate a span across years or months. + +**Jumbo numeral** — A single huge Instrument Serif numeral (220-720px) dominating a divider surface. Always serif, always at weight 400, always with tight line-height. + +**Chart bar** — A solid ink rectangle whose width carries the data value. The featured/current bar swaps to yellow fill with a 1px ink stroke (`{components.bar-lit}`). Chart layouts use grid-row patterns: mono year label + bar + mono value, separated by gap. + +## Do's and Don'ts + +### Do + +- Apply `{colors.paper}` as the universal background. Every surface starts on parchment. +- Set every line of text in `{colors.ink}` — display, body, micro-label, mono, everything. The single text color is non-negotiable. +- Use Instrument Serif at weight 400 with tight line-height (0.84-1.06) and negative letter-spacing (-0.018 to -0.04em) for every display moment. The serif's elegance lives in this configuration. +- Add at least one `{components.sun-bloom}` to every surface. Atmospheric depth is the system's depth mechanism; a flat parchment surface reads as broken. +- Pair a sun-bloom with an `{components.ember-bloom}` in the opposite corner when you want warm-cool tension without raising the overall saturation. +- Use `{components.hairline-rule}` (1px solid ink) for every structural separator: header-band underline, ledger row, footer column, strand separator. +- Set every uppercase label in Archivo weight 600 with 0.16-0.32em tracking. Without the wide tracking, labels read as code, not editorial. +- Use `{components.yellow-panel}` (full-bleed sun column or panel) when a surface needs strongest color commitment — keep ink text on top at full opacity. +- Place the persistent `{components.pagenum}` (JetBrains Mono, 75% opacity ink) at bottom-right of every surface. +- Reserve JetBrains Mono exclusively for numerical and metadata callouts: dates, ledger figures, chart values, page numbers, nav-hint. Never use mono for display or body. + +### Don't + +- Don't add drop shadows. The system has zero box-shadows and zero text-shadows. Adding any blurred or offset shadow breaks the printed-paper feel immediately. +- Don't round any corner. Every shape is strict rectangle. Border-radius is forbidden. +- Don't use borders thicker than 1px. The hairline rule is the only border vocabulary; 2px, 3px, or 4px outlines do not exist. +- Don't set Instrument Serif at weight 700 or any bold weight. The serif's character lives at weight 400; bold serif display flattens the system. +- Don't introduce a second text color. Yellow text on paper, ember text anywhere, or muted-ink secondary text — none exist. Text is always full-opacity ink. +- Don't crowd the canvas with cards or panels. The system reads as elegant when sparse. Bordered cards, button stacks, or multi-region grids of containers break the editorial restraint. +- Don't invert: ink panels with yellow or paper text are not part of the system. Ink ground is reserved for chart bars and small rule elements only. +- Don't substitute Inter, Helvetica, or system-ui for Archivo, or Times for Instrument Serif. The font selection is the visual identity; substitution collapses the aesthetic. +- Don't use mono for body or headlines. JetBrains Mono is exclusively for numerical/metadata chrome. +- Don't omit the bloom layer on a surface. A flat parchment slide reads as a CMS template; the bloom is the atmosphere that signals "biennale". + +## Responsive Behavior + +This system is built as a **viewport-fluid 100vw × 100vh deck** with no responsive breakpoints. Every font size, padding value, and gap uses CSS `clamp()` with both vw and vh terms — `clamp(40px, min(4.4vw, 7vh), 88px)` is a typical pattern. Display type scales by whichever viewport axis is shorter, so portrait orientations don't blow out the headlines. + +### Scaling Behavior +- Cover-scale display scales 120px → 240px. +- Chapter-divider jumbo numeral scales 220px → 720px. +- Headline scales 40px → 88px. +- Body scales 14px → 16px. +- Edge padding scales 40px → 76px. +- Hairline rule (1px) and pagenum sizing (11-13px) are essentially fixed. + +### Presenter Behavior +- Slides advance via `ArrowRight`, `PageDown`, or `Space`. +- Slides reverse via `ArrowLeft` or `PageUp`. +- `Home` jumps to first slide, `End` to last. +- Horizontal touch swipe with a 40px threshold advances/reverses. +- Slide crossfades at 280ms ease via `opacity` toggle on the `.active` class. Only the active slide is `pointer-events: auto`. + +### Print Behavior +The system has no `@media print` rule. The crossfade transition is screen-only. For static export, capturing each slide individually via screenshot preserves all atmospheric layers (the radial blooms are pure CSS gradients, not assets). + +### Mobile Behavior +The `min(vw, vh)` pattern in display clamps means narrow portrait viewports automatically shrink display type to fit. The strand and ledger rows use fixed-px first columns (56px, 92px) that may feel tight on narrow widths — the system is designed for landscape presentation contexts and is functional but not optimized for sub-768px portrait usage. + +## CJK & International Content + +When using this template for Chinese (or other CJK) content, swap the Latin typeface stack for an equivalent Chinese pairing and apply universal CJK adjustments. All recommended Chinese fonts load via CDN — no install required. + +### Recommended Chinese Pairing + +| Role | Latin (default) | Chinese counterpart | +|---|---|---| +| Display / numerals / headlines / date rail | Instrument Serif 400 | 得意黑 Smiley Sans (oblique) — display moments; 思源宋体 Noto Serif SC 400 as fallback for long-form serif headlines | +| Body / lede / micro-label | Archivo 400–600 | 思源宋体 Noto Serif SC 400 for body; 思源黑体 Noto Sans SC 600 for micro-labels | +| Mono data / dates / page numbers | JetBrains Mono 400 | 思源黑体 Noto Sans SC 500 with tabular-feeling alignment — see Known CJK Gap below | + +### Mixed-Content Strategy + +**Strategy A** — single CJK family per role, with Latin glyphs handled by the same CJK family. Both 思源宋体 and 思源黑体 ship Latin glyphs that read cleanly alongside Chinese characters, so a mixed sentence renders in a consistent face. 得意黑 is used surgically — only on the biggest display moments where its slight oblique slant matches the Italian-poster register Instrument Serif provides in the Latin original. For everything else (body, micro-label, mono), Noto Serif SC / Noto Sans SC carries both scripts. + +### Loading + +Add to the template's ``: + +```html + + + + +``` + +After loading, reference 得意黑 as `font-family: 'Smiley Sans Oblique', 'Noto Serif SC', serif` on the display tokens that should carry the strongest poster register. + +### Universal CJK Adjustments + +- **Line-height**: increase by ~15–25% from the Latin spec. Body 1.75–1.85 (up from 1.5–1.55), display 1.05–1.15 (up from the very tight 0.84–0.96 used on Instrument Serif). The Latin display tokens here use line-height as low as 0.84 — at that compression, CJK characters collide vertically. Open display to a minimum of 1.0 for Chinese, and 1.15+ on multi-line headlines. +- **Letter-spacing**: set to 0 on every CJK run. The Latin display tokens use negative tracking from −0.005em down to −0.04em; on square CJK glyphs this overlaps strokes and reads as broken. Micro-labels at 0.16–0.32em wide tracking also drop to 0. +- **Text transform**: don't apply `uppercase` to Chinese text — CJK has no case. Every micro-label and rail-label in this system uses `text-transform: uppercase`; remove it for CJK runs. +- **Punctuation**: use full-width Chinese punctuation (,。:;!?「」()). Replace the en-dash separator in date ranges with a Chinese 至 or full-width 「—」 hyphen. +- **No period on display headlines**: Chinese typography convention omits trailing 。 on display-scale headlines. +- **Space between CJK and Latin (盘古之白)**: insert an ASCII space between every Chinese character and adjacent Latin character or digit. Write `2024 春季双年展` not `2024春季双年展`. +- **One font per sentence**: 思源宋体 covers both CJK and Latin glyphs in a unified serif style — let it handle mixed editorial sentences. Don't let the browser font-switch to Archivo mid-paragraph. + +### Aesthetic Notes for This System + +The system's editorial identity rests on Instrument Serif's high-contrast, tall-ascender personality — a face that signals "art biennale catalogue" and "slow literary quarterly". The closest Chinese equivalent for register is **思源宋体 Noto Serif SC** for body and editorial display, with **得意黑 Smiley Sans Oblique** reserved for the poster-scale display moments where Instrument Serif at 120–240px does the heaviest identity work in the Latin original. 得意黑's slight italic tilt and slab character matches the Italian-exhibition-poster register; pure Noto Serif SC at jumbo numerals reads as restrained academic Chinese rather than biennale-loud. + +The "single text color, single accent" discipline of this system transfers cleanly to CJK — ink-on-paper, sun-bloom atmosphere, hairline rules, no shadows. The micro-label treatment (Archivo weight 600, uppercase, 0.16–0.32em tracking) is the system's most fragile element when translated: CJK micro-labels lose both the uppercase signal and the wide tracking. Compensate by setting Chinese micro-labels in 思源黑体 weight 600 at 0 tracking with the **slightly heavier weight contrast** (drop body to weight 400 of 思源宋体, keep labels at 600 of 思源黑体) and by **always pairing the label with a hairline-soft rule beneath** — the rule does the chrome-recognition work the wide-tracked uppercase did in Latin. + +### Known CJK Gap + +- **No CDN-loadable Chinese monospace face for tabular data.** JetBrains Mono's role here (calendar ledger dates, chart year/value labels, page numbers) depends on monospaced figure rhythm that CJK doesn't provide. 思源黑体 at weight 500 with `font-feature-settings: "tnum"` gives tabular Latin digits but Chinese characters remain proportional. For ledger rows where alignment is structural, keep the date and value columns in Latin digits (Arabic numerals + Latin date abbreviations) and use 思源黑体 only for the title/venue cells. +- **Instrument Serif italic has no direct Chinese counterpart.** The italic display token (manifesto-scale quote body) loses its slow-reading personality entirely in CJK. Use 思源宋体 400 with looser line-height (1.4) and slightly larger size to compensate; consider 「」 quotation framing to signal "this is a quoted passage". +- **得意黑 may not load on restricted networks.** The cn-fontsource CDN is reliable in mainland China but less proven internationally. Always include `'Noto Serif SC', serif` in the stack as fallback so display headlines remain editorial even when 得意黑 fails. + +## Iteration Guide + +1. Any new surface starts on `{colors.paper}`, places at least one `{components.sun-bloom}` for atmosphere, and pins the persistent `{components.pagenum}` to bottom-right. +2. Any new headline uses Instrument Serif weight 400 with tight line-height and negative tracking. Reach for `{typography.headline}` for primary moments and `{typography.display}` only for cover-scale. +3. Any new body paragraph uses Archivo weight 400 with line-height 1.5. Lede paragraphs following a headline use the slightly larger `{typography.body-lede}` for breathing room. +4. Any new eyebrow or section tag uses the micro-label treatment: Archivo weight 600, uppercase, 0.16-0.32em tracking, ink color, no fill. Don't substitute a pill or chip. +5. Any new structural separator is a 1px `{components.hairline-rule}` in ink, or its soft variant for secondary list rows. Never reach for a thicker border. +6. Any new numerical or metadata content (date, page number, chart value, ledger figure) uses JetBrains Mono. Serif numerals are reserved for display moments only. +7. Any new "poster-scale" color statement uses `{components.yellow-panel}` — a flooded column or fraction of the canvas in `{colors.sun}` with ink text on top. +8. Any new ordered list of program items uses the `{components.strand-row}` pattern: serif numeral cell + serif title + sans body, separated by hairline-soft rule. +9. Any new tabular itinerary uses the `{components.ledger-row}` pattern: mono date + serif title + sans venue + mono duration right-aligned, separated by hairline-soft rule. +10. If a surface feels flat, add an `{components.ember-bloom}` in the opposite corner from the sun-bloom — never add a card border or shadow. + +## Known Gaps + +- **Instrument Serif, Archivo, and JetBrains Mono are loaded from Google Fonts** via a preconnect + ``. Fallbacks (`Georgia`, `Helvetica Neue`, `ui-monospace`) are defined but render very differently — in environments where Google Fonts fail, the system collapses to generic editorial defaults and loses its identity. +- **The Instrument Serif italic axis is loaded** but used only for the manifesto-scale quote treatment. Other italic moments (an `` inside a body paragraph, for instance) will not stylistically signal the same as the dedicated italic display. +- **The system has no chart engine** — the data slide uses inline `style="width: XX%"` on bar divs. Building dynamic charts requires computing widths in JS or templating the markup server-side. +- **The block-tile underprint uses hardcoded grid positions** (`grid-column: 1 / 3; grid-row: 6 / 9;`) per tile. Tiles are decorative and the placements are tuned per surface; there is no parametric tile placement system. +- **The vertical rail-label uses a rotated transform** that can produce subtle subpixel rendering artifacts on some browsers. The label is decorative; if rendering looks off, it can safely be dropped. +- **The slide navigation has no slide indicator beyond the pagenum.** There are no dot-rails, no progress bar, no thumbnail bar. The pagenum text is the only positional cue. +- **The crossfade transition is screen-only** and doesn't degrade to a sensible print/static state. Capturing slides for PDF export requires manual screenshot per surface. +- **The cover and colophon footer-band columns use fractional widths** (`1.1fr 1fr 1.4fr 2fr` and `1.2fr 1.1fr 1fr 1.4fr`). These ratios are tuned to the demo content and may need adjusting if footer cells carry significantly different text length. +- **The system loads Google Fonts with `ital` axis for Instrument Serif** but only `wght` axes for Archivo and JetBrains Mono. Adding italic body or italic mono moments requires updating the font-loading request. diff --git a/desktop/design-templates/biennale-yellow/artifact.json b/desktop/design-templates/biennale-yellow/artifact.json new file mode 100644 index 00000000..c810ba75 --- /dev/null +++ b/desktop/design-templates/biennale-yellow/artifact.json @@ -0,0 +1,17 @@ +{ + "version": 1, + "id": "9d5984b0-c687-4845-a1cc-3362584e3c8a", + "kind": "deck", + "title": "Biennale Yellow", + "entry": "index.html", + "slides": [ + "cover", + "manifesto", + "programme", + "chapter", + "data", + "quote", + "cal", + "colophon" + ] +} diff --git a/desktop/design-templates/biennale-yellow/deck.css b/desktop/design-templates/biennale-yellow/deck.css new file mode 100644 index 00000000..80fe8b80 --- /dev/null +++ b/desktop/design-templates/biennale-yellow/deck.css @@ -0,0 +1,476 @@ +@import url("https://fonts.googleapis.com/css2?family=Instrument+Serif:ital@0;1&family=Archivo:wght@400;500;600;700&family=JetBrains+Mono:wght@400;500&display=swap"); + +:root { + --paper: #E9E5DB; + --paper-deep: #DCD6C4; + --sun: #F1EE2E; + --sun-soft: #F8F39B; + --ink: #1B2566; + --ember: #E26B4A; + --haze: #F0DA7C; + --line: #1B2566; +} + +.slide, .slide *, .slide *::before, .slide *::after { box-sizing: border-box; } + +.slide { + font-family: 'Archivo', 'Helvetica Neue', sans-serif; + color: var(--ink); + background: var(--paper); + -webkit-font-smoothing: antialiased; +} + +.display { font-family: 'Instrument Serif', Georgia, serif; font-weight: 400; line-height: 0.9; letter-spacing: -0.012em; } +.display-it { font-family: 'Instrument Serif', Georgia, serif; font-weight: 400; line-height: 1.04; letter-spacing: -0.005em; } +.micro-label { font-family: 'Archivo', sans-serif; font-weight: 600; text-transform: uppercase; letter-spacing: 0.18em; } +.body-text { font-family: 'Archivo', sans-serif; font-weight: 400; line-height: 1.5; } +.mono-tab { font-family: 'JetBrains Mono', ui-monospace, monospace; font-weight: 400; } + +.pagenum { + position: absolute; + right: 48px; + bottom: 44px; + font-family: 'JetBrains Mono', ui-monospace, monospace; + font-size: 22px; + color: var(--ink); + letter-spacing: 0.08em; + z-index: 8; + opacity: 0.75; +} + +.pagenum::after { + content: counter(dc-slide, decimal-leading-zero) " / " counter(dc-slides, decimal-leading-zero); +} + +.s-cover { background: var(--paper); } + +.s-cover .blocks { + position: absolute; inset: 0; + pointer-events: none; + display: grid; + grid-template-columns: 1fr 1fr 1fr 1fr; + grid-template-rows: repeat(8, 1fr); +} +.s-cover .blocks div { background: transparent; } +.s-cover .blocks .b1 { background: rgba(241,238,46,0.55); grid-column: 1; grid-row: 3 / 6; } +.s-cover .blocks .b2 { background: rgba(241,238,46,0.4); grid-column: 4; grid-row: 1 / 4; } +.s-cover .blocks .b3 { background: rgba(241,238,46,0.7); grid-column: 1 / 3; grid-row: 6 / 9; } +.s-cover .blocks .b4 { background: rgba(241,238,46,0.45); grid-column: 3 / 5; grid-row: 6 / 8; } + +.s-cover .sunglow { + position: absolute; inset: 0; pointer-events: none; + background: + radial-gradient(ellipse 42% 38% at 52% 42%, rgba(241,238,46,0.95) 0%, rgba(241,238,46,0.65) 38%, rgba(240,218,124,0.22) 65%, rgba(233,229,219,0) 88%), + radial-gradient(ellipse 28% 30% at 88% 16%, rgba(226,107,74,0.22) 0%, rgba(226,107,74,0) 70%); +} + +.s-cover .date-rail { + position: absolute; + top: 56px; + right: 80px; + font-family: 'Instrument Serif', Georgia, serif; + font-size: 97px; + color: var(--ink); + line-height: 0.96; + text-align: right; + letter-spacing: -0.005em; + z-index: 5; +} + +.s-cover .titlewrap { + position: absolute; + left: 80px; + bottom: 264px; + z-index: 5; + max-width: 88%; +} +.s-cover .title { + font-family: 'Instrument Serif', Georgia, serif; + font-size: 240px; + line-height: 0.86; + color: var(--ink); + letter-spacing: -0.018em; +} +.s-cover .title em { } +.s-cover .subline { + margin-top: 16px; + font-family: 'Archivo', sans-serif; + font-weight: 600; + text-transform: uppercase; + letter-spacing: 0.18em; + font-size: 22px; + color: var(--ink); +} + +.s-cover .footer-row { + position: absolute; + left: 80px; + right: 80px; + bottom: 56px; + display: grid; + grid-template-columns: 1.1fr 1fr 1.4fr 2fr; + gap: 46px; + z-index: 5; +} +.s-cover .footer-row > div { + border-top: 2px solid var(--ink); + padding-top: 20px; +} +.s-cover .footer-row .ftag { + text-transform: uppercase; letter-spacing: 0.16em; font-weight: 600; + font-size: 20px; + margin-bottom: 12px; +} +.s-cover .footer-row .ftxt { + font-family: 'Archivo', sans-serif; + font-size: 24px; + line-height: 1.45; +} +.s-cover .footer-row .fdesc { + font-family: 'Archivo', sans-serif; + font-size: 24px; + line-height: 1.5; + color: var(--ink); +} + +.s-manifesto { background: var(--paper); display: flex; align-items: center; justify-content: center; } +.s-manifesto .haze { + position: absolute; inset: 0; pointer-events: none; + background: + radial-gradient(ellipse 70% 60% at 50% 50%, rgba(241,238,46,0.7) 0%, rgba(248,243,155,0.42) 32%, rgba(240,218,124,0.18) 56%, rgba(233,229,219,0) 80%), + radial-gradient(circle 1200px at 12% 88%, rgba(226,107,74,0.15) 0%, rgba(226,107,74,0) 70%); +} +.s-manifesto .quote { + position: relative; z-index: 4; + max-width: min(86%, 2960px); + padding: 0 115px; + font-family: 'Instrument Serif', Georgia, serif; + + font-weight: 400; + font-size: 119px; + line-height: 1.04; + color: var(--ink); + letter-spacing: -0.005em; + text-align: left; +} +.s-manifesto .attr { + position: absolute; + left: 80px; + bottom: 112px; + font-family: 'Archivo', sans-serif; + font-weight: 600; + text-transform: uppercase; + letter-spacing: 0.2em; + font-size: 22px; + color: var(--ink); + z-index: 4; +} + +.s-programme { background: var(--paper); display: grid; grid-template-columns: 1fr 1fr; grid-template-rows: minmax(0, 1fr); } +.s-programme .left { + background: var(--sun); + position: relative; + padding: 81px; + display: flex; flex-direction: column; justify-content: space-between; +} +.s-programme .left .kicker { + font-family: 'Archivo', sans-serif; + font-weight: 600; text-transform: uppercase; letter-spacing: 0.2em; + font-size: 22px; + color: var(--ink); +} +.s-programme .left .word { + font-family: 'Instrument Serif', Georgia, serif; + font-size: 220px; + line-height: 0.86; + color: var(--ink); + letter-spacing: -0.018em; +} +.s-programme .left .meta { + font-family: 'Archivo', sans-serif; + font-size: 26px; + line-height: 1.5; + max-width: 88%; + color: var(--ink); +} +.s-programme .right { + background: var(--paper); + position: relative; + padding: 64px 81px 88px; + display: flex; flex-direction: column; gap: 32px; +} +.s-programme .right .head { + font-family: 'Archivo', sans-serif; + font-weight: 600; text-transform: uppercase; letter-spacing: 0.18em; + font-size: 22px; + border-bottom: 2px solid var(--ink); + padding-bottom: 28px; +} +.s-programme .strands { + display: flex; flex-direction: column; + gap: 20px; +} +.s-programme .strand { + display: grid; + grid-template-columns: 112px 1fr; + gap: 28px; + border-bottom: 2px solid rgba(27,37,102,0.18); + padding-bottom: 18px; +} +.s-programme .strand .num { + font-family: 'Instrument Serif', Georgia, serif; + font-size: 56px; + color: var(--ink); + line-height: 1; +} +.s-programme .strand h3 { + margin: 0 0 8px 0; + font-family: 'Instrument Serif', Georgia, serif; + font-weight: 400; + font-size: 44px; + line-height: 1.1; + color: var(--ink); +} +.s-programme .strand p { + margin: 0; + font-family: 'Archivo', sans-serif; + font-size: 24px; + line-height: 1.5; + color: var(--ink); + max-width: 92%; +} + +.s-chapter { background: var(--paper); } +.s-chapter .glow { + position: absolute; inset: 0; pointer-events: none; + background: + radial-gradient(circle 1440px at -10% -10%, rgba(241,238,46,0.7) 0%, rgba(241,238,46,0) 65%), + radial-gradient(circle 1080px at 110% 110%, rgba(226,107,74,0.18) 0%, rgba(226,107,74,0) 70%); +} +.s-chapter .vrail { + position: absolute; + left: 92px; + top: 50%; + transform: translate(-50%, -50%) rotate(-90deg); + font-family: 'Archivo', sans-serif; + font-weight: 600; + text-transform: uppercase; + letter-spacing: 0.32em; + font-size: 22px; + color: var(--ink); + white-space: nowrap; + z-index: 4; +} +.s-chapter .stack { + position: absolute; + left: 240px; + top: 80px; + bottom: 160px; + right: 80px; + display: flex; flex-direction: column; justify-content: center; + z-index: 4; +} +.s-chapter .nm { + font-family: 'Instrument Serif', Georgia, serif; + font-size: 538px; + line-height: 0.84; + color: var(--ink); + letter-spacing: -0.04em; +} +.s-chapter .ttl { + margin-top: 24px; + font-family: 'Instrument Serif', Georgia, serif; + + font-size: 80px; + line-height: 1.05; + color: var(--ink); + max-width: 78%; +} +.s-chapter .lede { + margin-top: 36px; + font-family: 'Archivo', sans-serif; + font-size: 30px; + line-height: 1.55; + color: var(--ink); + max-width: 56ch; +} + +.s-data { background: var(--paper); } +.s-data .glow { + position: absolute; inset: 0; pointer-events: none; + background: radial-gradient(ellipse 50% 40% at 92% 8%, rgba(241,238,46,0.55) 0%, rgba(241,238,46,0) 70%); +} +.s-data .frame { + position: absolute; inset: 80px 80px 140px; + display: grid; + grid-template-columns: 1fr 1.4fr; + grid-template-rows: auto 1fr; + gap: 48px; + z-index: 4; +} +.s-data .head { grid-column: 1 / 3; display: flex; align-items: end; justify-content: space-between; gap: 64px; border-bottom: 2px solid var(--ink); padding-bottom: 28px; } +.s-data .head .lab { font-family: 'Archivo', sans-serif; font-weight: 600; text-transform: uppercase; letter-spacing: 0.2em; font-size: 22px; color: var(--ink); } +.s-data .head .h { font-family: 'Instrument Serif', Georgia, serif; font-size: 65px; line-height: 1; color: var(--ink); } + +.s-data .col-a { display: flex; flex-direction: column; justify-content: center; gap: 36px; } +.s-data .stat { display: flex; flex-direction: column; gap: 8px; } +.s-data .stat .v { font-family: 'Instrument Serif', Georgia, serif; font-size: 144px; line-height: 0.92; color: var(--ink); letter-spacing: -0.01em; } +.s-data .stat .v sup { font-size: 0.42em; vertical-align: super; opacity: 0.7; } +.s-data .stat .lab2 { font-family: 'Archivo', sans-serif; font-weight: 500; text-transform: uppercase; letter-spacing: 0.18em; font-size: 22px; color: var(--ink); } +.s-data .stat .desc { font-family: 'Archivo', sans-serif; font-size: 28px; line-height: 1.45; color: var(--ink); max-width: 32ch; margin-top: 8px; } + +.s-data .chart { display: flex; flex-direction: column; gap: 16px; justify-content: center; } +.s-data .row { display: grid; grid-template-columns: 128px 1fr 160px; align-items: center; gap: 24px; } +.s-data .row .yr { font-family: 'JetBrains Mono', ui-monospace, monospace; font-size: 24px; color: var(--ink); letter-spacing: 0.04em; } +.s-data .row .val { font-family: 'JetBrains Mono', ui-monospace, monospace; font-size: 24px; color: var(--ink); text-align: right; letter-spacing: 0.02em; } +.s-data .bar { height: 28px; background: var(--ink); position: relative; } +.s-data .bar.lit { background: var(--sun); border: 2px solid var(--ink); } + +.s-quote { background: var(--paper); } +.s-quote .yblock { + position: absolute; + right: 0; top: 0; bottom: 0; + width: 32%; + background: var(--sun); +} +.s-quote .glow { + position: absolute; inset: 0; pointer-events: none; + background: radial-gradient(circle 1200px at 8% 92%, rgba(241,238,46,0.4) 0%, rgba(241,238,46,0) 70%); +} +.s-quote .qwrap { + position: absolute; + left: 80px; + right: 36%; + top: 50%; + transform: translateY(-50%); + z-index: 4; +} +.s-quote .qkicker { + font-family: 'Archivo', sans-serif; font-weight: 600; + text-transform: uppercase; letter-spacing: 0.22em; + font-size: 22px; + color: var(--ink); + margin-bottom: 28px; +} +.s-quote .qbody { + font-family: 'Instrument Serif', Georgia, serif; + + font-size: 80px; + line-height: 1.06; + color: var(--ink); + letter-spacing: -0.005em; +} +.s-quote .qattr { + margin-top: 40px; + display: grid; + grid-template-columns: auto 1fr; + gap: 28px; + align-items: end; + border-top: 2px solid var(--ink); + padding-top: 20px; +} +.s-quote .qattr .who { font-family: 'Archivo', sans-serif; font-weight: 600; text-transform: uppercase; letter-spacing: 0.16em; font-size: 22px; color: var(--ink); } +.s-quote .qattr .role { font-family: 'Archivo', sans-serif; font-size: 24px; color: var(--ink); opacity: 0.75; } +.s-quote .y-mark { + position: absolute; + right: 80px; + bottom: 140px; + font-family: 'Instrument Serif', Georgia, serif; + font-size: 240px; + line-height: 0.9; + color: var(--ink); + letter-spacing: -0.04em; + z-index: 4; +} + +.s-cal { background: var(--paper); } +.s-cal .glow { + position: absolute; inset: 0; pointer-events: none; + background: radial-gradient(circle 1400px at 105% 0%, rgba(241,238,46,0.45) 0%, rgba(241,238,46,0) 65%); +} +.s-cal .frame { + position: absolute; + inset: 80px 80px 140px; + display: flex; flex-direction: column; + z-index: 4; +} +.s-cal .frame .topbar { + display: flex; align-items: end; justify-content: space-between; + border-bottom: 2px solid var(--ink); + padding-bottom: 24px; + margin-bottom: 32px; +} +.s-cal .frame .topbar .h { + font-family: 'Instrument Serif', Georgia, serif; + font-size: 80px; + line-height: 1; + color: var(--ink); +} +.s-cal .frame .topbar .lab { font-family: 'Archivo', sans-serif; font-weight: 600; text-transform: uppercase; letter-spacing: 0.2em; font-size: 22px; color: var(--ink); } +.s-cal .ledger { flex: 1; display: flex; flex-direction: column; gap: 0; } +.s-cal .row { + display: grid; + grid-template-columns: 184px 1.6fr 0.9fr 160px; + gap: 28px; + align-items: center; + padding: 20px 0; + border-bottom: 2px solid rgba(27,37,102,0.2); +} +.s-cal .row .date { font-family: 'JetBrains Mono', ui-monospace, monospace; font-size: 26px; color: var(--ink); letter-spacing: 0.02em; } +.s-cal .row .ttl { font-family: 'Instrument Serif', Georgia, serif; font-size: 40px; line-height: 1.15; color: var(--ink); } +.s-cal .row .ttl em { } +.s-cal .row .ven { font-family: 'Archivo', sans-serif; font-size: 28px; color: var(--ink); } +.s-cal .row .dur { font-family: 'JetBrains Mono', ui-monospace, monospace; font-size: 24px; color: var(--ink); text-align: right; letter-spacing: 0.04em; opacity: 0.78; } +.s-cal .row.headrow { border-bottom: 2px solid var(--ink); padding-bottom: 16px; } +.s-cal .row.headrow > div { font-family: 'Archivo', sans-serif; font-weight: 600; text-transform: uppercase; letter-spacing: 0.18em; font-size: 20px; color: var(--ink); } + +.s-colophon { background: var(--paper); } +.s-colophon .glow { + position: absolute; inset: 0; pointer-events: none; + background: + radial-gradient(ellipse 55% 50% at 50% 110%, rgba(241,238,46,0.85) 0%, rgba(241,238,46,0.5) 35%, rgba(240,218,124,0.18) 60%, rgba(233,229,219,0) 84%), + radial-gradient(ellipse 30% 30% at 12% 18%, rgba(226,107,74,0.18) 0%, rgba(226,107,74,0) 70%); +} +.s-colophon .blocks { + position: absolute; inset: 0; + pointer-events: none; + display: grid; grid-template-columns: 1fr 1fr 1fr 1fr; grid-template-rows: repeat(8, 1fr); +} +.s-colophon .blocks .b1 { background: rgba(241,238,46,0.55); grid-column: 1 / 3; grid-row: 1 / 3; } +.s-colophon .blocks .b2 { background: rgba(241,238,46,0.4); grid-column: 4; grid-row: 5 / 8; } +.s-colophon .titlewrap { + position: absolute; + left: 80px; + top: 72px; + z-index: 5; + max-width: 92%; +} +.s-colophon .ktag { + font-family: 'Archivo', sans-serif; font-weight: 600; text-transform: uppercase; + letter-spacing: 0.22em; font-size: 22px; color: var(--ink); margin-bottom: 24px; +} +.s-colophon .ttl { + font-family: 'Instrument Serif', Georgia, serif; + font-size: 173px; + line-height: 0.86; + color: var(--ink); + letter-spacing: -0.018em; +} +.s-colophon .ttl em { } + +.s-colophon .colofo { + position: absolute; + left: 80px; + bottom: 140px; + right: 80px; + display: grid; + grid-template-columns: 1.2fr 1.1fr 1fr 1.4fr; + gap: 46px; + z-index: 5; +} +.s-colophon .colofo > div { + border-top: 2px solid var(--ink); + padding-top: 20px; +} +.s-colophon .colofo .ftag { text-transform: uppercase; letter-spacing: 0.16em; font-weight: 600; font-size: 20px; margin-bottom: 12px; color: var(--ink); } +.s-colophon .colofo .ftxt { font-family: 'Archivo', sans-serif; font-size: 24px; line-height: 1.5; color: var(--ink); } diff --git a/desktop/design-templates/biennale-yellow/index.html b/desktop/design-templates/biennale-yellow/index.html new file mode 100644 index 00000000..03f45ca7 --- /dev/null +++ b/desktop/design-templates/biennale-yellow/index.html @@ -0,0 +1,10 @@ + + + + +Deck + + + + + diff --git a/desktop/design-templates/biennale-yellow/slides/cal.html b/desktop/design-templates/biennale-yellow/slides/cal.html new file mode 100644 index 00000000..e25ac344 --- /dev/null +++ b/desktop/design-templates/biennale-yellow/slides/cal.html @@ -0,0 +1,61 @@ +
+ +
+
+
Public calendar
+
Selected dates · May—October
+
+
+
Date
Title
Venue
Length
+
+
02.05
+
The Long Yellow, opening lecture
+
Pavilion of Quiet Form, Rotterdam
+
90 min
+
+
+
17.05
+
A walk through the season's first room
+
Reading Garden, Pavilion North
+
2 hr
+
+
+
06.06
+
Public Form 01 — opening
+
Square of the Slow Sun, Antwerp
+
All day
+
+
+
28.06
+
Field Notes residency, week one supper
+
House of the Half Window
+
3 hr
+
+
+
19.07
+
A Letter to the Sun, evening reading
+
Aurora Library, room 3
+
75 min
+
+
+
14.08
+
Quiet Editions — print fair & book launch
+
Type Garden, Pavilion South
+
2 days
+
+
+
22.09
+
Open Conversations · meteorology & drawing
+
Reading Room, ground floor
+
2 hr
+
+
+
11.10
+
The Last Window, closing performance
+
Pavilion of Quiet Form, Rotterdam
+
60 min
+
+
+
+
+
diff --git a/desktop/design-templates/biennale-yellow/slides/chapter.html b/desktop/design-templates/biennale-yellow/slides/chapter.html new file mode 100644 index 00000000..fa4af22a --- /dev/null +++ b/desktop/design-templates/biennale-yellow/slides/chapter.html @@ -0,0 +1,10 @@ +
+ +
First Chapter — Slow Atmospheres
+
+
01
+
A reading of the season's quietest hours
+

In its first chapter the Aurora Programme convenes around the slowest light of the year: the long minutes after the sun has gone but before the room has admitted it. We open the year in March, in three rooms, in three cities, with three lamps left burning past closing.

+
+
+
diff --git a/desktop/design-templates/biennale-yellow/slides/colophon.html b/desktop/design-templates/biennale-yellow/slides/colophon.html new file mode 100644 index 00000000..a1655e40 --- /dev/null +++ b/desktop/design-templates/biennale-yellow/slides/colophon.html @@ -0,0 +1,32 @@ +
+ + + +
+
Colophon · Programme 04
+

With thanks
to the slow
readers.

+
+ +
+
+
Curated by
+
Idun Reijners
with the editorial board
+
+
+
Designed
+
In daylight, on warm paper,
over fourteen weeks
+
+
+
Hosts
+
Aurora Institute
Pavilion of Quiet Form
Reading Garden
+
+
+
Until next year
+
The fifth programme opens in May 2027. Look for the yellow on the door.
+
+
+ +
+
diff --git a/desktop/design-templates/biennale-yellow/slides/cover.html b/desktop/design-templates/biennale-yellow/slides/cover.html new file mode 100644 index 00000000..c3d62097 --- /dev/null +++ b/desktop/design-templates/biennale-yellow/slides/cover.html @@ -0,0 +1,34 @@ +
+ + + +
02.05—
11.10.2026
+ +
+

Aurora
Programme

+
Annual Survey · Issue No. 04
+
+ + + +
+
diff --git a/desktop/design-templates/biennale-yellow/slides/data.html b/desktop/design-templates/biennale-yellow/slides/data.html new file mode 100644 index 00000000..a6cf735f --- /dev/null +++ b/desktop/design-templates/biennale-yellow/slides/data.html @@ -0,0 +1,29 @@ +
+ +
+
+
Public attendance
+
Open programme · 2022—2026
+
+
+
+
182k
+
Visitors · Year four
+
A 2.4× rise on the inaugural year, drawn from a programme that grew slower than the audience.
+
+
+
74%
+
Returning audience
+
Three quarters of last year's visitors came back; nearly half came back twice.
+
+
+
+
2022
76,400
+
2023
112,800
+
2024
141,200
+
2025
164,900
+
2026
182,300
+
+
+
+
diff --git a/desktop/design-templates/biennale-yellow/slides/manifesto.html b/desktop/design-templates/biennale-yellow/slides/manifesto.html new file mode 100644 index 00000000..c6b0d9aa --- /dev/null +++ b/desktop/design-templates/biennale-yellow/slides/manifesto.html @@ -0,0 +1,6 @@ +
+ +

A room is a slow argument with the sun. We have spent four years listening for what it answers.

+
From the Aurora Charter, 2023
+
+
diff --git a/desktop/design-templates/biennale-yellow/slides/programme.html b/desktop/design-templates/biennale-yellow/slides/programme.html new file mode 100644 index 00000000..05235f76 --- /dev/null +++ b/desktop/design-templates/biennale-yellow/slides/programme.html @@ -0,0 +1,50 @@ +
+
+
Strands · 2026
+
+
Programme
+
+
Six interlocking strands run across the year. Each is independently curated, but every strand answers to the same question: what does light know that we don't?
+
+
+
Strand · Title · Anchor
+
+
+
01
+
+

Slow Atmospheres

+

A reading room of long-form essays, drawings and weather notebooks about late-afternoon yellow.

+
+
+
+
02
+
+

Public Form

+

Three commissions in three pavilions, each studying how a public square wears its light.

+
+
+
+
03
+
+

Field Notes

+

A residency that brings artists, architects and meteorologists together for a hundred days.

+
+
+
+
04
+
+

Quiet Editions

+

A publishing strand that prints only what asks to be read in daylight, on warm paper.

+
+
+
+
05
+
+

Open Conversations

+

Twelve evenings of public talks, paired with a meal and one question about weather.

+
+
+
+
+
+
diff --git a/desktop/design-templates/biennale-yellow/slides/quote.html b/desktop/design-templates/biennale-yellow/slides/quote.html new file mode 100644 index 00000000..1440891d --- /dev/null +++ b/desktop/design-templates/biennale-yellow/slides/quote.html @@ -0,0 +1,14 @@ +
+ + +
+
A note from the curator
+

The yellow we use is not the yellow we mean. It is the yellow that arrives ten minutes after we leave the building.

+
+
Idun Reijners
+
Curator-at-large, Aurora Institute · letter to the editorial board, January 2026
+
+
+ +
+
diff --git a/desktop/design-templates/block-frame/DESIGN.md b/desktop/design-templates/block-frame/DESIGN.md new file mode 100644 index 00000000..3c176af3 --- /dev/null +++ b/desktop/design-templates/block-frame/DESIGN.md @@ -0,0 +1,600 @@ +--- +version: alpha +name: BlockFrame +description: "A maximalist neobrutalist presentation system built on 4px solid black borders, 8px hard offset shadows, and a high-key candy palette of five saturated pastels plus cream and off-white. Display type runs Inter at weight 800-900 in tight uppercase; secondary chrome uses Space Grotesk as a quasi-monospace label face. Tilted decorative shapes (rotated stars, rectangles, badges) puncture the borders and break the grid intentionally. Pastels are paired loudly: pink + blue + green + yellow + cream cycle through every region with deliberate juxtaposition. The aesthetic borrows from zine layout, 1990s-revival sticker books, and contemporary toy packaging — bold, joyful, slightly chaotic, never timid." + +colors: + black: "#000000" + white: "#FFFFFF" + offwhite: "#FFFDF5" + pink: "#FE90E8" + blue: "#C0F7FE" + green: "#99E885" + yellow: "#F7CB46" + cream: "#FFDC8B" + +borders: + primary: "4px solid {colors.black}" + thin: "3px solid {colors.black}" + +shadows: + default: "8px 8px 0px {colors.black}" + small: "4px 4px 0px {colors.black}" + hover: "6px 6px 0px {colors.black}" + close-yellow: "12px 12px 0px {colors.yellow}" + close-white: "6px 6px 0px {colors.white}" + +typography: + heading-xl: + fontFamily: "'Inter', sans-serif" + fontWeight: 900 + fontSize: "clamp(48px, 6vw, 96px)" + lineHeight: 0.95 + letterSpacing: -0.03em + textTransform: uppercase + heading-lg: + fontFamily: "'Inter', sans-serif" + fontWeight: 800 + fontSize: "clamp(32px, 4vw, 64px)" + lineHeight: 1 + letterSpacing: -0.02em + textTransform: uppercase + heading-md: + fontFamily: "'Inter', sans-serif" + fontWeight: 700 + fontSize: "clamp(24px, 2.5vw, 40px)" + lineHeight: 1.1 + letterSpacing: -0.01em + close-title: + fontFamily: "'Inter', sans-serif" + fontWeight: 900 + fontSize: "clamp(40px, 5vw, 80px)" + lineHeight: 0.95 + letterSpacing: -0.03em + textTransform: uppercase + quote-text: + fontFamily: "'Inter', sans-serif" + fontWeight: 900 + fontSize: "clamp(28px, 3.5vw, 52px)" + lineHeight: 1.15 + letterSpacing: -0.02em + textTransform: uppercase + stat-number: + fontFamily: "'Inter', sans-serif" + fontWeight: 900 + fontSize: "clamp(36px, 4vw, 64px)" + lineHeight: 1 + card-title: + fontFamily: "'Inter', sans-serif" + fontWeight: 700 + fontSize: 22px + lineHeight: 1.2 + textTransform: uppercase + step-num: + fontFamily: "'Inter', sans-serif" + fontWeight: 900 + fontSize: 48px + lineHeight: 1 + body: + fontFamily: "'Inter', sans-serif" + fontWeight: 500 + fontSize: "clamp(16px, 1.2vw, 20px)" + lineHeight: 1.6 + body-card: + fontFamily: "'Inter', sans-serif" + fontWeight: 500 + fontSize: 15px + lineHeight: 1.6 + list-body: + fontFamily: "'Inter', sans-serif" + fontWeight: 500 + fontSize: 16px + lineHeight: 1.5 + label: + fontFamily: "'Space Grotesk', monospace" + fontWeight: 600 + fontSize: 13px + lineHeight: 1 + letterSpacing: 0.08em + textTransform: uppercase + mono-tag: + fontFamily: "'Space Grotesk', monospace" + fontWeight: 600 + fontSize: 14px + lineHeight: 1 + letterSpacing: 0.05em + textTransform: uppercase + mono-meta: + fontFamily: "'Space Grotesk', monospace" + fontWeight: 500 + fontSize: 15px + letterSpacing: 0.02em + subtitle-mono: + fontFamily: "'Space Grotesk', monospace" + fontWeight: 500 + fontSize: 18px + lineHeight: 1.5 + counter: + fontFamily: "'Space Grotesk', monospace" + fontWeight: 700 + fontSize: 14px + lineHeight: 1 + letterSpacing: 0.1em + textTransform: uppercase + legend-item: + fontFamily: "'Space Grotesk', monospace" + fontWeight: 600 + fontSize: 13px + +spacing: + slide-pad: 60px + card-pad-lg: 60px + card-pad-md: 36px + card-pad-sm: 28px + card-pad-xs: 22px + gap-lg: 48px + gap-md: 32px + gap-sm: 24px + gap-xs: 16px + pad-bottom-clearance: 110px + +canvas: + width: 100vw + height: 100vh + default-background: "{colors.offwhite}" + +components: + card-elevated: + border: "4px solid {colors.black}" + background: "{colors.white}" + boxShadow: "{shadows.default}" + description: "Primary elevated card. 4px ink border + 8px ink offset shadow. Background is white by default; on darker surfaces background may shift to offwhite or to a colored fill." + card-flat: + border: "4px solid {colors.black}" + background: "{colors.white}" + description: "Bordered card without elevation shadow. Used for secondary content cells inside multi-card grids where the shadow would compound." + card-small: + border: "3px solid {colors.black}" + background: "{colors.white}" + boxShadow: "{shadows.small}" + description: "Compact card with thinner border + smaller offset shadow. Used for intro-cards, stat-cards, team-cards, and timeline-steps." + label-pill: + border: "3px solid {colors.black}" + padding: "6px 16px" + fontFamily: "'Space Grotesk', monospace" + fontSize: 13px + fontWeight: 600 + letterSpacing: 0.08em + textTransform: uppercase + background: "{colors.white}" + boxShadow: "{shadows.small}" + description: "Universal section eyebrow. White base by default; pink, blue, green, yellow, cream variants swap background. Always sits on a 3px black border with a 4px hard offset shadow." + button-primary: + border: "3px solid {colors.black}" + background: "{colors.yellow}" + color: "{colors.black}" + padding: "14px 32px" + fontFamily: "'Inter', sans-serif" + fontWeight: 700 + fontSize: 16px + boxShadow: "{shadows.small}" + description: "Primary CTA. Yellow fill with black text, 3px black border, 4px offset shadow. Hover lifts the button -2/-2 and grows shadow to 6px." + corner-bracket: + width: 24px + height: 24px + border: "3px solid {colors.black}" + description: "Two L-shaped brackets at opposite corners of a card or frame (tl + br + tr + bl pattern available). Sits inside the card edge as a decorative frame-within-frame." + icon-square: + width: 64px + height: 64px + border: "3px solid {colors.black}" + description: "Solid pastel square (pink/blue/green) holding a single uppercase letter glyph at weight 700 / 28px. Used as feature-card icons." + feature-deco: + width: 48px + height: 48px + border: "3px solid {colors.black}" + background: "{colors.yellow}" + position: "absolute top -12px right 24px" + description: "Yellow square notch that protrudes from the top edge of a feature card, breaking the card's top border line." + stat-deco-dot: + width: 12px + height: 12px + borderRadius: 50% + border: "2px solid {colors.black}" + description: "Small black-bordered colored circle pinned to the top-right of a stat card. The only round shape used on cards. Fill cycles through the pastel palette." + avatar-square: + width: 72px + height: 72px + border: "3px solid {colors.black}" + background: "{colors.pink}" + fontFamily: "'Inter', sans-serif" + fontWeight: 900 + fontSize: 28px + textTransform: uppercase + description: "Square avatar with two-letter initials, used in team grids. Fill cycles through the pastel palette." + list-number: + width: 36px + height: 36px + border: "3px solid {colors.black}" + background: "{colors.yellow}" + fontFamily: "'Space Grotesk', monospace" + fontWeight: 700 + fontSize: 14px + description: "Square numerical bullet pinned to the left of each list item. Black border, yellow fill, mono numeral." + star-burst: + clipPath: "polygon(50% 0%, 61% 35%, 98% 35%, 68% 57%, 79% 91%, 50% 70%, 21% 91%, 32% 57%, 2% 35%, 39% 35%)" + border: "3px solid" + background: "{colors.pink}" + description: "10-point star clipped via CSS clip-path with a 3px border. Decorative attention-grabber pinned to corners of close-frames and feature cards." + stripe-block: + background: "repeating-linear-gradient(45deg, {colors.black}, {colors.black} 4px, {colors.green} 4px, {colors.green} 12px)" + border: "3px solid {colors.black}" + description: "Black-and-color diagonal stripe panel used as decorative attention block on poster-class surfaces." + bg-dot-grid: + backgroundImage: "radial-gradient(circle, {colors.black} 1.2px, transparent 1.2px)" + backgroundSize: "24px 24px" + description: "Faint dot-grid background pattern used as an overlay on light surfaces or as decoration in corners of cards." + tilt-card: + transform: "rotate(±2deg) or rotate(±8deg)" + description: "Card with intentional tilt. Stat cards alternate -2deg / +2deg; decorative rectangles tilt up to ±12deg. The tilt is the system's playful structural signature." + nav-btn: + width: 48px + height: 48px + border: "3px solid {colors.black}" + background: "{colors.white}" + boxShadow: "{shadows.small}" + description: "Square nav arrow button. Hover translates -2/-2 and grows shadow; active translates 2/2 and shrinks shadow." + slide-counter: + border: "3px solid {colors.black}" + background: "{colors.white}" + padding: "10px 18px" + boxShadow: "{shadows.small}" + description: "Persistent slide counter pill at bottom-left. Space Grotesk uppercase NN / NN format." +--- + +> This design note comes from [beautiful-html-templates](https://github.com/zarazhangrui/beautiful-html-templates) (MIT, Copyright (c) 2026 Zara Zhang). The template in this folder was converted to the DreamCoder deck format: a fixed 1920 by 1080 stage, one file per slide under slides/, all styles in deck.css, no scripts in slides, and page numbers from the stage counters. Where this note talks about viewport units, navigation, slide counters, scripts or a single HTML file, the deck format wins; colors, type and decoration are as described here. + +## Overview + +BlockFrame is a **maximalist neobrutalist presentation system** built on five structural laws: every region has a 4px black border, every elevated element has an 8px hard offset shadow, every corner is square, every accent color is a saturated pastel, and every layout is allowed to be a little bit crooked. The system's joy comes from the deliberate collision of these laws — bordered cards meet bordered cards, shadows stack against shadows, tilted decorations puncture the grid intentionally. + +The type system pivots on **Inter** (weights 400-900) for display, body, and stats — set at weight 800-900 in tight uppercase with negative letter-spacing for headlines, weight 500 sentence case for body, and weight 700 uppercase for card titles. **Space Grotesk** (weights 400-700) is the secondary face, used as a quasi-monospace label voice for eyebrows, slide counters, stat labels, mono tags, and any chrome that should read as "system" rather than "editorial". The face combination is deliberately ordinary — both are widely-available open sans-serifs — but the treatment (heavy uppercase Inter + wide-tracked Space Grotesk) gives them a distinct neobrutalist register. + +The palette is built around **five saturated pastels** (pink `#FE90E8`, blue `#C0F7FE`, green `#99E885`, yellow `#F7CB46`, cream `#FFDC8B`) plus **pure black** (`#000000`) for borders and text, **white** (`#FFFFFF`) for clean card fills, and **off-white** (`#FFFDF5`) for warm canvas. The pastels are not subtle accents — they are full-bleed surface fills. A typical deck cycles every slide through a different colored ground (offwhite cover → blue intro → offwhite content → green chart → pink quote → yellow split → offwhite timeline → blue stats → cream team → black close). This color cycling is the system's primary rhythm. + +Depth is **hard offset shadow at 4px and 8px**, always solid black, always zero blur, always positioned bottom-right. Larger elements get 8px, smaller chrome gets 4px. The close-frame uses a single 12px offset in **yellow** (the only colored shadow in the system) as the system's loudest depth statement, and inverted close-frames pair 6px **white** shadows on black surfaces. Borders are 4px solid black on primary cards, 3px solid black on secondary chrome. Border weight and shadow size are tightly coupled — a 4px border carries an 8px shadow; a 3px border carries a 4px shadow. + +**Density philosophy: comfortably dense.** This system reads as authoritative when packed and timid when sparse. A typical surface holds: a label-pill eyebrow + a large headline + a multi-card grid (3-6 cards) + at least one decorative element (tilted rectangle, star burst, stripe block, corner bracket, deco dots). Empty space within a region reads as "broken" — every card should be filled, every grid should be complete. The system's joy depends on the visual chatter of many bordered objects existing in the same frame. + +**Key Characteristics:** +- 4px solid black borders on primary cards, 3px on secondary chrome — never thinner. +- 8px hard offset shadows on primary cards, 4px on secondary chrome — solid black, zero blur. +- Five-pastel palette (pink, blue, green, yellow, cream) plus black, white, off-white — cycled across surfaces. +- Inter weight 800-900 uppercase with negative tracking is the display voice; Space Grotesk weight 600 uppercase with 0.08em tracking is the label voice. +- Square corners everywhere except a single circular accent dot on stat cards. +- Tilted decorative elements (rotated rectangles, stars, badges) puncture the grid intentionally. +- Label pills (`{components.label-pill}`) carry a 3px border, 4px offset shadow, and a pastel fill variant — the universal section eyebrow. +- Colored fills are bold and saturated; pastels are used as panel grounds, not as light accents. +- Yellow is the default CTA color; black is the default close-surface color. +- Star bursts, stripe blocks, and dot grids are reusable decorative attention units. + +## Colors + +### Palette + +- **Black** (`{colors.black}` — `#000000`): The structural color. Every border, every primary text moment, every shadow. Pure black, no warm bias. The system's contrast anchor. +- **White** (`{colors.white}` — `#FFFFFF`): The default card fill. Used on every primary card and as the background of label-pills and nav-buttons. Pure white, no warmth. +- **Off-white** (`{colors.offwhite}` — `#FFFDF5`): The warm canvas tone. The default body/slide background when no pastel ground is in play. Subtly warmer than pure white so that white cards sitting on top still feel layered. +- **Pink** (`{colors.pink}` — `#FE90E8`): A high-key candy magenta. Used as a full-surface ground, as label-pill fill, as icon-square fill, as star-burst fill, and as one of the pastel chart series. The most saturated of the five pastels. +- **Blue** (`{colors.blue}` — `#C0F7FE`): A pale cyan-ice blue. Used as a full-surface ground (the "intro" and "stats" feel), as label-pill fill, as icon-square fill, and as a chart series. +- **Green** (`{colors.green}` — `#99E885`): A bright spring green. Used as a full-surface ground, as label-pill fill, as icon-square fill, in the stripe-block diagonal pattern, and as a chart series. +- **Yellow** (`{colors.yellow}` — `#F7CB46`): The CTA color. Used as the default button fill, as the close-frame shadow color, as list-number squares, as the feature-deco notch, and as label-pill fill. The brightest, most attention-pulling pastel. +- **Cream** (`{colors.cream}` — `#FFDC8B`): A warm yellow-cream. Softer than yellow, more saturated than offwhite. Used as a full-surface ground (the "team" or "cover" feel), as label-pill fill, and as a tertiary chart accent. + +### Defaults + +- **Default surface background**: `{colors.offwhite}` for content-heavy surfaces; cycle through `{colors.cream}`, `{colors.blue}`, `{colors.pink}`, `{colors.green}`, `{colors.yellow}` for surfaces that need a stronger ground. The cycle is the rhythm; staying on one ground for many slides flattens the system. +- **Default headline color**: `{colors.black}` on all light/pastel surfaces; `{colors.white}` on the black close-surface. +- **Default body text color**: `{colors.black}` on all light/pastel surfaces; `{colors.white}` or `{colors.cream}` on dark surfaces. +- **Default border color**: `{colors.black}` — always. There are no colored borders anywhere except the 4px white border on the inverted close-frame. +- **Default card fill**: `{colors.white}`. Use a pastel fill only when the card is part of a multi-card row where each card needs distinct color identity (e.g., the timeline-step row where each step is a different pastel). +- **Default button fill**: `{colors.yellow}`. Other pastels work, but yellow is the system's primary "click here" signal. +- **Default label-pill base**: `{colors.white}`; pastel variants (`{colors.pink}`, `{colors.blue}`, `{colors.green}`, `{colors.yellow}`, `{colors.cream}`) signal section type or decorate the eyebrow. +- **Default decorative accent on stat cards**: a 12px circle (`{components.stat-deco-dot}`) in a pastel fill — cycling pink, blue, green, yellow across cards. +- **Default chart palette order**: pink → blue → green (three-series), with yellow and cream available for additional series. + +The pastels are interchangeable in role — none of them carry fixed semantic meaning (green isn't "success", red doesn't exist in the palette at all). Pair them by visual juxtaposition: pink + blue + green is the most common trio; cream + yellow is the warm pair; blue + pink is the cool-warm contrast. + +## Typography + +### Font Family Stack +The system runs two faces. + +**Inter** (weights 400-900) is the display, body, headline, and stat face. Used at weight 900 for hero/close titles and quote text, weight 800 for primary headlines, weight 700 for medium headlines and card titles, weight 500 for body. Display weights are always uppercase with negative letter-spacing (-0.02 to -0.03em); body weights are always sentence case with default tracking. The contrast between heavy uppercase display and weight-500 sentence body is the system's typographic rhythm. + +**Space Grotesk** (weights 400-700) is the label and chrome face. Used at weight 600 for label-pills (13px, 0.08em tracking, uppercase) and at weight 500 for monospace meta callouts. The face is technically not monospace, but its slightly geometric character + the wide tracking treatment makes it read as the system's "code" voice. + +Don't introduce a third face. The Inter + Space Grotesk pairing is the entire typographic palette. + +### Typography Scale + +| Token | Size (clamp / px) | Family | Weight | Use | +|---|---|---|---|---| +| `{typography.heading-xl}` | 48–96px clamp | Inter | 900 | Hero or cover-scale headline | +| `{typography.heading-lg}` | 32–64px clamp | Inter | 800 | Primary section headline | +| `{typography.heading-md}` | 24–40px clamp | Inter | 700 | Region headline, chart title | +| `{typography.close-title}` | 40–80px clamp | Inter | 900 | Closing-statement title (inverted surface) | +| `{typography.quote-text}` | 28–52px clamp | Inter | 900 | Quote body — always uppercase | +| `{typography.stat-number}` | 36–64px clamp | Inter | 900 | Stat numeral | +| `{typography.card-title}` | 22px | Inter | 700 | Feature card title — uppercase | +| `{typography.step-num}` | 48px | Inter | 900 | Numeral inside a timeline-step (opacity 0.6) | +| `{typography.body}` | 16–20px clamp | Inter | 500 | Standard body paragraph | +| `{typography.body-card}` | 15px | Inter | 500 | Body inside compact cards | +| `{typography.list-body}` | 16px | Inter | 500 | Numbered list body | +| `{typography.label}` | 13px | Space Grotesk | 600 | Text inside label-pill | +| `{typography.mono-tag}` | 14px | Space Grotesk | 600 | Mono tag/badge, slide-counter | +| `{typography.mono-meta}` | 15px | Space Grotesk | 500 | Inline mono metadata | +| `{typography.subtitle-mono}` | 18px | Space Grotesk | 500 | Hero subtitle / close subtitle | +| `{typography.counter}` | 14px | Space Grotesk | 700 | Persistent slide counter (NN / NN) | +| `{typography.legend-item}` | 13px | Space Grotesk | 600 | Chart legend label | + +### Defaults + +- **Default size for a hero or cover title**: `{typography.heading-xl}` (48–96px). Always uppercase, always weight 900, always with -0.03em tracking. +- **Default size for a primary section headline**: `{typography.heading-lg}` (32–64px). Uppercase, weight 800, -0.02em. +- **Default size for a region or chart title**: `{typography.heading-md}` (24–40px). The only Inter heading not in uppercase by default — though uppercase is permitted. +- **Default size for a stat numeral**: `{typography.stat-number}` (36–64px). Weight 900, line-height 1. +- **Default size for body paragraph**: `{typography.body}` (16–20px clamp). Weight 500, sentence case, line-height 1.6. +- **Default size for an eyebrow label**: `{typography.label}` (13px) inside the `{components.label-pill}`. +- **Default weight for any Inter display**: 800 or 900. Inter display at weight 700 reads as "almost there"; only use 700 for `{typography.heading-md}` or card titles. +- **Default weight for any Inter body**: 500. Body at 400 reads as too light, body at 700 reads as oversized. +- **Default tracking for any Space Grotesk label/chrome**: 0.05-0.10em. Wide tracking is the face's "chrome" signal. +- **Default tracking for any Inter display**: -0.01em (heading-md) to -0.03em (heading-xl). Display without negative tracking reads as untreated. + +When unsure which heading token to reach for, default to `{typography.heading-lg}` (32–64px) for the slide's primary text moment. `{typography.heading-md}` is for region or chart titles within a slide. + +### Signature Treatments + +These treatments are **non-optional whenever the corresponding element type is used**: + +- **Every Inter display element (heading-xl, heading-lg, quote-text, close-title) is uppercase.** Sentence-case Inter display at weights 800+ does not exist in this system. The uppercase + heavy-weight + negative-tracking combination is the visual identity. +- **Every Inter display element uses negative letter-spacing** (-0.01 to -0.03em). Display without negative tracking reads as default Inter, which is a fundamentally different aesthetic. +- **Every label-pill carries the 3px border + 4px shadow + uppercase Space Grotesk text** combination. A label without all three properties is not a label-pill — it's a stray text element. +- **Every card-title is uppercase Inter weight 700.** Card titles in sentence case break the brutalist rhythm. +- **Every Space Grotesk label/chrome/counter is uppercase with 0.05-0.1em tracking.** Sentence-case Space Grotesk does not exist in this system except for body-adjacent metadata (mono-meta, mono inline). +- **Every stat numeral is Inter weight 900 with line-height 1.** Stat numerals are display moments, not data chrome. +- **Every Inter body block is sentence case with line-height 1.6 (or 1.5 for compact card body).** Body in uppercase or with tight line-height reads as broken. +- **Step numbers inside timeline-step cards are 48px weight 900 at opacity 0.6.** The reduced opacity is mandatory — full-opacity step numbers overwhelm the step title. + +### Typography Principles + +The voice contrast is **bold uppercase display ↔ sentence body ↔ wide-tracked label**. Italic is never used. Underline is never used. The only emphasis mechanism is weight contrast within the Inter ladder and the uppercase/sentence-case switch. + +Display elements should be allowed to **dominate the canvas**. The system is built for poster-scale typography; reading a heading-xl at small size collapses its character. Lean into the upper bound of every clamp. + +## Layout + +### Canvas System +The system targets `100vw × 100vh` per slide. Slides are absolutely positioned and toggled via `display: none` / `display: flex` on the `.active` class. Default slide padding is 60px on all sides. Slides that contain bottom-anchored grids (timeline, team grid, chart with stat column) carry an additional `padding-bottom: 110px` to clear the fixed slide-counter and nav-controls chrome. + +The default slide flex direction is column with `justify-content: center`. For two-column splits (intro slide, split image+text), flex direction switches to row. + +### Padding and Gap Scale + +| Token | Value | Use | +|---|---|---| +| `{spacing.slide-pad}` | 60px | Default slide padding from edge to content | +| `{spacing.card-pad-lg}` | 60px | Hero-frame and quote-frame internal padding | +| `{spacing.card-pad-md}` | 36px | Feature-card internal padding | +| `{spacing.card-pad-sm}` | 28px | Intro-card internal padding | +| `{spacing.card-pad-xs}` | 22px | Team-card and small-cell padding | +| `{spacing.gap-lg}` | 48px | Gap between major sections (header-to-grid) | +| `{spacing.gap-md}` | 32px | Gap between feature cards | +| `{spacing.gap-sm}` | 24px | Gap between intro cards, stat cards | +| `{spacing.gap-xs}` | 16px | Gap inside list items, intra-card content | +| `{spacing.pad-bottom-clearance}` | 110px | Bottom padding reserve to clear fixed nav chrome | + +### Persistent Chrome +Three elements appear on every slide: +- **Slide counter** at bottom-left — 3px black border, white fill, 4px shadow, Space Grotesk 14px weight 700 uppercase, NN / NN format. +- **Nav controls** at bottom-right — two 48px square nav buttons with 3px borders, white fills, 4px shadows. +- The slide-counter and nav-controls are not part of the slide composition — they live outside `.slides-container` and overlap the bottom edge. + +### Card-on-Card Structure +The system's primary layout pattern is **cards on grounds on grounds**. A typical slide places a colored-ground surface, on which sits a white card with 4px black border + 8px shadow, which may contain smaller cards or icon-squares. Each level of nesting carries its own border weight: 4px for the outer card, 3px for inner chrome. This nested-bordered structure is what gives the system its dense, packed feel. + +### Decorative Disruption +Tilted decorative elements (rotated rectangles, stars, badges, dot grids) are placed absolutely on slide and card surfaces to puncture the grid intentionally. These are not "background decoration" — they are part of the composition. A surface without any decorative element reads as too clean. + +## Depth and Elevation + +### Hard Offset Shadow Stack +The system uses three primary shadow values: +- **`{shadows.default}`** = `8px 8px 0px {colors.black}` — primary card shadow. Used on hero-frame, feature-card, quote-frame, chart-frame, and any elevated card. +- **`{shadows.small}`** = `4px 4px 0px {colors.black}` — secondary chrome shadow. Used on intro-card, stat-card, team-card, timeline-step, label-pill, button-primary, nav-btn, slide-counter. +- **`{shadows.hover}`** = `6px 6px 0px {colors.black}` — hover state for buttons and nav. Triggered with a -2/-2 transform. + +All shadows are solid black, zero blur, fixed offset bottom-right. The shadow + transform pairing on hover creates a "lifting off the page" interaction signature — the element translates -2/-2 while the shadow grows to 6/6, simulating a peel-up. + +### Inverted Shadows +On the dark close-surface, shadows invert their color but keep the offset logic: +- **`{shadows.close-yellow}`** = `12px 12px 0px {colors.yellow}` — the loudest depth statement in the system. Used on close-frame to make the inverted surface read as still "elevated" despite its dark ground. +- **`{shadows.close-white}`** = `6px 6px 0px {colors.white}` — used on the close-btn to maintain elevation on the black ground. + +These colored shadows are the only exceptions to the "shadows are always black" rule, and they appear only on the dark surface. + +### Border-Based Depth +Most of the system's apparent layering comes from the 4px or 3px ink borders, not from shadow. A card with a border but no shadow still reads as "an object on a surface" — the shadow is what makes it read as "lifted". Use shadow for elevated cards; use border-only for secondary cards inside a multi-card grid where stacked shadows would compound into noise. + +### Tilted Elements as Depth +The system's playful depth signature is **tilt**. Stat cards alternate -2deg / +2deg rotation. Decorative pink rectangles tilt up to ±12deg. The yellow button tab on the hero frame tilts -3deg. These tilts break the grid alignment intentionally and create perceived dimensionality without using actual perspective or shadow. + +## Shapes and Treatment + +### Border Radius +- **0px** on everything structural — cards, label-pills, buttons, icon-squares, list-numbers, avatars, badges. Square corners are non-negotiable. +- **50% (circle)** used only for the stat-deco dot (12×12 circular accent pinned to stat cards). This is the only round shape in the system. + +The square-corner discipline is the system's structural identity. Adding rounded corners to any card or chip immediately reads as a different aesthetic. + +### Border Weights +- **4px solid `{colors.black}`** — used on primary cards (hero-frame, feature-card, quote-frame, chart-frame, team-card border, timeline-step border, stat-card border) and the close-frame inverse (4px solid white on black ground). +- **3px solid `{colors.black}`** — used on secondary chrome (label-pill, button, intro-card, icon-square, list-number, avatar, corner-bracket, nav-btn, slide-counter, stripe-block, star-burst). The 3px weight signals "secondary structural" vs. the 4px "primary structural". +- **2px solid `{colors.black}`** — used only on legend swatches (16×16 chart swatches) and stat-deco dots. The thinnest border weight, reserved for atomic chrome. +- **4px solid `{colors.white}`** — used only on the inverted close-frame, the visual-box, and its ::after offset frame on the dark split-visual surface. + +The border weight ladder (2 / 3 / 4) is fixed. No 1px borders, no 5px+ borders. + +### Decorative Element Types + +**Label-pill** — Square bordered pill (3px black border, 4px shadow), pastel or white fill, Space Grotesk 13px weight 600 uppercase text with 0.08em tracking. The universal section eyebrow. + +**Corner-bracket** — Two L-shaped brackets (or four for full enclosure) at the corners of a card, 3px black border. Creates a frame-within-frame decorative motif. + +**Star-burst** — 10-point star clipped via CSS clip-path with a 3px border, pastel fill. Decorative attention-grabber pinned to corners of close-frames and feature cards. + +**Stripe-block** — Diagonal 4px-on, 8px-off stripe pattern in black + a pastel color, framed with a 3px black border. Decorative attention block used on poster-class surfaces. + +**Dot-grid** — 1.2px radial-gradient dot pattern at 24×24 spacing. Used as a faint decorative overlay in corners of slides, at 30-40% opacity. + +**Feature-deco notch** — 48×48 yellow square with 3px black border, positioned absolutely to protrude from the top edge of a feature card. The notch breaks the card's top border, suggesting it's been "stapled on". + +**Icon-square** — 64×64 pastel square with 3px black border holding a single uppercase letter glyph at Inter weight 700 / 28px. Used as feature-card icons. + +**Stat-deco dot** — 12×12 circle with 2px black border, pastel fill, pinned to the top-right of a stat card. The system's only round shape. + +**List-number** — 36×36 yellow square with 3px black border holding a Space Grotesk 14px weight 700 numeral. Used as bullets on numbered lists. + +**Avatar-square** — 72×72 pastel square with 3px black border holding two uppercase initials at Inter weight 900 / 28px. Used in team grids; fills cycle through pastels. + +**Step-connector** — A 28×4 horizontal black bar pinned to the right edge of a timeline-step card, mid-height. Visually links adjacent steps in a horizontal flow. + +**Tilted decoration** — Any rectangle, badge, or star with a rotate(±2deg to ±12deg) transform. The tilt is intentional disruption of the grid; without it, the system reads as too uniform. + +## Do's and Don'ts + +### Do + +- Apply 4px solid black borders to primary cards (`{components.card-elevated}`, hero-frame, quote-frame) and 3px to secondary chrome. The border weight ladder is the system's structural backbone. +- Pair every 4px border with an 8px offset shadow, and every 3px border with a 4px offset shadow. The border/shadow coupling is non-negotiable. +- Cycle slide backgrounds through the pastel palette — offwhite, cream, blue, pink, green, yellow — to keep the deck visually rhythmic. Staying on one color for many slides flattens the system. +- Set every Inter display element in uppercase with negative letter-spacing (-0.01 to -0.03em) and weight 800+. The combination is the typographic identity. +- Use the `{components.label-pill}` (3px border, 4px shadow, pastel fill, Space Grotesk uppercase 0.08em) as the universal section eyebrow on every region. +- Apply tilt to decorative rectangles, stat cards, stars, and badges (±2deg to ±12deg). The intentional misalignment is the system's playful signature. +- Use `{colors.yellow}` as the default button color. Yellow with a 3px black border and 4px black shadow is the system's "click here" voice. +- Render shadows as solid black with zero blur, always offset bottom-right. The hard-edge shadow is the depth language. +- Add a decorative element (star-burst, stripe-block, dot-grid, corner-bracket, tilted rectangle) to every surface. The visual chatter is part of the system's energy. +- Use pure black `{colors.black}` for the closing surface, with white text and a 12px yellow offset shadow on the close-frame. The inverted dark surface is the system's loudest contrast moment. + +### Don't + +- Don't round any corner on cards, buttons, label-pills, icon-squares, or avatars. Border-radius is forbidden except on the stat-deco dot (12px circle). +- Don't blur any shadow. Every shadow is hard-edged at zero blur. `box-shadow: 0 4px 12px rgba(0,0,0,0.1)` does not exist in this system. +- Don't use colored borders. Borders are always pure black, except for the inverted 4px white border on the close-frame. +- Don't use Inter display weights in sentence case. Uppercase is mandatory on heading-xl, heading-lg, quote-text, close-title, and card-title. +- Don't set Inter display without negative letter-spacing. Default-tracked Inter at heavy weights reads as a different system. +- Don't introduce a sixth pastel color. The palette is locked at pink, blue, green, yellow, cream. Adding purple, orange, or red breaks the curated candy palette. +- Don't omit the label-pill on a region. Going straight from background to headline without an eyebrow tag breaks the system's editorial rhythm. +- Don't render label-pills as plain text. The 3px border + 4px shadow + pastel fill combination is what defines the pill. +- Don't use blurred or colored body text. Body is solid black on light surfaces, solid white or cream on dark surfaces. +- Don't keep every card perfectly aligned. The tilt on stat cards, decorations, and badges is what gives the system its hand-made energy. + +## Responsive Behavior + +BlockFrame is designed as a **1920×1080 presentation system** (effective 100vw × 100vh). Sizing uses CSS `clamp()` for type and fixed px for borders, shadows, and structural padding. The system has three component-level breakpoints for narrow viewports. + +### Scaling Behavior +- Heading-xl scales 48px → 96px on viewport width. +- Heading-lg scales 32px → 64px. +- Body scales 16px → 20px. +- Borders (3px, 4px), shadows (4px, 8px), and structural padding (60px slide-pad) are fixed and do not scale. + +### Component Breakpoints +- `max-width: 1024px` — slide padding shrinks 60px → 40px, two-column splits stack vertically, feature card row stacks vertically, timeline track stacks vertically with step-connectors hidden, stats grid collapses to 2 columns, team grid collapses to 2 columns. Split visual loses left border and gains a top border. +- `max-width: 640px` — stats grid collapses to 1 column, team grid collapses to 1 column, hero-frame padding shrinks to 32px, quote-frame padding shrinks to 32px. + +### Presenter Behavior +- Slides advance via `ArrowRight` or `Space`. +- Slides reverse via `ArrowLeft`. +- Horizontal touch swipe with a 50px threshold advances/reverses. +- Slide transitions are instant (`display: none` ↔ `display: flex` on the `.active` class), with no crossfade. + +### Print Behavior +The system has no `@media print` rule. Slides are absolute-positioned and only one is visible at a time — printing produces only the active slide. For static export, screenshots of each slide preserve all borders, shadows, and decorations (all are CSS, not image assets). + +### Interactive States +- Buttons and nav-buttons translate -2/-2 on hover and shadow grows to 6px (`{shadows.hover}`); on active, translate 2/2 and shadow shrinks to 2px. The hover-press behavior is unusual for a presentation system; it reflects BlockFrame's hybrid identity as both deck and interactive product mockup. + +## CJK & International Content + +When using this template for Chinese (or other CJK) content, swap the Latin typeface stack for an equivalent Chinese pairing and apply universal CJK adjustments. All recommended Chinese fonts load via CDN — no install required. + +### Recommended Chinese Pairing + +| Role | Latin (default) | Chinese counterpart | +|---|---|---| +| Display / hero / quote / close title / stat numerals | Inter 800–900 (uppercase, negative tracking) | 思源黑体 Noto Sans SC 900 (sentence case, 0 tracking) | +| Card title | Inter 700 (uppercase) | 思源黑体 Noto Sans SC 700 (no transform) | +| Body / list body | Inter 500 | 思源黑体 Noto Sans SC 400 | +| Label / mono tag / counter / legend | Space Grotesk 600–700 (uppercase, 0.05–0.1em tracking) | 思源黑体 Noto Sans SC 600 (no transform, no tracking) | + +### Mixed-Content Strategy + +**Strategy A** — single CJK family with built-in Latin glyph coverage. Set every text element to `font-family: 'Noto Sans SC', sans-serif`. 思源黑体 ships Latin glyphs that pair cleanly with its Chinese characters, so mixed sentences render in one consistent face. The Inter / Space Grotesk distinction in the Latin original is preserved through weight contrast: weight 900 carries the brutalist display role, weight 600 carries the label role, weight 400–500 carries body. Visual hierarchy survives even though the face contrast is gone. + +### Loading + +Add to the template's ``: + +```html + + + +``` + +### Universal CJK Adjustments + +- **Line-height**: increase by ~15–25% from the Latin spec. Body 1.75–1.85 (up from 1.6), display 1.15–1.25 (up from 0.95–1). The Latin display compresses to 0.95 line-height; CJK at that compression collides vertically. +- **Letter-spacing**: set to 0 on every CJK run. The template's negative display tracking (−0.02 to −0.03em on Inter) overlaps CJK strokes and reads as broken; the positive 0.05–0.1em tracking on Space Grotesk labels reads as gappy on square glyphs. +- **Text transform**: don't apply `uppercase` to Chinese text — CJK has no case. Every Inter display heading (heading-xl, heading-lg, quote-text, close-title, card-title) uses `text-transform: uppercase` in the Latin original; remove it for CJK runs. Every label-pill, counter, and chrome element also uses uppercase; remove that too. +- **Punctuation**: use full-width Chinese punctuation (,。:;!?「」()). +- **No period on display headlines**: Chinese typography convention omits trailing 。 on display-scale headlines. +- **Space between CJK and Latin (盘古之白)**: insert an ASCII space between every Chinese character and adjacent Latin character or digit. Write `BlockFrame 设计系统` not `BlockFrame设计系统`. +- **One font per sentence**: 思源黑体 covers both CJK and Latin glyphs in a unified style — let it handle mixed sentences. Don't let the browser font-switch to Inter or Space Grotesk mid-word. + +### Aesthetic Notes for This System + +The Latin original's typographic identity rests entirely on the **heavy uppercase + negative tracking** combination on Inter display. CJK has no case, so this signal disappears. The system survives because its identity is **80% structural, 20% typographic**: the 4px black borders, 8px hard offset shadows, five-pastel palette, tilted decorations, label-pills, star bursts, stripe blocks, and dot grids do the brutalist work. Set 思源黑体 900 in sentence case at the same large sizes; the chunky black-on-pastel + hard-shadow framing reads as brutalist regardless of whether the type is in caps. + +The label-pill (Space Grotesk 600 uppercase, 0.08em tracking, 3px border + 4px shadow, pastel fill) loses the uppercase + tracked-mono character. Render Chinese label-pills with 思源黑体 weight 600 at 0 tracking and a slightly tighter fontSize (11–12px instead of 13px) — the bordered pill shape and shadow do the chrome-recognition work. Keep the pastel fill rotation (pink / blue / green / yellow / cream) intact; it's the system's most recognizable signal after the borders themselves. + +### Known CJK Gap + +- **No CDN Chinese monospace face for the "system readout" voice.** Space Grotesk's quasi-mono role (label-pills, counters, mono-tags, slide counter NN / NN) depends on its slightly geometric character plus the wide-tracked uppercase treatment. Neither survives the CJK translation. The slide counter and chart legend can keep Latin digits + Latin labels intact; for purely Chinese chrome, lean on the pill border + shadow + pastel fill to signal "label" rather than the typographic treatment. +- **The "uppercase brutalist" identity weakens.** The system's most distinctive typographic decision is "heavy uppercase Inter with negative tracking" — and that signal is irreplaceable in CJK. Compensate by leaning harder on the structural elements: more decorative disruption (extra tilted rectangles, star bursts, stripe blocks), more saturated pastel-ground rotation across slides, and slightly tighter shadow offsets to compensate for the calmer typographic baseline. + +## Iteration Guide + +1. Any new card uses a 4px or 3px solid black border + the matched-weight offset shadow (8px or 4px). Never use a card without both. +2. Any new region begins with a `{components.label-pill}` eyebrow in pastel fill, then the headline in uppercase Inter weight 800+, then content. The label-headline-content sequence is the system's editorial rhythm. +3. Any new headline uses uppercase Inter with negative letter-spacing and weight 800-900. Reach for `{typography.heading-lg}` (32-64px) for primary moments and `{typography.heading-xl}` (48-96px) for cover/hero scale. +4. Any new accent or surface fill picks from the 5-pastel palette (pink, blue, green, yellow, cream) — never introduce a sixth pastel. +5. Any new CTA uses the `{components.button-primary}` pattern: 3px black border, yellow fill, 4px black shadow, Inter weight 700 / 16px. Hover lifts -2/-2 with shadow growing to 6px. +6. Any new chart cycles through pink → blue → green for series order, with yellow/cream available for additional series. Legend swatches use 2px black border. +7. Any new stat or metric uses Inter weight 900 + line-height 1 for the numeral, paired with Space Grotesk uppercase label below. Decorate the card with a `{components.stat-deco-dot}` in a pastel color. +8. Any new slide adds at least one decorative disruption (tilted rectangle, star-burst, stripe-block, dot-grid corner, corner-bracket frame) — empty surfaces feel timid. +9. Any new closing-style surface uses pure `{colors.black}` ground with white text, a 4px white-bordered close-frame, and a 12px yellow offset shadow. This is the only colored shadow allowed. +10. If a surface feels too noisy, drop a decoration — don't drop a border or shadow. The borders and shadows are structural; the decorations are tunable. + +## Known Gaps + +- **Inter and Space Grotesk are loaded from Google Fonts** via inline `@import`. There are no system fallbacks beyond `sans-serif` and `monospace` — in environments where Google Fonts fail, the system collapses to system defaults and loses its identity. +- **The system uses `@import` inside the `' }])).toEqual(['logo: a