Projekt

Das Gesicht von Europas führender KI-Studierendeninitiative neu bauen

Ich habe das Redesign von tum-ai.com geleitet, den TUM.ai-Brand-Guide in ein getestetes Designsystem und ein npm-UI-Kit übersetzt und damit die nächsten TUM.ai-Seiten günstig gemacht.

15 Min. Lesezeit11.11.2026
Screenshot der neu gestalteten TUM.ai-Startseite: die Überschrift „Germany's leading AI student initiative." in Hellviolett auf dunklem Lila, eine Zeile über 150+ Studierende von 30+ Universitäten, zwei Buttons und eine große A-Form mit dem Foto eines vollen Hörsaals.

Die TUM.ai-Website hatte ein Zahlenproblem. Die Apply-Seite sprach von „über 90 aktiven Mitgliedern". Die Startseite sagte im Einleitungstext dasselbe, während eine Statistikzeile in derselben Datei „400+" Alumni und „33+" Nationalitäten nannte. Die Partnerseite sprach von 150 aktiven Mitgliedern und 850 Alumni. Niemand hat absichtlich geflunkert. Jede Zahl wurde in die Datei getippt, die gerade jemand bearbeitet hat, und keine wusste von den anderen.

Ich habe das Redesign von tum-ai.com geleitet, wo ich Head of Software Development bin. Jede Seite wurde auf einem Designsystem neu gebaut, übersetzt aus dem Brand Guide 2026 von TUM.ai, und aus diesem Designsystem wurde @tum.ai/ui-kit, ein npm-Paket. Die Website, der Summit und der Makeathon laufen schon darauf.

Ein guter Teil dieses Posts handelt davon, was unterwegs schiefging: gemeinsame Komponenten, die nachgebaut statt benutzt wurden, Screenshot-Tests, die in beide Richtungen gelogen haben, und eine aufgeräumte Architekturregel, die der Bundler still bestraft hat. Der andere Teil ist das Design und was es später zurückzahlt: Die Makeathon- und die Summit-Seite starten vom selben Kit statt bei null, und die Summit-Seite hat jemand gebaut, der vorher nie am Kit mitgearbeitet hatte.

Eine Regel, die niemand vergessen kann

Die Mitgliederzahlen waren das sichtbarste Symptom, aber nicht das einzige. Die alte Seite mischte Standard-Grau- und Lilatöne von Tailwind in die Markenfarben, hatte globale button- und a-Styles ohne Layer, gegen die Komponenten mit !important ankämpften, ließ Animationen auch für Besucher laufen, die reduzierte Bewegung eingestellt hatten, und baute ihr FAQ aus klickbaren divs. Jedes davon ist klein. Zusammen sehen sie so aus, wie eine Seite aussieht, die über Jahre von vielen Leuten bearbeitet wurde, die jeweils die Seite vor sich repariert haben.

Allein die URL der Seite stand 26-mal in einer einzigen SEO-Datei. So sahen die Mitgliederzahlen aus:

tsx
1// src/components/apply/About.tsx
2diverse group of over 90 active members, each with technical skills
3
4// src/components/home/AboutSection.tsx
5const STATS = [
6 { title: "Alumni Members", value: "400+" },
7 { title: "Nationalities", value: "33+" },
8 ...
9];
10With over 90 active members, TUM.ai empowers the next generation
11
12// src/data/partners.ts
13{ value: "1000+", label: "Official members", detail: "150 active, 850 alumni" },

Die Zahlen einmal zu korrigieren hätte bis zur nächsten Änderung gehalten. Deshalb leben sie jetzt an einem Ort, im siteSettings-Dokument in Sanity, wo man sie im Studio ändern kann, ohne Code anzufassen. Seiten und strukturierte Daten lesen sie von dort. Der Code legt nur ihre Form fest und leitet den Rest ab, etwa die Gesamtmitgliederzahl:

