# Aleris Brand OS

Design system and brand guidelines for Aleris (Scandinavian healthcare, Sweden / Norway / Denmark).
This file is the AI-readable index. URLs below serve raw markdown, CSS, and JSON — no HTML chrome.

Voice "den nära experten" — present, calm, precise, warm. All UI must respect tokens, hard rules, and anti-patterns.

## Start here

- https://localhost:3000/baseline/setup — Active scaffolder. Tells you what to fetch, where to write it, and gives a CLAUDE.md template.
- https://localhost:3000/baseline/raw/BASELINE.md — Hard rules, surface modes, components, motion, accessibility.
- https://localhost:3000/baseline/raw/tokens/aleris-tokens.css — Source of truth. Import into every Aleris product. No raw values anywhere else.
- https://localhost:3000/baseline/raw/tokens/baseline-tokens.json — Same tokens with usage and constraint metadata for lookup.

## Foundation (read before building)

- https://localhost:3000/foundation/raw/index.md — Brand in brief. Entry point to all Foundation pages.
- https://localhost:3000/foundation/raw/colour.md — Colour. Palette, tokens, and rules for colour use.
- https://localhost:3000/foundation/raw/typography.md — Typography. Type system, weights, and the 14px floor.
- https://localhost:3000/foundation/raw/voice.md — Voice. Den nära experten — present, calm, precise, warm.
- https://localhost:3000/foundation/raw/imagery.md — Imagery. Photography, illustration, and visual language.
- https://localhost:3000/foundation/raw/constant-contextual.md — Constant and contextual. Reasoning tool: what stays fixed, what adapts.
- https://localhost:3000/foundation/raw/emotional-modes.md — Emotional modes. Reasoning tool: anxiety, aspiration, latent anxiety.

## Patterns (use)

Reusable solutions for common interface situations.

- https://localhost:3000/baseline/raw/patterns/hero.md — Hero
- https://localhost:3000/baseline/raw/patterns/error-message.md — Error Messages
- https://localhost:3000/baseline/raw/patterns/confirmation.md — Confirmations
- https://localhost:3000/baseline/raw/patterns/empty-state.md — Empty States
- https://localhost:3000/baseline/raw/patterns/button-label.md — Button Labels
- https://localhost:3000/baseline/raw/patterns/chat-response-simple.md — Chat Responses
- https://localhost:3000/baseline/raw/patterns/chat-bubble.md — Chat Bubble

## Foundations (understand)

The colour, type, and spacing systems — and why they work the way they do.

- https://localhost:3000/baseline/raw/reference/aleris-design-tokens.md — Token Reference
- https://localhost:3000/baseline/raw/reference/baseline-token-architecture.md — Token Architecture
- https://localhost:3000/baseline/raw/reference/aleris-grids-tables-dataviz.md — Grids, Tables & Data Viz
- https://localhost:3000/baseline/raw/reference/aleris-baseline-animation.md — Animation & Motion
- https://localhost:3000/baseline/raw/reference/aleris-baseline-images.md — Images & Media

## Principles (understand)

How to think about design decisions at Aleris.

- https://localhost:3000/baseline/raw/reference/aleris-progressive-enhancement.md — Progressive Enhancement
- https://localhost:3000/baseline/raw/governance/aleris-anti-patterns.md — Anti-Patterns
- https://localhost:3000/baseline/raw/governance/aleris-privacy-jtbd-analysis.md — Privacy & JTBD

## Voice in products (understand)

How Aleris sounds and behaves in digital interfaces.

- https://localhost:3000/baseline/raw/voice/1-den-nara-experten-karnguid.md — Kärnguide
- https://localhost:3000/baseline/raw/voice/2-den-nara-experten-dokumenttyper.md — Dokumenttyper
- https://localhost:3000/baseline/raw/voice/3-den-nara-experten-digital-rost-v2.md — Digital röst & micro-copy
- https://localhost:3000/baseline/raw/governance/4-den-nara-experten-digital-behavior-v1.md — Digital Behaviour

## Governance (extend)

The decision framework, certainty levels, and how the system evolves.

- https://localhost:3000/baseline/raw/governance/aleris-design-governance.md — Design Governance
- https://localhost:3000/baseline/raw/reference/aleris-token-governance-frameworks.md — Token Governance

## Source research (extend)

The research and reasoning behind key decisions.

- https://localhost:3000/baseline/raw/source/aleris-surface-temperature-tokens.md — Surface Temperature
- https://localhost:3000/baseline/raw/source/aleris-typography-spacing-scale.md — Typography & Spacing
- https://localhost:3000/baseline/raw/source/baseline-web-view-research.md — Web View & LLM Research

## Planning & status (steward)

Work plan, open questions, implementation progress.

- https://localhost:3000/baseline/raw/planning/aleris-product-design-skill-workplan.md — Work Plan
- https://localhost:3000/baseline/raw/planning/aleris-design-system-open-questions.md — Open Questions
- https://localhost:3000/baseline/raw/planning/baseline-implementation-plan.md — Implementation Plan

## Notes for AI consumers

- Tokens are load-bearing: never use raw hex, px, or Tailwind colour classes in Aleris products.
- Foundation pages live at locale-prefixed routes for humans (e.g. /sv/identity/colour). The /foundation/raw/* URLs above are the locale-free source.
- When uncertain about a design decision, leave `/* OPEN: [decision] */` in the code rather than guessing.
- F3 Logo, F5 Writing Conventions, photography, and communication genres are not yet in the system. Ask before inventing.