Haiere Style guide
Design system

Aurora Navy / Petal Rose

One system, two moods. Dark mode is midnight navy with soft cyan, muted gold, and pale lavender. Light mode is petal pink with deep plum text and a rose-gold accent. Everything below is a token, no component hardcodes a colour, a size, or a duration.

Modes
Dark · Light
Families
Sora · Inter · JetBrains Mono
Sources
style.css · icons.js
01

Palette

Every colour is a token with a value in both themes. Toggle the switch in the header: the hex readouts below follow the active theme.

--bg-page #0A192F Page background
--bg-page-2 #0B1E33 Alternate band
--bg-inset #071424 Inset wells · code blocks
--surface-solid #0B1E33 Opaque card surface
--text-main #E7EEF6 Primary text
--text-soft #ADB6C2 Secondary text
--accent #7FD8CB Text, buttons, ticks (AA on light)
--accent-ink #7FD8CB Accent as text · ≥ 4.5:1
--accent-2 #D4B27A Gradient partner
--border-soft #1B3348 Hairlines & dividers

One accent per theme. Light uses #945268 for text, buttons, and ticks: 4.9:1 on the page and 5.7:1 under white button text. Dark uses #7FD8CB with navy #0A192F text on top (10.5:1). Glows and hairline borders keep the original rose at low alpha.

Feedback colours are themed too. Success is #047857 light / #34D399 dark. Error is #B91C1C light / #F87171 dark. The raw Tailwind #10b981 and #ef4444 both land near 2–3:1 on the petal background and are no longer used for text.

02

Typography

Sora for display, Inter for body, JetBrains Mono for anything that behaves like data. Three families, seven weights total.

--fs-hero
clamp(2.25rem, 7vw, 4.5rem)
Sora 800

Useful tools, thoughtful experiments.

--fs-section
clamp(1.75rem, 4vw, 2.25rem)
Sora 800

Beat Tools

--fs-card-title
1.05rem · 16.8px
Sora 700

Raia Vault

--fs-body
1rem · 16px · 1.6
Inter 400

Body copy sits at 16–17 px with a 1.6 line height and a 60–65 character measure. Nothing on the site renders below 12 px, and nothing below 14 px carries meaning on its own.

--fs-small
0.85rem · 13.6px
Inter 500

Buttons · navigation · form labels

--fs-mini
11px · 0.18em
Mono 600

Eyebrows · indices · chips

--fs-micro
10.5px · 0.14em
Mono 500

Micro label, tracked uppercase

--fs-status
10px · 0.08em
Mono 700

Stable

03

Space & radii

A 4-px base scale. Sections breathe on clamp(3.5rem, 8vw, 5rem); component padding never exceeds 1.5rem.

4
8
16
24
32
48
64
96
8 · chip
14 · input
20 · card
32 · feature
full · pill

Breakpoints. <640px single column · 640–1023px two up · ≥1024px three up. Layout uses CSS grid and auto-fit wherever the content allows it, so most surfaces reflow without a media query.

04

Icons

SVG only, never an emoji, never an icon font. All UI glyphs come from icons.js via <svg data-icon="icXX">. The Raia logo is exposed both as a registered icon and as a <symbol id="raia"> sprite.

raia
ic-ai
ic-tool
ic-music
ic-lock
ic-globe
ic-code
ic-robot
ic-spark
ic-game
ic-grid
ic-arrow
Geometry Lucide-style

viewBox="0 0 24 24" · fill: none · stroke: currentColor · stroke-width: 2 · linecap/linejoin: round. Colour always inherits from the parent element.

Failsafe sizing 1em

The renderer writes width="1em" and height="1em" as presentation attributes, so an icon never explodes if the stylesheet is delayed. Utility classes still win, presentation attributes lose to CSS.

Raia symbol + icon

<symbol id="raia"> lives in the shared SVG sprite at the top of index.html. The same glyph is registered in icons.js under the key raia, so both <use href="#raia"> and <svg data-icon="raia"> resolve to identical output. There is exactly one id="raia" in the document.

Accessibility aria-hidden

Decorative icons are aria-hidden="true" and carry no label. An icon that is the only content of a control gets its label from the control, never from the glyph.

05

Components

Hover states use a 1px accent hairline plus a 3–4px lift on a spring curve. Everything below is the real component, not a picture of one.