typescript
1// src/config/site-settings-content.ts: one CMS document holds the figures
2export const SITE_SETTINGS_QUERY = defineQuery(`*[_type == "siteSettings"][0]{
3 organization{foundingYear, activeMembers, alumni, majors, universities, nationalities, ...},
4 ...
5}`);
6
7// src/config/organization.ts: code derives from them, it never stores them
8/** Everyone who has been an official member: active members plus alumni. */
9export function officialMembersOf(
10 facts: Pick<OrganizationFacts, "activeMembers" | "alumni">,
11): number {
12 return facts.activeMembers + facts.alumni;
13}
14
15// Editable copy names a figure by placeholder, {{org.activeMembers}},
16// and the page fills it in when it renders.

Die zweite Hälfte sorgt dafür, dass es so bleibt. Ein Guard-Test durchläuft jede Quelldatei und schlägt fehl, wenn er einen Fakt findet, der direkt in Seitencode getippt wurde: „N active members", eine Rollen-E-Mail, einen Social-Link, eine Bewerbungsformular-URL. Seine Allowlist kann nur schrumpfen, und der Test sagt selbst, was zu tun ist, wenn er fehlschlägt: den Wert von dort lesen, wo er lebt, statt das Muster stummzuschalten.

Das ist die erste Lektion, und der Rest des Posts kommt immer wieder auf sie zurück. Ein Satz in einem Contributing-Guide ist ein Vorschlag. Ein fehlschlagender Check mit einer Meldung, die die richtige Datei nennt, ist eine Regel.

Kein Neuanfang bei null

Die Seite hat eine längere Geschichte als dieses Redesign. Die ursprüngliche tum-ai/website lief auf Next.js mit einer three.js-Szene und Inhalten aus Notion. Ihre Nachfolgerin website_new startete als React 19 auf Vite. Jakob Friedrich hat sie auf Next.js umgezogen, Benjamin Hadizamani ihre Inhalte nach Sanity, und das Team, das ihre Seiten gebaut hat, ist der Grund, warum es überhaupt etwas zum Redesignen gab. Meine eigene Arbeit daran begann im September mit einer Auffrischung der E-Lab-Seite und einer neu gebauten Partnerseite. Die Partnerseite legte die Latte höher als der Rest der Seite, und das Redesign war der Versuch, jede andere Seite auf dieses Niveau zu bringen.

Vom Brand Guide zum System

Auch der Look hatte eine Quelle. TUM.ai hat einen Brand Guide für 2026: 17 Folien mit sechs Farben und einem Verlauf, der Schrift Manrope in vier Schnitten, einem Konstruktionsraster für das Logo und Kapitelfolien, auf denen ein riesiges, blasses „A" aus der Bildmarke den Hintergrund füllt. Was er nicht sagt: wie ein Hover-Zustand aussieht, welches Grau auf ein dunkles Band gehört oder ob weißer Text auf dem Markenviolett auf einem Button lesbar ist. Ein Brand Guide beschreibt, wie TUM.ai aussieht. Eine Website braucht viele kleine Entscheidungen, die die Folien nie treffen mussten.

Der erste Schritt war also, die Farben des Guides in Tokens zu übersetzen: benannte Werte, die der Code verwenden kann. Die Markenfarben wurden zu festen Punkten auf einer Violett-Skala, die Abstufungen dazwischen wurden daraus abgeleitet. Dann kam die erste echte Entscheidung: Weißer Text auf dem Markenviolett Electric Lavender ist schwer zu lesen. Er erreicht einen Kontrast von etwa 4:1, der Barrierefreiheitsstandard WCAG AA verlangt 4,5:1. Primäre Buttons nutzen deshalb die nächstdunklere Stufe, #8052C2, mit 5,4:1. Eine Farbe stammt gar nicht aus dem Guide: Das Fast-Schwarz #0D0214 hinter dem Footer kam im Code für den dunkelsten Hintergrund dazu.

