TypeScript und Headless | Anexia Digital Engineering

TypeScript und Headless für langlebige Produkte.

Wenn Datenbank, API und Oberfläche dieselben Typen teilen und Inhalte unabhängig von der Darstellung gepflegt werden, bleibt ein Produkt über Jahre veränderbar. Anexia Digital Engineering ordnet Frontend, Backend sowie CMS und Commerce im TypeScript Stack ein und entwickelt Ihre Plattform langfristig mit Ihnen weiter.

Durch horizontales Ziehen oder Scrollen, über die Schaltflächen oder durch Fokussieren einer Karte navigieren.

Eine Sprache. Getrennte Schichten.

Langlebige Produkte scheitern selten an einer einzelnen Technologie, häufiger an den Brüchen zwischen ihren Schichten. Ein durchgängiger TypeScript Stack schließt diese Brüche, weil Datenmodell, API und Oberfläche dieselbe Sprache sprechen. Eine Headless Architektur ergänzt das um Beweglichkeit, denn Inhalte und Commerce-Logik liegen getrennt von der Darstellung und erreichen jeden Kanal über stabile APIs.

  • Gemeinsame Typen

    Ein Schema beschreibt die Daten für Datenbank, API und Oberfläche. Ändert sich ein Feld, zeigt der Compiler jede betroffene Stelle im Editor und in der CI und nicht erst in Produktion.

  • Getrennte Schichten

    Content und Commerce leben in einem eigenen Backend. Das Frontend lässt sich unabhängig davon erneuern, ohne Inhalte oder Bestellprozesse anzufassen.

  • Mehrere Kanäle

    Website, App, Kundenportal und Shop greifen über REST oder GraphQL auf dieselbe Quelle zu, statt Kopien und Exporte zu pflegen. Neue Kanäle docken an bestehende Schnittstellen an.

  • Wartbar über Jahre

    Strikte Compiler-Regeln, Laufzeitvalidierung an den Systemgrenzen und planbare Upgrades halten den Stack aktuell. Das Wissen steckt im Code und nicht im Kopf einzelner Personen.

Warum TypeScript und Headless zusammenpassen

TypeScript ist eine von Microsoft entwickelte Erweiterung von JavaScript, die statische Typen hinzufügt. Der Code wird vor der Ausführung geprüft und in gewöhnliches JavaScript übersetzt, er läuft also im Browser, auf dem Server mit Node.js und in mobilen Apps. Headless beschreibt ein Backend ohne fest gekoppeltes Frontend. Inhalte und Produktdaten werden strukturiert gepflegt und über APIs ausgeliefert, die Darstellung entsteht unabhängig davon. TypeScript und Headless ergänzen sich, weil das eine die Verträge zwischen den Schichten prüfbar macht und das andere diese Schichten bewusst trennt. So entsteht ein Produkt, das sich in Teilen erneuern lässt, ohne als Ganzes neu gebaut zu werden.

Ein Datenmodell für alle Schichten

In einem durchgängigen TypeScript Stack beginnt das Datenmodell im Datenbankschema, etwa über Prisma oder Drizzle, und setzt sich in der API fort. NestJS erzeugt OpenAPI-Spezifikationen aus dem Code, Encore.ts beschreibt typisierte Verträge zwischen Frontend und Backend, und gemeinsame Pakete mit versionierten Typen oder tRPC bringen dieselben Modelle in die Oberfläche, statt dass drei Kopien auseinanderlaufen. Weil Typen zur Laufzeit nicht existieren, prüfen Zod oder Valibot externe Daten an den Systemgrenzen. pnpm-Workspaces, Nx oder Turborepo halten ein Monorepo dabei übersichtlich. Für Sie bedeutet das weniger Überraschungen. Ein Refactoring fällt im Editor auf, Breaking Changes zeigen sich vor dem Release, und neue Teammitglieder lesen im Code, welche Daten wohin fließen.

Frontend im TypeScript Stack

Für Produktoberflächen setzen wir React mit Server Components dort ein, wo sie Sinn ergeben, und Next.js, wenn Seiten ranken und Apps schnell reagieren sollen. Angular trägt Enterprise-Frontends mit langem Atem, mit Standalone-APIs, Signals und planbaren Upgrades. Vue.js steht für wartbare Oberflächen mit Composition API und Pinia, Nuxt ergänzt Vue um Hybrid-Rendering und Nitro für Content-Sites, die gefunden werden sollen. Remix und React Router setzen auf Web-Standards, Loaders, Actions und Progressive Enhancement. Welches Framework passt, entscheiden Rendering-Bedarf, SEO, das vorhandene Team und der geplante Betrieb, nicht der Trend.

Nicht jede Oberfläche braucht ein Single-Page-Framework. Mit HTMX liefert der Server fertiges HTML, und der Browser tauscht nur die Teile aus, die sich ändern. Das passt zu Business-Anwendungen aus Formularen, Tabellen und Workflows. Alpine.js bringt Reaktivität direkt ins Markup, für Menüs, Dialoge und Formularstrecken auf schnellen Websites. Vanilla JS nutzt Custom Elements, Shadow DOM und die Web Animations API für Web Components und Bausteine von Design-Systemen, die in jedem Framework funktionieren. Gewachsener JavaScript-Code wird mit Charakterisierungstests und einer modernen Toolchain abgesichert und kann danach Schritt für Schritt in TypeScript übergehen.