Buttons 3 levels
Badges & chips non-interactive
Stable Stable JavaScript Open Web
Field focus ring
Looks good.
Meters gradient fill
Focus82
Polish100
Switch aria-checked
Glass surface opt-in

Reserved for surfaces that sit over imagery or the Milky Way sky. Flat panels use --surface-solid and a hairline instead.

06

Card patterns

One skeleton, three surfaces. Beat Tools, AI & Bots, and Games all share the same card: index + category + status, title with icon, description, then actions. Games add a 16:9 thumbnail slot on top.

Beat Tools

  1. 01 LRC Maker Stable

    HajirSync

    Create and sync LRC lyric files quickly and easily.

  2. 02 Password Manager Stable

    Raia Vault

    Generate strong passwords and manage secure password utilities.

  3. 05 Developer Tool Stable

    Raia Minify

    Minify and optimize code or text directly in the browser.

AI & Bots

  1. 01 AI/Bot Stable

    Raia

    An AI chatbot for conversations, ideas, and useful workflows.

  2. 02 AI/Bot Stable

    Kirana

    A thoughtful AI companion for creative conversations and everyday ideas.

Games

  1. Classic Board Stable

    Chess

    Play classic chess directly in the browser.

  2. Arcade Stable

    Starfall

    Catch falling stars in this quick browser arcade game.

Chatbot rule. Raia and Kirana both sit under AI & Bots, category label AI/Bot. They are the only two items in that section, in that order. The legacy keys cat_ai_chatbot and cat_ai_tool remain in the i18n table for compatibility but are no longer referenced by the page.

Filter semantics. Filter bars use role="toolbar" with aria-pressed, not role="tab", since there is no tabpanel pairing. The demo above toggles its pressed state only; the production filter also re-renders the grid.

07

Motion & a11y

Motion is decorative. Access, contrast, and keyboard behaviour are not negotiable. Every value on this page was measured against the shipped CSS, JavaScript, and a headless browser.

Motion

  1. Reveal on scroll. One shared IntersectionObserver. Elements start 14px low and transparent, then rise over 280 ms on cubic-bezier(.22, 1, .36, 1). It runs only at 768px and wider; smaller screens show content at once. Target class is .is-visible.
  2. Transform and opacity only. Reveal, card, and button transitions animate transform, opacity, colour, and shadow. Width, height, top, left, and margin are never animated. The skip link is the sole exception, and it only appears on keyboard focus.
  3. Off-screen pausing. Hero and About animations (mesh, orbit, ticker) pause while their section is out of view. The aurora sky is fixed behind the page and is not paused.

Reduced motion

  1. Forces the eco tier. The inline head script sets data-perf="eco" before first paint when prefers-reduced-motion is on.
  2. Everything decorative stops. Reveal content shows immediately. Ticker, orbit, mesh, and aurora animations are set to animation: none, and the sky stays static. Meteors do not spawn. The cursor spotlight, hero spotlight, tilt, and magnetic buttons are off. Click ripples are off.
  3. Scrolling and counters. Smooth scrolling is disabled (scroll-behavior: auto). Stat counters show their final number at once.

Performance tiers

  1. Set before styles load. An inline script in <head> writes data-perf on <html>. Low memory, few cores, Save-Data, or reduced motion selects eco. Coarse pointers select normal. Everything else is premium.
  2. eco. Static base gradient only. The aurora script returns early, so no stars, meteors, cursor spotlight, or canvas ripples are created.
  3. normal. A lighter sky. Meteors arrive 12–25 s apart. No cursor spotlight, no tilt or magnetic effects.
  4. premium. Full sky. Meteors arrive 6–15 s apart. Cursor spotlight, hero spotlight, and tilt or magnetic buttons apply to mouse users.
  5. Scroll work is throttled. Scroll handlers run through requestAnimationFrame. Aurora parallax is limited to desktop devices that are not low-end, and it pauses while the tab is hidden.