Die größere Idee ist das Tone-Band. Eine Seite ist eine Folge von Bändern in voller Breite, und jedes Band setzt einen von sechs Farbtönen. Komponenten wählen nie selbst eine Farbe. Sie fragen das Band nach seinen Farben für Text, gedämpften Text, Haarlinien und Akzente, deshalb funktioniert dieselbe Karte auf einem weißen Leseband und auf einem dunklen Indigo-Hero. Darum gibt es auch keinen eigenen Dark Mode: Die dunklen Bänder sind der Dark Mode. Wo zwei helle oder zwei dunkle Bänder aufeinandertreffen, blendet das untere weich ein. Wo Hell auf Dunkel trifft, bleibt die Kante absichtlich hart.

Die sechs Tone-Bänder in @tum.ai/ui-kit. Jedes Paar aus Text und Hintergrund erfüllt WCAG AA.
BandFlächeTextEinsatz
paperWeiß#FFFFFFDark IndigoStandard-Leseband
mistMinimal Grey#EFEFEFDark IndigoAlternatives helles Band
lavenderLavender Tint#F5EFFFDark IndigoSanfte Betonung, Formulare, FAQs
inkDark Indigo#1B0049WeißHeroes, Feature-Bänder, Calls to Action
nightMarkenschwarz, nicht im Guide#0D0214WeißStarker Kontrast, Footer
violetElectric Lavender#9A64D9MarkenschwarzNur große Schrift, sparsam

Schrift und Form folgen demselben Muster: Nimm, was der Guide zeigt, und mach eine Regel daraus. Der Guide setzt seine H1 auf 120 Punkt, und das Brand-Dokument des Kits verlangt „große Überschriften in leichtem Schnitt", also skaliert die größte Display-Größe bis 8rem bei Schriftstärke 300 mit enger Laufweite. Der Guide setzt Labels wie „Primary Logo" in gemischter Schreibung, nie in Versalien, also bekommen auch die Dachzeilen im Kit nie Versalien. Sogar die Signature-Ecke des Guides, ein großer Radius und drei kleine, ist jetzt eine Utility-Klasse.

Der Hero der Startseite nimmt das große blasse A aus den Kapitelfolien und macht daraus ein Fenster: Eventfotos blenden innerhalb der Bildmarke langsam ineinander über, wörtlicher lässt sich „Unsere Fotos holen dich in den Raum" aus dem Guide kaum umsetzen. Die Konstruktionslinien im Hero brauchen exakte Geometrie, deshalb zeichnet sein Konstruktionsblatt ein eigenes, spiegelsymmetrisches A, mit den Füßen dort, wo die offizielle Marke sie hat, und ein Test prüft, dass jeder Hilfskreis den Strich berührt, zu dem er gehört. Der Header behält die gelieferte Logodatei.

Bewegung folgt dem Charakter des Guides, wie ihn das Brand-Dokument des Kits zusammenfasst: präzise, selbstbewusst, ruhig und lebendig, wobei lebendig „kleine, gezielte Bewegung, die immer optional ist" bedeutet. Im Code sind das eine hauseigene Easing-Kurve, fünf benannte Dauern und Ambient-Loops, die für Besucher mit eingestellter reduzierter Bewegung gar nicht erst laufen.

Dann kommt der Teil, der zurück zu den Mitgliederzahlen führt. Im Kit setzen Checks die Markenregeln durch. Eine Lint-Regel lehnt rohe Hex-Werte und die Standardpaletten von Tailwind ab, eine andere Animationen, die an den Motion-Tokens vorbeigehen, und ein Test schlägt fehl, wenn die Text-, Akzent- oder Fokusfarbe eines Tone-Bands unter WCAG AA fällt. Die Website selbst verlässt sich dafür noch auf geschriebene Regeln und Design-Reviews, die strenge Version der Regel lebt also im Kit, wo ohnehin der Großteil des Stylings wohnt. Eine Regel lässt sich nicht linten, und das Brand-Dokument des Kits sagt sie direkt: „Wenn ein Design anfängt, wie ein generisches SaaS-Template auszusehen, vereinfache es."

Was sich auf dem Bildschirm geändert hat

So sieht dieses System auf den Seiten aus. Jede Seite steht jetzt darauf, und Akkordeons, Dialoge und das mobile Menü basieren auf Base UI, sodass Tastatur- und Screenreader-Verhalten aus einer Bibliothek kommen statt aus handgeschriebenen Handlern. Zum Vergleichen den Trenner ziehen.