Backend im TypeScript Stack

Node.js ist die Laufzeitumgebung, mit der JavaScript und TypeScript auf dem Server laufen. Das ereignisgesteuerte Modell eignet sich für APIs, Integrationen und Realtime-Anwendungen mit vielen gleichzeitigen Verbindungen, und feste Release-Zyklen mit LTS-Versionen machen Upgrades planbar. NestJS bringt Module, Dependency Injection, Guards und Pipes für größere Backends, an denen mehrere Teams arbeiten, etwa B2B-Backends, mandantenfähige SaaS-Plattformen und Integrations-Hubs. Encore.ts beschreibt APIs, Services und die benötigte Infrastruktur deklarativ im Code und startet Datenbanken, Queues und Caches lokal passend zur Anwendung. Alle drei teilen die Sprache mit dem Frontend und damit auch die Typen.

Headless CMS und Commerce

Payload CMS definiert Collections, Globals und Blocks als TypeScript-Code und verbindet Admin UI und Next.js in einem gemeinsamen Projekt. Strapi passt zu Unternehmen, deren Redaktion Inhalte strukturiert pflegt und über mehrere Kanäle ausspielt. Directus legt sofort nutzbare APIs und eine Oberfläche für Fachbereiche über eine bestehende SQL-Datenbank. Im Commerce bildet Medusa.js eigene Module und Workflows ab, die bei Fehlern kompensieren. Vendure bildet mit offenem TypeScript-Kern und GraphQL Firmenkonten, kundenspezifische Preise und mehrere Marken auf einer gemeinsamen Plattform ab. Shopify Hydrogen baut individuelle React-Storefronts auf Shopify, ohne den bewährten Checkout zu ersetzen.

Diese Seite betrachtet Content- und Commerce-Plattformen aus Sicht des TypeScript Stacks. Die Seite „CMS & Commerce Technologien“ vergleicht alle CMS- und Commerce-Plattformen, mit denen wir arbeiten, einschließlich der Python-basierten wie django CMS, Wagtail und Saleor. Dort finden Sie die passende Entscheidungshilfe, wenn die Wahl des Systems noch offen ist und auch ein Python-Backend in Frage kommt.

Technologien

Der TypeScript Stack im Detail

Zwanzig Seiten vertiefen die einzelnen Bausteine. Im Frontend sind das TypeScript, JavaScript, React, Next.js, Angular, Vue.js, Nuxt, Remix, HTMX, Alpine.js und Vanilla JS, im Backend Node.js, NestJS und Encore.ts. Für CMS und Commerce folgen Payload CMS, Strapi, Directus, Medusa.js, Vendure und Shopify Hydrogen.

Ein Datenmodell, das jede Schicht versteht.

Entscheidungen in der Headless Architektur

Wann TypeScript und Headless nicht passen

Ein durchgängiger Stack ist kein Selbstzweck, und wir sagen es, wenn ein anderer Weg besser trägt. Für kleine Skripte, kurzlebige Prototypen oder Seiten mit wenig Logik kann der zusätzliche Aufwand für Typen und Build größer sein als der Nutzen. Eine überwiegend statische Website mit wenig Interaktion braucht kein Framework, dort reichen servergerenderte Seiten mit etwas Alpine.js. Und eine reine Anwendung hinter einem Login, bei der SEO keine Rolle spielt, ist als schlanke React-App mit Vite oft einfacher zu betreiben als mit Next.js.

Wenn ein Kanal genügt

Headless zahlt sich aus, sobald mehr als ein Kanal, eine Sprache oder ein Team an denselben Daten arbeitet. Gibt es nur eine Website und eine kleine Redaktion, sind zwei getrennte Anwendungen mit eigener Vorschau, eigenem Caching und eigenem Deployment unter Umständen mehr Aufwand als nötig. Für einen kleinen Shop mit Standardprozessen kann eine gehostete Lösung wie Shopify wirtschaftlicher sein als eine eigene Commerce-Plattform. Medusa.js oder Vendure spielen ihre Stärken aus, wenn Prozesse individuell sind, mehrere Systeme angebunden werden oder Sie volle Kontrolle über Daten und Infrastruktur wollen.

Wenn eine andere Sprache besser trägt

Node.js ist nicht für jede Aufgabe ideal. Für sehr rechenintensive Prozesse wie Bildverarbeitung in großem Maßstab oder komplexe numerische Berechnungen sind andere Sprachen oft effizienter. Dann lagern wir genau diese Teile gezielt aus, statt die ganze Plattform umzubauen. Ist Ihr Team mit einem anderen Backend-Stack gut aufgestellt, empfehlen wir keinen Wechsel nur wegen eines Frameworks, denn ein Framework-Wechsel kostet Monate, und der Nutzen muss diese Zeit deutlich übersteigen. Auch der Zeitpunkt zählt, denn ein Team kurz vor einer Deadline sollte keine große Migration beginnen. Dann starten neue Module direkt typisiert, und der Rest zieht später nach.

Fragen zu TypeScript und Headless

Produkte für Marken, die weiterdenken.

Durchdenken. Ein Stack, der mit Ihnen wächst.

Beschreiben Sie uns Ihr Produkt, Ihre Kanäle und den heutigen Stack. Wir prüfen gemeinsam, welche Schichten von gemeinsamen Typen profitieren und wo ein schlankerer Weg besser passt.