Keyboard and screen readers

  1. Focus is always visible. :focus-visible draws a 3px accent outline with a 3px offset. It is restyled, never removed. Bare :focus has no styling.
  2. Touch targets are at least 44px tall. Buttons, toggles, filters, and drawer items were measured at 390px wide.
  3. Overlays manage focus. The drawer, documentation modal, and cookie settings move focus inside, keep Tab within the dialog, close on Escape, and return focus to the trigger. Body scroll is locked by reference count, so stacked overlays do not unlock early.
  4. Filters are a toolbar. The tool filters use role="toolbar" with aria-pressed. Arrow keys move between them.
  5. Search. Ctrl or Cmd + K focuses it. Arrow keys move through results. Escape clears the field and closes the list.
  6. Messages are announced. Field errors use role="status" with aria-live="polite", and invalid fields get aria-invalid="true". Toasts sit in a polite live region.
  7. Menu button label. Switches between Open menu and Close menu, in step with aria-expanded.
  8. Decorative layers are hidden from assistive tech. Sky, stars, grain, and canvas are aria-hidden and do not receive pointer events. Icons are aria-hidden, and icon-only controls carry their own aria-label.

Contrast (measured, WCAG 2.x)

  1. Light. Body text 12.2:1. Muted text 7.1:1. Accent text 4.9:1. White on accent button 5.7:1. Success 4.7:1. Error 5.6:1.
  2. Dark. Body text 15.1:1. Muted text 6.5:1. Accent text 10.5:1. Navy on cyan button 10.5:1. Success 6.5:1. Error 6.0:1.
  3. Floor. Body and small text must reach 4.5:1. Large text and UI borders must reach 3:1. Both themes are checked in Chromium on the live components.
08

Theming

Parity is a feature. Every token has a value in both themes and nothing is hardcoded to one.

Storage class-based

Theme lives on document.documentElement.classList as .dark and persists under localStorage['theme'], the same key on index.html and this page, so the choice carries across.

First paint no flash

A tiny inline script in <head> sets the class before CSS paints. When no choice has been saved, prefers-color-scheme decides.

Parity layout-identical

Only tokens change between modes. No layout, spacing, or component structure differs. The single exception is --on-accent, which flips for contrast.

No runtime date no live clock

The page shows no version string and no date. No new Date(), no setInterval, no live clock. Content changes only when the markup changes.

09

Cheat sheet

The tokens that define the whole system. Change one, and every surface follows.

/* ── Typography ─────────────────────────────────────── */
--fs-hero:       clamp(2.25rem, 7vw, 4.5rem);   /* hero headline   */
--fs-section:    clamp(1.75rem, 4vw, 2.25rem);  /* section titles  */
--fs-card-title: 1.05rem;                      /* card headings   */
--fs-body:       1rem;                         /* body copy       */
--fs-small:      .85rem;                       /* UI labels       */
--fs-mini:       11px;                         /* mono chips       */
--fs-micro:      10.5px;                       /* mono metadata    */
--fs-status:     10px;                         /* status badges    */

/* ── Accent split ───────────────────────────────────── */
--accent:        #945268;  /* light: text, fills */
--accent-ink:    #9A5670;  /* light: text ≥ 4.5:1 */
--accent-solid:  #9A5670;  /* light: fill          */
--on-accent:     #FFFFFF;  /* light                */

.dark {
  --accent:       #7FD8CB;
  --accent-ink:   #7FD8CB;
  --accent-solid: #7FD8CB;
  --on-accent:    #0A192F;  /* cyan is too bright  */
}

/* ── Feedback ───────────────────────────────────────── */
--ok:  #047857;   .dark { --ok:  #34D399; }
--err: #B91C1C;   .dark { --err: #F87171; }

/* ── Radii ──────────────────────────────────────────── */
--radius-card:  1.5rem;   /* glass cards        */
--radius-input: 14px;     /* fields & buttons   */
--radius-pill:  9999px;   /* pills & chips      */

/* ── Motion ─────────────────────────────────────────── */
--ease:        cubic-bezier(.25, .46, .45, .94);
--ease-spring: cubic-bezier(.34, 1.56, .64, 1);
--ease-out:    cubic-bezier(.22, 1, .36, 1);

10

Universal use

These rules apply to every Haiere web project. Each project copies the same tokens and rules. Only the content changes.

Tokens one source

Copy the :root and .dark blocks from style.css into any Haiere project. Do not rename a token. A value change in style.css reaches every project that copies the block.

Typography three families

Sora for display, Inter for body text, JetBrains Mono for code. Load them the same way in every project.

Icons SVG only

Use the SVG sprite from icons.js. No emoji, no icon fonts.

Copy both languages

Every visible string goes through i18n.js, in id and en. No version string and no date appear on any site.

Accessibility both themes

Text contrast is at least 4.5:1 in light and dark mode. Focus stays visible. Motion respects prefers-reduced-motion. Touch targets are at least 44 px.