Die neu gestaltete TUM.ai-Startseite in Desktopbreite: eine große hellviolette Überschrift „Germany's leading AI student initiative.", eine kurze Zeile mit Mitgliederzahlen, zwei Pill-Buttons, eine große A-Form mit einem Hörsaalfoto und eine Reihe von Partnerlogos.Die bisherige Startseite von tum-ai.com in Desktopbreite: ein dunkler Hero mit abgedunkeltem Fotoraster, das TUM.ai-Logo, der Satz „Germany's leading student initiative focused on Artificial Intelligence" und zwei Buttons.
Die Startseite, links vom Trenner die alte Seite und rechts die neue.
Die neu gestaltete TUM.ai-Startseite auf dem Smartphone: die neue Überschrift in drei Zeilen, die Mitgliederzahlen und zwei untereinander gestapelte Pill-Buttons.Die bisherige Startseite von tum-ai.com auf dem Smartphone: ein großes TUM.ai-Logo, der Slogan und zwei untereinander gestapelte Buttons auf dunklem Hintergrund.
Dasselbe bei 390 px. Die Mitgliederzahlen in der Einleitung kommen jetzt aus den CMS-Einstellungen von oben.

Die Startseite ist nur eine Seite. Hier sind vier weitere, alt links vom Trenner und neu rechts.

Die neu gestaltete Research-Seite: eine große hellviolette Überschrift, eine Zeile über Veröffentlichungen bei NeurIPS, ICML und ICLR, zwei Buttons und ein gepunkteter Globus mit München.Die bisherige Research-Seite: eine schlichte Überschrift, zwei Filter-Tabs und eine Reihe von Projektkarten mit uneinheitlichen Illustrationen.
Research: Aus einer Reihe uneinheitlicher Karten werden eine klare Aussage und eine Karte, wo die Arbeit passiert.
Die neu gestaltete E-Lab-Seite: der E-Lab-Schriftzug, die Überschrift „12 weeks from kickoff to the Final Pitch.", eine kurze Beschreibung und eine gepunktete Karte.Die bisherige E-Lab-Seite: ein großer E-LAB-6.0-Schriftzug auf violettem Verlauf mit einem Hinweis auf geschlossene Bewerbungen.
E-Lab: Der Logo-Auftritt macht Platz für das, was das Programm tatsächlich ist.
Die neu gestaltete Community-Seite: die Überschrift „The people who run TUM.ai.", Mitgliederzahlen, zwei Buttons und ein Gruppenfoto.Die bisherige Community-Seite: ein „Member Journey"-Diagramm aus Kästen, verbunden durch geschwungene Linien.
Community: Statt eines Prozessdiagramms stehen die Menschen und ihre Zahlen im Mittelpunkt.
Die neu gestaltete Bewerbungsseite: die Überschrift „Call for members.", das Bewerbungsfenster für das Wintersemester und eine Zeitleiste mit Deadline, Interviews und Onboarding-Wochenende.Die bisherige Bewerbungsseite: eine „Join Us"-Überschrift, ein Absatz und ein großes TUM.ai-Logo.
Apply: Statt eines Logos stehen oben die Termine, die Bewerberinnen und Bewerber wirklich brauchen.
Bild wird geladen...
Die neue Hackathons-Seite: die Überschrift „We run the Makeathon. We founded the EHL.", Buttons für beide Events, das Datum des nächsten Events und eine Balken-Zeitleiste vergangener Hackathons seit 2021.
Hackathons: eine Seite, die es auf der alten Website nicht gab.

Eine Struktur, mit der der Bundler einverstanden ist

Vorher war der Code einer Seite über fünf Ordner auf oberster Ebene verteilt. Die E-Lab-Seite hatte eine Route in src/app, ihre View in src/views, Abschnitte in src/components/e-lab, Inhalte in src/data/e-lab und Helfer in src/lib. Jetzt ist jede Domäne ein Feature-Ordner, und Routen bleiben dünn:

