# Änderungen und offene Punkte

> Was sich an Marke und Gestaltung wann und warum geändert hat, und was noch nicht entschieden oder nicht gebaut ist. Ehrlich, mit Quelle.

Quelle: https://brand.heyalbert.family/aenderungen/ · Hey Albert Marke und Designsystem

Das Designsystem hat eine Geschichte. Wer gegen ein früheres System gebaut hat, findet hier, was sich geändert hat. Wer neu dazukommt, findet die offenen Stellen. Quelle für alles: `docs/entscheidungen.md` und `docs/status.md`.

## Stand

Das Paket `@hey-albert/design-system` trägt die Version 0.1.0. Die Werte sind seit dem 22. September in `tokens/quelle` eingefroren und werden gegen `tokens/referenz` geprüft.

> **Offen**
>
> Am 31. August galt eine Regel für die Versionsnummer: groß, wenn ein Wert wandert oder ein Token verschwindet; mittel, wenn etwas dazukommt; klein, wenn sich nur Text ändert. Diese Regel stand im Vorgänger und ist nicht ins Paket übernommen. Die Nummer 0.1.0 sagt deshalb noch nichts.

## Änderungen

| Datum | Was | Warum |
|---|---|---|
| 21.10.2026 | brand.heyalbert.family entsteht, erzeugt aus dem Paket. `regeln/regeln.json` wird die maschinenlesbare Quelle für Wörter, Register, Grenzen und Gestaltungsregeln. Token-Beschreibungen tragen echte Umlaute. | Ein Ort für Team, externe Fachleute und Agenten, ohne zweite Quelle. |
| 30.09.2026 | Die Website sieht wieder aus wie vor der Umstellung auf Payload. Payload-Blöcke werden im Markup des alten Generators gezeichnet, `stil.css` ist die Quelle des Aussehens. | Die erste Payload-Fassung wich sichtbar ab. |
| 22.09.2026 | Tokens als Code: Quelle im W3C-Format, Style Dictionary erzeugt CSS, Tailwind-Theme und Swift. Zehn shadcn-Primitive auf Rollen, sechzehn Website-Blöcke, Storybook, Bildvergleiche, Brand-QA. Sieben neue Rollen für Zeiger- und Druckzustände. | Werte standen noch als Hex in `components.css` und `Karte.jsx`. Jetzt steht ein Hex-Wert nur in der Quelle. |
| 20.09.2026 | Gruppe `components/hq` mit `Satellit` und `Trichter`. | Das HQ bekam Bauteile, die erst im System entstehen und dann in der App. |
| 19.09.2026 | Monorepo: das System liegt als `packages/design-system`. Die Web-App holt Tokens und Schriften aus dem Paket. `Rahmen.tsx` ist `LeisteMac` und `Kopfzeile` für App und HQ. | Ein Rahmen, eine Quelle, nichts zweimal gebaut. |
| 04.09.2026 | Das Designsystem aus Claude Design wird die einzige Quelle. Waldtinte-Tokens, alte Schirme und die erste Brand-Seite gehen ins Archiv. Die vier Schriften werden heruntergeladen und lokal ausgeliefert. | Zwei Quellen sind eine Gabelung. Schriften von Google-Servern geben die IP-Adresse jedes Besuchers weiter. |
| 04.09.2026 | Website und App teilen eine Palette. Die alte Palette aus dem Homepage-Blueprint gilt nicht mehr. | Ein eigener Token-Satz für die Website ist ausgeschlossen. |
| 02.09.2026 | Die Farbwelt der A2-Screensets wird die App: warmes Creme, schwarze Leiste, Rosa als Akzent, beige Karten, Gelb für Familie, Blau für Fahrten. | Entscheidung des Gründers nach den letzten Screensets. |
| 31.08.2026 | „Inaktiv“ ist eine gerechnete Rolle statt Deckkraft. | Deckkraft multipliziert sich mit dem Untergrund, dann stimmt keine Kontrastzahl. |
| 30.08.2026 | Das Zeichen ist ein Knäuel mit Augen, auch als Favicon. Maskottchen und Markenzeichen sind zwei Aufgaben. | Albert räumt das Leben nicht auf, er behält den Überblick, während es weitergeht. |
| 30.08.2026 | Schriften werden lokal ausgeliefert. | Urteil des LG München I vom 20.01.2022 zu Google Fonts. |
| 28.08.2026 | Die Welt „Notizbuch“ ist gesetzt: Papier, Tinte, Klebezettel, keine Schatten. Die Signalfarbe gehört keiner Person. | Sieben Gestaltungswelten wurden verglichen. |
| 23.08.2026 | Grundlage Tinte auf Papier, Haarlinien, 8-px-Raster, kein Elevationssystem. | Ein Küchenkalender, ein Aktenordner und das Jahresbuch sind Papier. |

