React Micro Frontend Components im Monorepo

Bei smartive haben wir ein grosses Ökosystem aus wiederverwendbaren, anpassbaren Micro Frontend Components aufgebaut. Sie laufen auf über 30 Websites der grössten Arbeitgeberin der Schweiz. Das haben wir dabei gelernt.
Es ist eine Sammlung verschiedener kleiner Components wie Login, User-Profil, Newsletter, Ratings & Reviews und vielen mehr. Alle basieren auf einem gemeinsamen Konzept.

Look and Feel lassen sich bei allen Components an das CI/CD der jeweiligen Seite anpassen. Unter der Haube teilen sie sich denselben Login-Kontext und dieselbe Messaging API, über die sie miteinander kommunizieren.
Ein neues Theme für alle Components ist im Handumdrehen hinzugefügt. Wir stellen eine Utility Library bereit, die komplizierte Konzepte abstrahiert und einfache, wiederverwendbare Hooks liefert. Den User-Kontext holst du dir also ganz einfach mit einem useUser()-Hook.
Innerhalb eines Jahres haben wir auf unserem Setup insgesamt 1 442 Releases von Micro Frontend Components gezählt, von 35 verschiedenen Autor*innen.
Schauen wir uns unser Setup und die Herausforderungen genauer an, mit denen wir zu kämpfen hatten. Die Micro Frontend Components sind React Components, geschrieben in TypeScript, dokumentiert in Storybook und alle zusammen in einem Monorepo abgelegt.
Wenn du mehr darüber lesen willst, warum es sich lohnt, deine Components in Micro Components aufzuteilen, wirf einen Blick in unseren früheren Blogpost:
Micro Frontends — modulare Frontend Components teilen
Ein Monorepo (Mono-Repository) ist ein altbekanntes Konzept: Ein einziges Source-Code-Repository enthält den ganzen Code und alle Assets mehrerer Projekte. Nicht zu verwechseln mit einer monolithischen Applikation.
Vorteile eines Monorepos
Wir setzen weiterhin auf eigenständige, klar getrennte Micro Components, die im selben Repository liegen. Dabei profitieren wir von der besseren Sichtbarkeit der Components im Monorepo:
- Wiederverwendbarkeit — Im Monorepo lassen sich bestehende Components leicht finden, integrieren und testen.
- Refactoring — Repository-weite Refactorings, neue Features (z. B. der Wechsel auf ein neues Single Sign-on) und Breaking Changes lassen sich viel einfacher umsetzen. Ohne Monorepo dauert es Monate, bis neue Major Releases einzelner Component Libraries mit Breaking Changes übernommen sind. Mit dem Monorepo können wir einen grossen Teil der Änderungen vorwegnehmen.
- Dependency Management — Dank der Sichtbarkeit wird das Dependency Management viel einfacher. Wenn du etwas änderst, siehst du sofort, was sonst noch betroffen ist. Und Abhängigkeiten zwischen den Components im Monorepo musst du gar nicht erst verwalten.
- Zusammenarbeit im Team — Alle Entwickler*innen im Monorepo sehen, was läuft. Das erleichtert die Arbeit im Team und die Zusammenarbeit über Teams hinweg.
Nachteile
- Trennung— Jede Component im Monorepo muss über explizite APIs klar von den anderen getrennt sein. Wird Code wild wiederverwendet und quer verlinkt, droht das Projekt zu einem riesigen, chaotischen Code-Monolithen zu werden.
- Ownership & Koordination — Jeder Teil des Monorepos braucht eine klare Ownership: jemanden, der für Updates, die Koordination zwischen den Teams und den Support verantwortlich ist.
- Build- & Testzeit — Weil mehrere Components in einem Repository liegen, dauern die Integration-Builds und Test-Pipelines immer länger.
Konzept
Um diese Grenzen eines Monorepos zu überwinden, haben wir drei Grundregeln:
- Unabhängige Components — Nie direkt auf internen Code eines anderen Submoduls verweisen. Nur explizit freigegebene Components dürfen modulübergreifend wiederverwendet werden, und die Kommunikation läuft immer über einen klar definierten Messenger-Bus oder die bestehende DOM API.
- Konsistente Wiederverwendung — Alle Module teilen dieselbe Konfiguration für Build, Tests, Linting und Dokumentation. So haben sie eine gemeinsam vereinbarte Basis und bleiben konsistent, auch wenn sich das Repository weiterentwickelt.
- Dokumentation & Kommunikation — Jede Component muss in einer gemeinsamen, öffentlich zugänglichen Storybook-Instanz dokumentiert sein. Jede Component führt ein Changelog, das bei neuen Releases an alle Stakeholder verteilt wird.
Zusammen mit unserem Commitment zu Peer Reviews und Tests hält das unsere Qualität hoch und das Monorepo sauber und stabil. Wie wir unsere Qualität laufend verbessern, liest du in diesem Blogpost: Quality Assurance, Testing and Tools.
Learnings
Einigt euch auf ein gemeinsames Konzept
Sorgt dafür, dass alle auf dem gleichen Stand sind. Definiert eine Monorepo-weite ESLint-Konfiguration, TypeScript-Konfiguration, Linting-Regeln und ein gemeinsames Test-Setup.
Einigt euch auf eine gemeinsame Definition of Done und eine Browser-Support-Matrix. Stellt Dokumentation bereit und aktualisiert sie bei jeder Änderung. Vereinheitlicht wenn nötig den Einsatz von Third-Party Libraries und ihre Versionen (z. B. die Versionen von react und react-dom).
Legt fest, wie Components miteinander interagieren (z. B. über die DOM API), und setzt wo immer möglich auf Lazy Loading. So lassen sich eure Components viel einfacher wiederverwenden und integrieren.
Automatisiere alles
Weil viele verschiedene Projekte und Entwickler*innen parallel arbeiten, solltest du so viel wie möglich automatisieren.
Nutze Conventional Commits, um das Changelog automatisch zu generieren und Packages mit Semantic Versioning zu versionieren. Verschicke automatisierte wöchentliche Release-Mails. Richte eine Continuous-Integration- und Continuous-Delivery-Pipeline mit automatisierten Tests, Releases (SemVer) und Deployments der Dokumentation ein.
Developer Performance
Behalte die Developer Performance im Auge. Es kann ziemlich frustrierend werden, wenn die Pipeline für Merge Requests immer länger dauert oder, noch schlimmer, zufällig an Tests scheitert, die nichts mit der Änderung zu tun haben. Sorg für eine solide, reproduzierbare und schnelle Pipeline.
Wir setzen jest und TestCafe für automatisierte Unit- und Integrationstests über alle Components hinweg ein. Die Tests jedes Micro-Component-Moduls laufen in einem eigenen GitLab-CI-Job. Das beschleunigt das Testen und macht die Pipelines robuster.
Kommunikation und Stakeholder Management
Kommunikation ist alles. Nicht nur mit deinen Stakeholdern, sondern auch mit allen Projektteams, die am selben Monorepo arbeiten. Sorg dafür, dass alle die klaren, vordefinierten Kommunikationskanäle für Support, neue Releases (Mailing) und Changelogs kennen und nutzen.
Stell eine Dokumentation (z. B. Storybook) bereit, die immer aktuell und für alle zugänglich ist. Niemand sollte sich durch die Codebase wühlen müssen, um die Components zu verstehen.
Fazit
Es ist herausfordernd, aber wir sind mit dem Setup und den bisherigen Fortschritten zufrieden. Auf dem Weg gibt es viele Hindernisse. Doch die Vorteile eines Monorepos überwiegen die Nachteile und machen es viel einfacher, ein riesiges Ökosystem aus Micro Components zu verwalten und daran mitzuarbeiten.
Einigt euch auf ein gemeinsames Konzept und klar definierte Design Patterns und automatisiert so viel wie möglich. So bleibt der Fokus auf den Features statt auf der Verwaltung des Systems.
Du willst mehr über das technische Setup wissen und darüber, wie wir den Release-Prozess integriert und automatisiert haben? Dann lies unbedingt unseren Folgeartikel mit weiteren technischen Details:
CI/CD in einem Lerna-Monorepo automatisieren
Welche Erfahrungen hast du mit Micro Frontends und Monorepos gemacht? Wir sind gespannt auf deine Herausforderungen und wie du sie gelöst hast! Lass uns reden!

Geschrieben von
Thilo Haas
Ähnliche Challenge auf dem Tisch? Lass uns drüber reden.