text
1// before: main
2src/
3├── app/e-lab/page.tsx
4├── views/headerPages/e-lab/ELab.tsx
5├── components/e-lab/TimeLine.tsx, Testimonials.tsx, ...
6├── data/e-lab/FAQ.tsx, e-lab.tsx, ...
7└── lib/
text
1// after: the redesign and cleanup branch
2src/
3├── app/(site)/e-lab/page.tsx // imports exactly one page module
4├── features/e-lab/
5│ ├── e-lab-page.tsx
6│ ├── hero.tsx, venture-trace.tsx, ... (+ tests beside them)
7│ ├── data/faq.ts
8│ └── server.ts // CMS content getters, server-only
9├── components/shell/ // header, footer
10├── config/ // site facts: organization.ts, e-lab.ts, ...
11└── lib/

Schichten sind leicht zu zeichnen und leicht zu ignorieren, deshalb sind sie ein Test. src/architecture.test.ts liest jeden Import aus dem TypeScript-Syntaxbaum und prüft ihn gegen eine Tabelle: Eine Route darf das Seitenmodul ihres Features importieren, ein Feature die Shell, Config und Lib, Config nur Config und Lib. Ausnahmen gibt es keine. Ein Import, der eine Regel bricht, ändert entweder den Code oder bewusst die Regel.

Die erste Version dieser Tabelle hatte eine Regel, die sauberer aussah: Jedes Feature stellt seine Seiten über ein index.ts-Barrel bereit. Die Messung hat sie nicht überlebt. Turbopack behält jedes re-exportierte Modul, das Client-Islands oder einen CSS-Import hat, also lieferte die Startseite die interaktiven Teile der Partnerseite in einem 54-KB-Chunk mit, und die Rechtsseiten trugen 17,7 KB, die sie nie brauchten. Die Regel wurde zu „eine Route importiert genau ihr Seitenmodul", und am Ende hatte jede Seite 18,6 KB weniger JavaScript.

Screenshots sind ein Test, den man bauen muss

Jede Route hat Screenshot-Baselines bei 390 und 1440 px in Chromium und WebKit. Ich hatte erwartet, dass das der einfache Teil wird. War es nicht.

  • Sie waren zu schwer. Die ersten Baselines wogen 90 MB, bis zu 5,4 MB für einen einzigen ganzseitigen Screenshot, und WebKit hat dieselben Fotos zwischen zwei Läufen unterschiedlich dekodiert. Fotos und Filmkorn werden beim Aufnehmen jetzt ausgeblendet, das hat den Vergleich stabil gemacht und den Satz auf 44 MB verkleinert.
  • Der Schwellenwert hat gelogen. 0,1 % klingt streng, erlaubt auf einer langen Seite aber Tausende geänderte Pixel. Der Wechsel auf feste 100 Pixel pro Screenshot hat sofort neun Baselines aufgedeckt, die unbemerkt abgedriftet waren.
  • Sie sind trotzdem veraltet. Als die Website aufs Kit umgezogen ist, passten alle 48 eingecheckten Screenshots des älteren Branches nicht mehr zum aktuellen Rendering, und der Capture-Bot hatte einige Animationen mittendrin erwischt, eine halb gezeichnete Timeline und einen Globus vor seinen Punkten. Die mussten von Hand repariert werden.

Baselines entstehen jetzt nur noch in der CI, ausgelöst durch ein Label, nie auf einem Laptop. Visual Regression ist ein echter Test, aber einer, den man wie jeden anderen entwerfen muss.

Noch ein kontraintuitives Ergebnis: Mehr CI-Shards haben die Pipeline langsamer gemacht. Jeder Shard braucht etwa anderthalb Minuten für Setup und seinen eigenen Build, also hat weiteres Aufteilen einen Lauf von 3:56 auf über 4:15 gebracht. Parallelität hat Fixkosten.

Das Kit herauslösen

