# 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.

## Concepts

- https://brand.dev.aleris.ai/explore/story.md — Story (accepted). Every source file for this concept, in order.
- https://brand.dev.aleris.ai/explore/colour.md — Colour (accepted). Every source file for this concept, in order.
- https://brand.dev.aleris.ai/explore/typography.md — Typography (accepted). Every source file for this concept, in order.
- https://brand.dev.aleris.ai/explore/logo.md — Logo (accepted). Every source file for this concept, in order.
- https://brand.dev.aleris.ai/explore/imagery.md — Imagery (accepted). Every source file for this concept, in order.
- https://brand.dev.aleris.ai/explore/icons.md — Icons (accepted). Every source file for this concept, in order.
- https://brand.dev.aleris.ai/explore/voice.md — Voice (accepted). Every source file for this concept, in order.
- https://brand.dev.aleris.ai/explore/reader-state.md — Reader state (accepted). Every source file for this concept, in order.
- https://brand.dev.aleris.ai/explore/digital-products.md — Digital products (accepted). Every source file for this concept, in order.

## Routes

- https://brand.dev.aleris.ai/create/presentations.md — Presentations (partial guidance). A brief for an AI tool.
- https://brand.dev.aleris.ai/create/patient-information.md — Patient information (partial guidance). A brief for an AI tool.
- https://brand.dev.aleris.ai/create/web-pages.md — Web pages (partial guidance). A brief for an AI tool.
- https://brand.dev.aleris.ai/create/campaigns-and-social.md — Campaigns and social (partial guidance). A brief for an AI tool.
- https://brand.dev.aleris.ai/create/digital-products.md — Digital products (full guidance). A brief for an AI tool.
- https://brand.dev.aleris.ai/create/working-with-ai.md — Working with AI (full guidance). A brief for an AI tool.

## Answers

- https://brand.dev.aleris.ai/answers.md — Passed answers to what colleagues ask, each with its reason and sources.

## Start here

- https://brand.dev.aleris.ai/baseline/raw/setup.md — Active scaffolder. Tells you what to fetch, where to write it, and gives a CLAUDE.md template.
- https://brand.dev.aleris.ai/baseline/raw/BASELINE.md — Hard rules, surface modes, components, motion, accessibility.
- https://brand.dev.aleris.ai/baseline/raw/tokens/aleris-tokens.css — Source of truth. Import into every Aleris product. No raw values anywhere else.
- https://brand.dev.aleris.ai/baseline/raw/tokens/baseline-tokens.json — Same tokens with usage and constraint metadata for lookup.
- https://brand.dev.aleris.ai/baseline/raw/tokens/aleris-tailwind.css — Optional Tailwind v4 theme bridge. Maps utility names onto the tokens; declares no value of its own.

## Foundation (read before building)

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

## Patterns (use)

Reusable solutions for common interface situations.

- https://brand.dev.aleris.ai/baseline/raw/patterns/hero.md — Hero
- https://brand.dev.aleris.ai/baseline/raw/patterns/error-message.md — Error Messages
- https://brand.dev.aleris.ai/baseline/raw/patterns/confirmation.md — Confirmations
- https://brand.dev.aleris.ai/baseline/raw/patterns/empty-state.md — Empty States
- https://brand.dev.aleris.ai/baseline/raw/patterns/button-label.md — Button Labels
- https://brand.dev.aleris.ai/baseline/raw/patterns/chat-response-simple.md — Chat Responses
- https://brand.dev.aleris.ai/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://brand.dev.aleris.ai/baseline/raw/reference/aleris-design-tokens.md — Design Token — Schema
- https://brand.dev.aleris.ai/baseline/raw/principles/design-tokens.md — Design Tokens — Why
- https://brand.dev.aleris.ai/baseline/raw/reference/aleris-grids-tables-dataviz.md — Grids, Tables & Data Viz
- https://brand.dev.aleris.ai/baseline/raw/reference/aleris-baseline-animation.md — Animation & Motion
- https://brand.dev.aleris.ai/baseline/raw/reference/aleris-baseline-images.md — Images & Media

## Principles (understand)

How to think about design decisions at Aleris.

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

## Voice in products (understand)

How Aleris sounds and behaves in digital interfaces.

- https://brand.dev.aleris.ai/baseline/raw/voice/1-den-nara-experten-karnguid.md — Kärnguide
- https://brand.dev.aleris.ai/baseline/raw/voice/2-den-nara-experten-dokumenttyper.md — Dokumenttyper
- https://brand.dev.aleris.ai/baseline/raw/voice/3-den-nara-experten-digital-rost-v2.md — Digital röst & micro-copy
- https://brand.dev.aleris.ai/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://brand.dev.aleris.ai/baseline/raw/governance/aleris-design-governance.md — Design Governance

## Fonts

Museo Sans is hosted centrally at https://brand.dev.aleris.ai/fonts/aleris-fonts.css

To use in any Aleris web project, add:
  <link rel="preconnect" href="https://brand.dev.aleris.ai" crossorigin>
  <link rel="stylesheet" href="https://brand.dev.aleris.ai/fonts/aleris-fonts.css" crossorigin>

Link, never copy. The reason is drift rather than licence: a copied font file is a copy nobody tracks. Font serving is CORS-restricted to Aleris-controlled domains by our own configuration, not by a term of the webfont licence.

## Notes for AI consumers

- Tokens are load-bearing: never use raw hex, px, or Tailwind colour classes in Aleris products.
- Concept pages are readable for humans at https://brand.dev.aleris.ai/explore/<concept> (e.g. https://brand.dev.aleris.ai/explore/colour). One locale is served, English, with no prefix. The bundles above are the same concepts as markdown, with every source file they rest on.
- When uncertain about a design decision, leave `/* OPEN: [decision] */` in the code rather than guessing.
- Not yet in the system: the logo and identity page, writing conventions, communication genres, print, and any component library. Ask before inventing.