Geschrieben von Huifer, Solo-Entwickler und Maintainer von TanStack Ship. Ich veröffentliche und betreibe TanStack-Ship-Templates seit 2024 in Produktion, und dieser Leitfaden – „TanStack DB 1.0 RC1: Was neu ist und wie Sie aktualisieren (2026)“ – basiert auf dem Setup, das ich tatsächlich verwende. Alles Folgende entspricht meiner täglichen Arbeit, einschließlich der Fehlerbilder, auf die ich gestoßen bin, und ihrer Behebung.
Verifizierte Quellen: TanStack-Start-Dokumentation · TanStack-Query-Dokumentation · Cloudflare-Workers-Dokumentation · Stripe-Dokumentation
Letzte Aktualisierung: 30. Oktober 2026 · Changelog
Geschrieben von Huifer | Letzte Aktualisierung: 30. Oktober 2026 | Changelog
Ich habe seit Anfang 2025 SaaS-Apps mit TanStack Start veröffentlicht, und jede stößt auf dieselbe Hürde: Dashboards, die beim Bearbeiten Daten abrufen, erneut abrufen und flackern. Ich betreibe TanStack Ship, ein TanStack-Start-Boilerplate, deshalb entscheidet ein Wechsel der Client-Datenschicht in diesem Umfang darüber, was das nächste Template ausliefert. Als RC1 am 29. Oktober 2026 erschien, las ich noch am selben Morgen die Ankündigung und den vollständigen Migrationsleitfaden und ging die Breaking Changes anhand unseres Stacks durch. Produktions-Apps habe ich noch nicht auf die RC migriert – ich werde genau sagen, wo ich abwarten würde.
Verifizierung: Ankündigung zu TanStack DB 1.0 RC1 und der offizielle Migrationsleitfaden
TL;DR
- RC1 wurde am 29. Oktober 2026 nach 18 Monaten Entwicklung veröffentlicht, laut der offiziellen Ankündigung
- Das zentrale Paket
@tanstack/dbüberschreitet 1 Million wöchentliche npm-Downloads – ungefähr 10× Wachstum im vergangenen Jahr (gemessen anhand von npm)- Seit 0.6: Server-Rendering, TanStack-Start-Integration, Neon-Realtime- und Convex-Adapter sowie Preact als sechster Framework-Adapter
- Die 1.0-Härtungsphase fügte ungefähr 420.000 Testzeilen und 211 Oracle-Testdateien über 15 Pakete hinweg hinzu
- Größte Breaking Change:
$syncedwurde entfernt und durch$hasPendingWritesmit umgekehrter Boolean-Bedeutung ersetzt- Meine Bewertung: 9/10 für die schrittweise Einführung in bestehende TanStack-Query-Apps, 6/10 dafür, am ersten Tag eine Produktion auf die RC zu setzen
TanStack DB 1.0 RC1: Was neu ist und wie Sie aktualisieren (2026)
TanStack DB ist ein reaktives Client-Daten-Framework, das Backend-Daten lokal wirken lässt: Datensätze aus einer API oder einer Sync-Engine werden zu typisierten Collections, Komponenten führen verbundene und gefilterte Live-Queries darauf aus, und optimistische Bearbeitungen erscheinen sofort und werden später abgeglichen. RC1 ist der Meilenstein für API-Stabilität nach 18 Monaten öffentlicher Betas.
Das konzeptionelle Modell habe ich in meinem Deep Dive zu TanStack DB behandelt. Dieser Artikel analysiert den Release: Was seit 0.6 ausgeliefert wurde, wie der Release gehärtet wurde und welche Schritte die Migration umfasst.
Was RC1 seit 0.6 ausliefert: Vier konkrete Ergänzungen
Server-Rendering und TanStack-Start-Integration
Die größte Lücke zwischen Beta und einer Framework-tauglichen Datenschicht war SSR. Sie ist nun geschlossen: DB bietet Server-Rendering mit einer tiefgehenden TanStack-Start-Integration. Für SaaS-Dashboards ist das wichtiger als jede Feinheit der Query-API – eine reine Client-Datenschicht erzwingt beim ersten Rendern Ladeindikatoren, genau das Flackerproblem, das DB beseitigen soll. Ein Detail aus dem Migrationsleitfaden sollte ich jetzt hervorheben: SSR-Daten müssen explizit vorbereitet werden, und hydrierte Zeilen gelten als vorläufige Seeds statt als bestätigter Serverstatus. Lesen Sie den SSR-Migrationsabschnitt, bevor Sie Collection-Code schreiben.
Collection-Adapter für Neon Realtime und Convex
Adapter verbinden DB mit Backends, ohne dass Sie Ihren Query-Code ändern müssen. Seit 0.6 hat das Projekt Support für Neon Realtime und einen Convex-Adapter hinzugefügt. Die Neon-Verbindung ist kein Nebendetail: DB wurde in den ersten 18 Monaten von ElectricSQL entwickelt, und Neon hat ElectricSQL im August übernommen. Anschließend veröffentlichte Neon Realtime mit erstklassigem Support für TanStack DB. PostgreSQL-Entwickler, die Realtime-Synchronisierung möchten, haben nun einen vom Anbieter unterstützten Weg, der bei der Datenbank beginnt.
Preact, der sechste Framework-Adapter
Der Preact-Adapter erweitert die Framework-Unterstützung auf sechs Frameworks: React, Vue, Solid, Svelte, Angular und jetzt Preact. Jedes Framework-Paket exportiert die zentrale @tanstack/db-Engine erneut, sodass Collections und Live-Query-APIs über alle Frameworks hinweg identisch bleiben – hilfreich für Teams, die eine reaktive Client-Datenschicht über mehrere Apps hinweg standardisieren.
Der rc-dist-tag und die operative Bedeutung von „RC“
Der erste Kandidat ist 1.0.0-rc.1. Er wurde unter npm's rc-dist-tag statt unter latest veröffentlicht – eine stabile API mit Notausstieg. Eine Besonderheit aus dem Migrationsleitfaden: @tanstack/query-db-collection und @tanstack/offline-transactions wurden versehentlich vor der RC als 1.0 veröffentlicht. Lassen Sie diese auf ihren neuesten 1.x-Releases, die Peer-Abhängigkeiten zu @tanstack/db@^1.0.0-rc.0 haben.
Der Weg zur schrittweisen Einführung: zuerst REST-API, später offline
Das ist die Eigenschaft, die DB von früheren clientseitigen Datenbanken unterscheidet. Historisch bedeuteten reaktive Queries, optimistische Mutationen und Offline-Support, dass Sie eine neue Datenbank und Sync-Architektur auf einmal übernehmen mussten. DB dreht dieses Modell um: Beginnen Sie mit Ihrer bestehenden REST-API und dem TanStack-Query-Setup, erhalten Sie sofort schrittweise relationale Live-Queries und ergänzen Sie SQLite-Persistenz, dauerhafte Offline-Transaktionen oder Realtime-Synchronisierung erst dann, wenn Sie sie benötigen.
Da das anwendungsseitige Query-Modell in jedem Schritt gleich bleibt, müssen Sie Ihre Datenschicht nicht neu schreiben, wenn Sie von einer herkömmlichen Web-App zu einer vollständig offline-fähigen Local-First-App wechseln. Die Stufen entsprechen Ihrem Risikobudget:
| Stufe | Was Sie hinzufügen | Was Sie erhalten |
|---|---|---|
| 1 | Query Collection über Ihre REST-API | Typisierte Collections, Live-Queries, optimistische Bearbeitungen |
| 2 | SQLite-Persistenz | Lokale Persistenz über Reloads hinweg |
| 3 | Dauerhafte Offline-Mutationen | Schreibvorgänge, die Neustarts und die Wiederverbindung überstehen |
| 4 | Neon Realtime oder ElectricSQL | Echtzeit-Synchronisierung mehrerer Clients |
Für ein SaaS-Dashboard lautet die praktische Übersetzung: Admin-Listenansichten reagieren beim Bearbeiten sofort, Formulare flackern nicht mehr und Sie müssen keine Backend-Endpunkte ändern. Das ist das Versprechen von „Backend-Daten, die sich lokal anfühlen“. Nach den Leitfäden glaube ich, dass es auf Stufe 1 ohne exotische Infrastruktur hält.
Wie DB gehärtet wurde: 211 Oracles und 420.000 Testzeilen
Bei 1.0 geht es ebenso sehr um den Prozess wie um Features. Kyle Mathews schreibt, dass er nach dem Einführen von Server-Rendering eine kurze Expedition zur Fehlerbehebung erwartete. Daraus wurden Hunderte PRs und monatelange Arbeit, und das Repository gewann ungefähr 420.000 Testzeilen hinzu – angetrieben von Coding-Agents, die gegen Test-Oracles statt gegen beispielbasierte Unit-Tests arbeiteten.
Von Beispieltests zu modellbasierten Oracles
Ein Test-Oracle ist ein unabhängiges Modell, das die korrekte Antwort berechnet, statt einen erwarteten Output von Hand zu hinterlegen. Die Oracles von DB kombinieren die eigenschaftsbasierte Generierung mit fast-check und Referenzmodelle in einfachem JavaScript: Das Modell berechnet jedes Live-Query-Ergebnis von Grund auf neu, während DB es inkrementell pflegt. Nach jedem Änderungsstapel müssen beide übereinstimmen. DB verfügt inzwischen über 211 Oracle-Testdateien in 15 Paketen sowie eine Coverage-Karte, damit Agents vor Änderungen das relevante Gesetz finden.
Die dadurch gefundenen Bugs sind nicht hypothetisch. Issue 1901: Das Löschen und erneute Einfügen einer Zeile unter demselben Schlüssel innerhalb eines Event-Loop-Durchlaufs hinterließ bei Abonnenten einen veralteten Cache. Das wurde in PR 1902 behoben. Die Durchsetzung des Nachrichten-Gesetzes – Insert erfordert einen nicht vorhandenen Schlüssel, Update und Delete einen vorhandenen Schlüssel – schlug in 26 von 378 bestehenden Fällen fehl und deckte einen Produktionsbug auf, der in PR 1995 behoben wurde. Für die schwierigsten Regeln erstellt das Team zunächst Prototypen in TLA+, bevor es die Modelle in ausführbare TypeScript-Oracles übersetzt.
Vorher: Beispielbasierte Tests bewahrten einzelne Antworten; Bugs wurden erst durch Reproduktionen von Nutzern sichtbar. Nachher: Durch Oracles erzwungene Design-Gesetze machen ganze Fehlerklassen vor dem Release sichtbar; Agents können Interna umschreiben, solange die Zusagen bestehen bleiben. Verifizierung: Beim Schreiben dieses Abschnitts habe ich jeden oben genannten Fix bis zu seiner öffentlichen PR zurückverfolgt.
Aktualisierung: Die Migrations-Checkliste für die 1.0 RC
Der offizielle Migrationsleitfaden beschreibt den Weg von @tanstack/db@0.9.2 zu 1.0.0-rc.1. Diese Änderungen betreffen echten Anwendungscode:
Pakete gemeinsam über den rc-tag aktualisieren
npm install @tanstack/react-db@rc @tanstack/electric-db-collection@rc
Aktualisieren Sie jedes DB-Paket vor 1.0 im selben Commit – Adapter haben Peer-Abhängigkeiten zur RC, und gemischte Versionen beizubehalten ist laut Leitfaden das erste Fehlerbild, vor dem er warnt.
$synced durch $hasPendingWrites ersetzen
Die entfernte virtuelle Eigenschaft $synced hat einen Ersatz mit umgekehrter Bedeutung. Diese Änderung wird bei einer Migration nach dem Muster „umbenennen und hoffen“ am wahrscheinlichsten übersehen:
| Vorher | Nachher |
|---|---|
row.$synced | !row.$hasPendingWrites |
!row.$synced | row.$hasPendingWrites |
eq(row.$synced, true) | eq(row.$hasPendingWrites, false) |
eq(row.$synced, false) | eq(row.$hasPendingWrites, true) |
Auch die Semantik ist präziser: $hasPendingWrites gibt an, ob eine ausstehende lokale optimistische Mutation die Zeile betrifft. Ein Wert von false allein beweist nicht, dass der Server den Schreibvorgang bestätigt hat.
Mutation-Handler, Transaktionen und SSR-Seeds
Drei Verhaltensänderungen erfordern das Lesen des Codes und nicht nur das Umbenennen von Symbolen. Erstens: Warten Sie auf den Abschluss von Transaktionen – Fire-and-Forget-Schreibvorgänge benötigen explizite Awaits. Zweitens müssen Mutation-Handler die Synchronisierung intern abwarten, und Query-Collection-Handler führen nach Mutationen keinen erneuten Abruf mehr durch. Damit entfällt ein versteckter Roundtrip, auf den sich viele Apps verlassen haben. Drittens: Bereiten Sie SSR-Daten explizit vor und behandeln Sie hydrierte Zeilen als vorläufige Seeds. Weitere Punkte: Importieren Sie die Includes- und Grouping-Operatoren explizit, kapseln Sie verschachtelte Selektionen in include(), verwenden Sie String- oder Number-Keys und trennen Sie Ladefehler mit dem neuen Retry-Pfad reload() von Sync-Problemen.
Realitätscheck zur Einführung: Wer TanStack DB in Produktion nutzt
In der RC-Ankündigung werden drei Nutzer aus der Produktion genannt: Prisma Studio, das Developer-Dashboard von Unkey und Skylights React-Native-Familienkalender, der sich auf die Offline-Funktionen von DB stützt. Zusammen mit mehr als einer Million wöchentlichen Downloads des zentralen Pakets, etwa 0,6 % der wöchentlichen React-Downloads und ungefähr 10× Wachstum gegenüber dem Vorjahr ist das eine echte Adoptionskurve und kein Ausschlag am Tag der Ankündigung. Wenn Sie optimistische Updates in TanStack Query schon einmal manuell geschrieben haben, wie ich in TanStack Query: Optimistische Updates dokumentiert habe, automatisiert DB den Großteil dieser Infrastruktur.
Sollte ein SaaS auf TanStack Start die RC jetzt übernehmen?
Problem: Ein Dashboard, bei dem jede Bearbeitung einen erneuten Abruf, eine Cache-Invalidierung und sichtbares Flackern auslöst. Ursache: Client-State-Bibliotheken behandeln Serverdaten als Cache, der ungültig gemacht werden muss, statt als Datensatz, den man abfragen kann. Lösung: Collections mit Live-Queries und transaktionalen optimistischen Mutationen. Ergebnis: Bearbeitungen erscheinen im selben Frame, und der Abgleich erfolgt ohne manuelle Cache-Verkabelung.
Das ist der ehrliche Vorteil. Meine Einschätzung für den TanStack-Ship-Stack: Eine Einführung auf Stufe 1 – Query Collections über bestehende REST-Endpunkte – ist ein sinnvolles Evaluierungsprojekt für einen Dashboard-Bildschirm auf einem Feature-Branch. Dauerhafte Offline-Mutationen oder Realtime-Synchronisierung würde ich erst dann in Produktions-Templates aufnehmen, wenn 1.0 final veröffentlicht ist. Der Migrationsleitfaden dokumentiert subtile Verhaltensdetails (Nachrichtenreihenfolge, Abschlusszeitpunkt, SSR-Seeding), die eine stabile Version benötigen, an der sie sich festmachen lassen. RC-Stabilität ist ein Versprechen über die API-Oberfläche, keine Einladung, Ihre eigenen Integrationstests zu überspringen.
Einschränkungen und offene Angaben
Ich habe die RC bewertet, indem ich die Ankündigung, den Migrationsleitfaden und die verlinkten PRs gelesen habe. Eine Produktions-App habe ich noch nicht auf 1.0.0-rc.1 migriert, daher kann ich keine Erfahrungswerte zu Upgrade-Zeiten nennen. Die Performance-Aussagen stammen von den Maintainerinnen und Maintainer und wurden hier nicht benchmarkbasiert geprüft. Es besteht keine wesentliche Verbindung zu Neon, ElectricSQL, Prisma, Unkey oder Skylight. Release-Fakten sind als anhand der oben genannten offiziellen Quellen gemessen gekennzeichnet; die Einschätzungen zur Einführung sind mein Urteil.
Fazit und nächster Schritt
TanStack DB 1.0 RC1 ist der Moment, in dem die 18-monatige Beta zu einem Stabilitätsvertrag wird: SSR und die Start-Integration schließen die Lücke beim Rendering, Neon Realtime und Convex erweitern die Backend-Oberfläche, sechs Frameworks werden unterstützt, und ein Oracle-basiertes Testsystem hat den Kern mit ungefähr 420.000 neuen Testzeilen gehärtet. Der schrittweise Weg bedeutet, dass Ihre REST-API kein Nachteil ist – sie ist die Einstiegsstufe.
Nächster Schritt: Wählen Sie einen leseintensiven Dashboard-Bildschirm aus, verbinden Sie ihn auf einem Branch mit einer Query Collection und vergleichen Sie das Flackern beim Bearbeiten vorher und nachher. Wenn Sie den vollständigen Stack sehen möchten, in den sich das einfügt, vergleichen Sie TanStack Ship mit Ihrem aktuellen Framework oder lesen Sie den Deep Dive zu den Grundlagen der Query-Engine.
FAQ: TanStack DB 1.0 RC und Aktualisierung
Ist TanStack DB 1.0 stabil?
Noch nicht final – RC1 (1.0.0-rc.1) wurde am 29. Oktober 2026 veröffentlicht, und die Maintainer beschreiben die API als produktionsbereit und stabil. Die finale 1.0 folgt auf die RC-Phase. Installieren Sie bis dahin über den rc-dist-tag.
Wie migriere ich von $synced zu $hasPendingWrites?
Kehren Sie den Boolean um: row.$synced wird zu !row.$hasPendingWrites und !row.$synced wird zu row.$hasPendingWrites. Die vollständige Zuordnung einschließlich der eq()-Anpassungen auf Query-Ebene steht im Migrationsleitfaden.
Ersetzt TanStack DB TanStack Query?
Nein. Es erweitert TanStack Query: Query Collections liegen auf TanStack Query auf, und der Migrationspfad beginnt mit Ihrem bestehenden Query-Setup, statt es zu ersetzen.
Kann ich TanStack DB mit einer einfachen REST-API verwenden?
Ja, und genau das ist der vorgesehene Einstiegspunkt. Die Einführung auf Stufe 1 lässt Ihre Endpunkte unverändert, während Collections und Live-Queries clientseitig ausgeführt werden.