Das langfristige Ziel war immer ein Designsystem für jede TUM.ai-Seite, nicht nur für die Website. Sobald die Website eines hatte, habe ich es deshalb in @tum.ai/ui-kit ausgelagert, ein MIT-lizenziertes Paket auf Basis von Base UI mit Releases über Changesets. Jede Seite bekommt jetzt dieselben Buttons, Tone-Bänder und denselben Header, ohne sie zu kopieren.

Ich wollte es nicht auf Vertrauen herauslösen. Zwölf repräsentative Komponenten mussten bei 320, 390, 768 und 1440 px innerhalb und außerhalb der Website identische Screenshots liefern, eine gepackte Kopie des Pakets musste in einer frischen Next.js-App funktionieren, und jede Storybook-Story läuft mit strengen axe-Checks. Das Verifikationsdokument sagt auch ehrlich, was es nicht beweist: nicht jede mögliche Kombination und keinen Durchlauf mit VoiceOver oder auf einem echten iPhone.

Das FAQ zeigt, was der Umzug ins Kit gebracht hat. Das ist das alte: ein div mit onClick, ohne Button-Semantik, ohne aria-expanded, für die Tastatur unerreichbar:

tsx
1{faq.map((faqItem, index) => (
2 <div key={index}>
3 <div onClick={() => setOpenFaqIndex(openFaqIndex === index ? null : index)}>
4 <p>{faqItem.question}</p>
5 <svg>{/* chevron */}</svg>
6 </div>
7 {openFaqIndex === index && <p>{faqItem.answer}</p>}
8 </div>
9))}

Die Kit-Version kapselt ein Base-UI-Akkordeon. Tastatursteuerung, ARIA-Zustand und Fokus kommen aus der Bibliothek, und das Kit ergänzt Deep Links, sodass ein URL-Fragment die passende Frage öffnet:

tsx
1<Accordion value={open} onValueChange={(next) => change(next as string[])}>
2 {items.map((item) => (
3 <AccordionItem key={item.question} value={item.question} id={item.id}>
4 <AccordionTrigger headingAs={headingAs}>{item.question}</AccordionTrigger>
5 <AccordionPanel>{item.answer}</AccordionPanel>
6 </AccordionItem>
7 ))}
8</Accordion>

Wer was besitzt, steht in einem ADR. Das Kit besitzt Verhalten, Styling, Tokens und Tests der Komponenten. Die Website besitzt Routen, Inhalte und Daten. Kit-Code wird in einer Seite nie kopiert oder gepatcht: Ein Fix geht upstream, wird released und kommt über ein Versionsupdate an. Der Umzug der Website aufs Paket war vor allem Löschen, und die Vorher-nachher-Screenshots kamen mit identischen Abmessungen heraus. Perfekt gepasst hat es trotzdem nicht: Ein kleiner Helfer zum Zusammenführen von Klassen blieb lokal, weil das Kit ihn noch nicht exportierte.

Ein Kit auf Tailwind-Basis hat versteckte Kosten. Wenn der Bundler einer Seite die Quellen des Kits nicht mehr erfasst, rendern dessen Komponenten ohne Styles, während die eigenen Klassen der Seite weiter funktionieren, und nichts schlägt fehl. Der Makeathon-Build endet deshalb mit einem Check, der nach ein paar Selektoren sucht, die es nur im Kit gibt.

Jede neue Seite startet mit Vorsprung

Der echte Test für ein gemeinsames Kit ist, ob die nächste Seite damit gebaut wird. Die alte Makeathon-Seite hatte ein eigenes, älteres Design. Ihre Nachfolgerin, jetzt live unter makeathon.tum-ai.com, ist auf dem Kit gebaut. Hier ist die alte Seite neben der neuen:

Die neue Makeathon-Seite: ein riesiger „Makeathon"-Schriftzug, hinter dem über einem lila Halftone-Punktfeld eine leuchtende Sonne aufgeht, die Zeile „AI for everyone." und zwei Buttons unter dem gemeinsamen TUM.ai-Header.Die alte Makeathon-Seite: ein dunkelblauer Hero mit der Überschrift „The TUM.ai Makeathon", drei Checklistenpunkten zu Projektstart, Networking und Preisen und einer schrägen weißen Kante.
Die Makeathon-Seite: links das alte Design, rechts das neue auf Basis des Kits.

