Resources
Changes and open points
What changed in brand and design, when and why, and what is not yet decided or built. Honest, with sources.
The design system has a history. If you built against an earlier version, this is where you find what changed. If you are new, this is where you find the open spots. The source for everything is docs/entscheidungen.md (decision log) and docs/status.md.
Current state
The package @hey-albert/design-system is at version 0.1.0. Since 22 September the values have been frozen in tokens/quelle and are checked against tokens/referenz.
Changes
| Date | What | Why |
|---|---|---|
| 21.10.2026 | brand.heyalbert.family is created, generated from the package. regeln/regeln.json becomes the machine-readable source for words, registers, limits and design rules. Token descriptions now use proper umlauts. | One place for the team, outside experts and agents, without a second source. |
| 30.09.2026 | The website looks as it did before the move to Payload again. Payload blocks are drawn in the markup of the old generator, and stil.css is the source of the look. | The first Payload version looked visibly different. |
| 22.09.2026 | Tokens as code: source in W3C format, Style Dictionary generates CSS, a Tailwind theme and Swift. Ten shadcn primitives on our roles, sixteen website blocks, Storybook, visual regression, brand QA. Seven new roles for hover and pressed states. | Values still sat as hex in components.css and Karte.jsx. Now a hex value exists only in the source. |
| 20.09.2026 | Group components/hq with Satellit and Trichter. | HQ got components that are built in the system first and then in the app. |
| 19.09.2026 | Monorepo: the system lives in packages/design-system. The web app takes tokens and fonts from the package. Rahmen.tsx is LeisteMac plus Kopfzeile for app and HQ. | One frame, one source, nothing built twice. |
| 04.09.2026 | The design system from Claude Design becomes the only source. Old tokens, old screens and the first brand site go to the archive. The four fonts are downloaded and served locally. | Two sources are a fork. Fonts from Google’s servers pass on every visitor’s IP address. |
| 04.09.2026 | Website and app share one palette. The old palette from the homepage blueprint no longer applies. | A separate token set for the website is ruled out. |
| 02.09.2026 | The colour world of the A2 screen sets becomes the app: warm cream, a black sidebar, pink as accent, beige cards, yellow for family, blue for drives. | The founder’s decision after the last screen sets. |
| 31.08.2026 | „Disabled“ becomes a computed role instead of opacity. | Opacity multiplies with the background, so no contrast figure holds. |
| 30.08.2026 | The mark is a tangle with eyes, also as favicon. Mascot and brand mark are two different jobs. | Albert does not tidy life up. He keeps the overview while it goes on. |
| 30.08.2026 | Fonts are served locally. | Ruling of the Munich Regional Court of 20.01.2022 on Google Fonts. |
| 28.08.2026 | The „Notizbuch“ (notebook) world is set: paper, ink, sticky notes, no shadows. The signal colour belongs to no person. | Seven design worlds were compared. |
| 23.08.2026 | Foundation of ink on paper, hairlines, an 8 px grid, no elevation system. | A kitchen calendar, a binder and the yearbook are all paper. |
Open points
Every point has been checked against the files, as of 21 October.