## Offene Punkte

Jeder Punkt ist gegen die Dateien geprüft, Stand 21. Oktober.

### Gestaltung

> **Zeichensatz unbestätigt**
>
> Die 47 Zeichen in `assets/icons` sind Lucide. Das war eine Substitution, weil kein eigener Satz vorlag. Die Substitution ist weder bestätigt noch getauscht. Die App soll bis dahin SF Symbols tragen.

> **Logo nur als PNG**
>
> Das Logo liegt in fünf PNG-Fassungen vor, eine Vektorfassung fehlt. `docs/22` nennt Vektoren für App-Symbol und Favicon in `design/assets/quelle`. Dieser Ordner liegt nicht im Repository, und laut `docs/22` sind diese Vektoren noch dunkelgrün statt Tinte und Rosa.

> **Zweittext auf Karte unter 4,5:1**
>
> `docs/entscheidungen.md` sagt am 4. September: `--grau` wurde auf einen dunkleren Wert korrigiert, damit Zweittext auf Karte 4,5:1 erreicht. In `tokens/quelle` steht noch der alte Wert. Gerechnet ergibt `grau` auf `karte` 4,41:1. Dasselbe gilt für `--text-inaktiv`: die Korrektur auf 3,0:1 ist beschlossen, in der Quelle steht der Wert mit 2,47:1 auf `grund`. Beide Werte brauchen eine Entscheidung und dann `pnpm tokens`.

> **Personenlinien unter 3:1**
>
> Die Linien in Personenfarbe erreichen im hellen Modus auf `grund` nur 1,67:1 bis 2,85:1. Im dunklen Modus liegen sie über 8:1. Das System verspricht 3:1 für diese Linien nicht. Initiale und Name tragen die Person mit. Sollen Linien allein tragen, braucht es dunklere Stufen.

> **Kontraste gerechnet, nicht gemessen**
>
> Alle Kontrastwerte auf dieser Seite und in `guidelines/farben-kontrast.html` sind nach WCAG gerechnet. Gemessen mit einem Prüfgerät auf echten Bildschirmen wurde nichts.

> **Ohne Vorlage im System**
>
> Für iPad, Watch, Safe, Finanzen, Album, Jahresbuch und die Sonntagsrunde als eigene Fläche gibt es keine Vorlage im Designsystem. Die Screens der Website zeigen einige davon. Diese Screens sind aber Vorlagen für die Vermarktung, keine abgenommenen Flächen. Die Kapitel zu den Screens kennzeichnen ihre Anatomie deshalb als Vorschlag.

> **Bilder der Homepage**
>
> Drei Tuschezeichnungen, das Foto des Gründers und ein Foto des gedruckten Jahresbuchs fehlen. Die Bauteile zeigen dort `Bildplatz`.

### Sprache

> **Fünftes Register**
>
> `docs/21` und der Skill `texten` nennen den **Briefeschreiber** als fünftes Register. Das Designsystem (`guidelines/sprache.html`, `readme.md`) nennt den **Flüsterer** für Watch und Mitteilungen. Bis zur Entscheidung gilt `docs/21`. Der Flüsterer ist eine Längengrenze von sieben Wörtern.

> **Wortlisten an mehreren Orten**
>
> `regeln/regeln.json` ist seit heute die Quelle für verbotene Wörter. `skripte/qa.mjs` hat noch eine eigene Liste, `tooling/check-sprache.py` eine dritte. Beide lesen `regeln.json` noch nicht.

### Werkzeuge

> **Zwei Prüfer brechen ab**
>
> `tooling/check-sprache.py` sucht das Modul `sprache`, `tooling/check-kontrast.py` das Modul `albert_tokens`. Beide lagen im Vorgänger unter Pfaden, die es hier nicht gibt. `pnpm qa` und `pnpm tokens:diff` laufen grün.

> **Alte Pfade in Regeln und Prüfer**
>
> `.claude/rules/design-tokens.md`, der Agent `design-pruefer` und `docs/22` §1 und §10 nennen noch `design/system/` und `Scripts/`. Die Quelle ist heute `packages/design-system`, der Ablauf zum Ändern steht im Kapitel [Wie wir entwickeln](/entwickeln/).

> **Noch nicht eingebunden**
>
> `swift/Tokens.swift` ist erzeugt, aber in keinem Xcode-Projekt eingebunden: `apps/apple` enthält bisher nur ein README. `apps/web` benutzt Tokens und eigene Bausteine, aber noch nicht das Tailwind-Theme und die shadcn-Primitive des Pakets.

### Rechtliches

> **Nutzungsbedingungen**
>
> Wer Logos und Screens wofür benutzen darf, ist nicht schriftlich geregelt. Der Vorschlag steht unter [Downloads](/downloads/).