Die neue Makeathon-Seite entstand auf einer gepackten Kopie des Kits und wechselte auf das veröffentlichte npm-Paket, sobald es erschienen war. Fast nichts von ihrem Code sind UI-Grundlagen. Es gibt darin keinen Button, kein Akkordeon, keinen Header und keinen Footer. Die kommen aus dem Kit. Übrig bleibt, was den Makeathon zum Makeathon macht: eine Sonne, die sich mit dem echten Himmel über dem Campus bewegt, ein Replay des Wochenendes Stunde für Stunde, die Ergebnisse und die Geschichte jeder Ausgabe.

Bild wird geladen...
Der Ergebnisbereich des Makeathons: die Überschrift „Four challenges. Five places each." über vier Spalten, eine pro Challenge-Partner, mit je fünf platzierten Teams, und eine Reihe von Tech-Partner-Logos.
Der Ergebnisbereich ist Makeathon-eigener Inhalt, gesetzt mit der Typoskala, dem Tone-Band und dem Header des Kits.
Bild wird geladen...
Der Abschluss der Makeathon-Seite: eine Sonne, die über einem Halftone-Punktfeld aufgeht, darunter die Überschrift „The sun rises again in 2027." und zwei Buttons.
Punktfeld und Sonne sind hier entstanden und leben jetzt im Kit, deshalb nutzt die Hackathons-Seite der Website dieselben.

So sieht Einheitlichkeit in der Praxis aus. Die neue Makeathon-Seite sieht nach TUM.ai aus, nicht weil jemand sie gegen einen Styleguide geprüft hat, sondern weil sie dieselben Komponenten importiert. Eine schriftliche Regel im Repository hält das so: Bevor du eine neue Komponente baust, frag, ob eine andere TUM.ai-Seite sie brauchen könnte, und wenn ja, halt an und schlag sie fürs Kit vor.

Dann ist eine Komponente den umgekehrten Weg gegangen. Das Halftone-Punktfeld und die Sonne entstanden in der Makeathon-Seite, und die Hackathons-Seite der Website wollte sie auch. Statt einer zweiten Kopie zogen beide als optionaler Subpfad ins Kit, 4,1 kB mit Brotli inklusive des lazy geladenen WebGL-Renderers, und der Makeathon hat seine eigene Kopie gelöscht. Genau für diesen Kreislauf gibt es ein Kit: Eine Komponente bewährt sich in einer Seite, zieht nach oben, und die ursprüngliche Kopie verschwindet.

Die dritte Seite ist der härtere Test, weil ich sie nicht gebaut habe. Timur Hegwein hat die Seite für den TUM.ai Summit in San Francisco gebaut, ohne vorher am Kit mitgearbeitet zu haben. Das Kit einzubinden hat ein npm install, drei CSS-Imports und das übliche Tailwind-Setup gebraucht. Danach ist die Seite vor allem Komposition: Header, Footer, Abschnitte, Statistikraster, Karten und das Call-to-Action-Band kommen alle aus dem Kit, inzwischen 18 Komponenten plus die Site-Shell. Sein eigener Code in der ersten Version ist vor allem Hero und Event-Inhalte, also der Teil, in dem es wirklich um den Summit geht.

Bild wird geladen...
Die TUM.ai-Summit-Seite in Desktopbreite: die Überschrift „TUM.ai Summit" in Hellviolett auf fast schwarzem Hintergrund, die Zeile „Overengineered. Overregulated. Still world class.", ein kurzer Absatz, ein „Become a partner"-Button, eine große A-Form mit einem Nachtfoto der Golden Gate Bridge und eine Reihe von Partnerlogos.
Die Summit-Seite. Header, Typoskala, Tone-Band und Button kommen aus dem Kit. Das Foto in der Bildmarke ist das einzige Element, das Summit von der Website von Hand nachgebaut hat.

Ganz ohne Reibung ging es trotzdem nicht. Die Seite umgeht das Kit an drei kleinen Stellen: Sie blendet eine Scrollbar in der Header-Navigation des Kits aus, baut eine eigene Partnerreihe, weil die Logo-Wall des Kits ein helles Band voraussetzt, und zwingt das Statistikraster auf Smartphones in eine Spalte. Ihr handgebauter Hero ist die Halftone-Geschichte, die nur darauf wartet, sich zu wiederholen: der nächste offensichtliche Kandidat für den Weg nach oben ins Kit.

Was das Kit weiter spart

Der leisere Gewinn kommt nach dem Launch. Als das Kit zwei Fixes dafür veröffentlicht hat, wie iPhone-Safari seine Leisten hinter dem offenen Menü und hinter Dialogen einfärbt, kam jeder davon bei der Website als Versionsupdate an, eine Zeile in package.json plus das Lockfile. Die Summit-Seite startete auf der reparierten Version und hatte den Bug nie. Niemand in diesem Projekt musste lernen, wie Safari seine Leisten einfärbt.

Dasselbe gilt für alles, was mühsam richtig hinzubekommen ist. Timur musste nie einen Kontrastcheck, Tastatursteuerung für ein Menü oder einen Fallback für reduzierte Bewegung schreiben. Eine neue TUM.ai-Seite hat diese Arbeit also schon hinter sich, statt sie nachholen zu müssen.

Das Design bekommt dieselbe Abkürzung. Für jedes stabile Release erzeugt das Kit seine Figma-Bibliothek aus dem Code, sodass CSS und TypeScript die Quelle der Wahrheit bleiben und Figma sie spiegelt, sobald jemand das Update-Plugin startet. Wer die nächste TUM.ai-Seite gestaltet, startet mit den Komponenten, die tatsächlich ausgeliefert werden, nicht mit einer Bibliothek, die sich still vom Code entfernt hat.

Seiten pinnen eine exakte Kit-Version, ein Upgrade ist also immer ein bewusster Einzeiler. Das Kit spart so lange Zeit, wie jemand diese Versionen hochzieht und das, was eine Seite dazulernt, zurück ins Kit trägt. Das ist echte Arbeit, nur viel weniger davon, als jede Seite von null zu bauen.

Was ich der nächsten Person sagen würde

  • Schreib die Regel als fehlschlagenden Test. Richtlinien werden ignoriert. An einem roten Check, der sagt, welche Datei zu reparieren ist, kommt niemand vorbei.
  • Plan Zeit für die Screenshots selbst ein. Visuelle Baselines sind das beste Sicherheitsnetz fürs Refactoring, das ich kenne, sobald sie stabil, klein genug und ehrlich sind.
  • Miss die Architektur. Eine saubere Importregel hat echte Kilobytes gekostet, bis die Bundle-Zahlen es gezeigt haben.
  • Mach aus dem Brand Guide Regeln, nicht nur Tokens. Eine Palette in einem PDF driftet. Eine Lint-Regel gegen rohe Farben und ein Kontrasttest für jedes Tone-Band tun das nicht.
  • Lass den zweiten Nutzer ein Kit formen, und beurteil es am dritten. Die Makeathon-Seite ist der Grund, warum das Kit eine klare API hat. Ohne zweiten Nutzer wären es die Komponenten der Website mit einer package.json gewesen. Die Summit-Seite, gebaut von jemandem, der vorher nie am Kit mitgearbeitet hatte, zeigt, dass die API auch von außen Sinn ergibt.

Am meisten stolz bin ich auf den langweiligen Teil. Wer als Nächstes eine Mitgliederzahl hartcodiert, über Schichten hinweg importiert, versehentlich ein Layout verschiebt oder eine Farbe außerhalb der Marke ins Kit schmuggelt, bekommt einen fehlschlagenden Check, der sagt, was zu reparieren ist. Und wer als Nächstes eine TUM.ai-Seite braucht, startet dort, wo der Summit gestartet ist, nicht dort, wo die Website angefangen hat. Das bedeutet für mich ein Redesign, das neu gebaut bleibt.