TanStack Ecosystem: Best Practices & Roadmap — Das Solo-Entwickler-Handbuch 2026

Geschrieben von Huifer, Solo-Entwickler und Maintainer von TanStack Ship. In zwölf produzierten SaaS-Apps, die ich zwischen Ende 2024 und August 2026 auf Cloudflare Workers deployed habe, habe ich das TanStack-Ökosystem durchlaufen — von Router v1.50 bis v1.131, Query v5 bis v6, Form v0 bis v1, Table v8, Virtual v3, Store v0 bis v1, Starts Beta-Bogen und die TanStack Intent Distribution Layer, die Agent Skills mit jedem Paket ausliefert. Dies ist das Feldhandbuch — Bibliothek für Bibliothek: Status, öffentliche Roadmap-Signale, was Sie jetzt versus später adoptieren sollten, und die Patterns, die zwölf Produktions-Deployments überlebt haben. TanStack Ship basiert auf diesem Stack; ich benenne diese Verzerrung upfront.

Verifizierte Quellen: TanStack Router Documentation · TanStack Query Documentation · TanStack Start Documentation · TanStack Form Documentation · TanStack Table Documentation · TanStack Virtual Documentation · TanStack Store Documentation · TanStack Intent Repository · TanStack GitHub Organization · Cloudflare Workers Documentation · TanStack Ship Features · TanStack Ship Comparison Hub · TanStack Ship Blog Index

Zuletzt aktualisiert: 2026-08-01 · Changelog

TL;DR: Das TanStack-Ökosystem im August 2026 umfasst acht First-Party-Bibliotheken (Router, Query, Form, Table, Virtual, Store, Start und die neue Intent Distribution Layer) plus eine öffentliche Roadmap, die auf engere Start/SSR-Integration, stabiles Intent 1.0 und KI-natives Tooling im gesamten Framework hindeutet. Router und Query sind ausgereift und sollten jetzt adoptiert werden; Table, Virtual und Form sind produktionsreif mit stabilen APIs; Start ist „langweilig geworden" und der richtige Standard für neue TanStack-Projekte; Store und Intent sind kleinere Oberflächen, die sich für bestimmte Aufgaben lohnen. Unten: der Bibliothek-für-Bibliothek-Status, die Versionsnummern, die ich tatsächlich nutze, die Migrationsreibungen, die ich erlebt habe, die öffentlichen Roadmap-Signale aus TanStack GitHub Discussions und Tanner Linsleys Posts, sowie die expliziten Adopt/Wait/Avoid-Einschätzungen, die ich für jede Bibliothek heute geben würde.

Warum ein umfassender TanStack-Ökosystem-Überblick jetzt relevant ist

Die TanStack-Oberfläche hat sich zwischen August 2024 und August 2026 verdoppelt — Start hat sich von Alpha zu Beta zur Production-Candidate entwickelt, Intent wurde als Distributionskanal eingeführt, Store hat v1 ausgeliefert und Router hat v1.100 überschritten. Ein neuer Entwickler, der im August 2026 auf den TanStack-Dokumentation landet, sieht mehr Einstiegspunkte als ich, als ich Ende 2024 begann, auf dem Stack zu shippen. Die öffentlichen Roadmap-Signale — TanStack GitHub Discussions, die TanStack/router-Meilensteine, die intent-Repo-Vor-1.0-Wechsel und Tanner Linsleys periodische Posts — deuten auf einen End-2026-Meilenstein hin, der Start, Intent und die Router-Typegen-Pipeline konsolidiert. KI-Tooling hat verändert, wie das Framework genutzt wird; TanStack Intent existiert, weil die Autoren entschieden haben, Agent Skills zusammen mit dem Code auszuliefern.

Laut der TanStack Router Dokumentation ist Router ein vollständig typsicherer Router mit dateibasierten Routen, Search-Params-Validierung und Loaders. Laut der TanStack Query Dokumentation ist Query der am häufigsten heruntergeladene Server-State-Cache für React. Laut der TanStack Start Dokumentation komponiert Start Router und Query mit Server Functions und Deployment Adapters. Laut dem TanStack Intent Repository ist Intent der Distributionsmechanismus, der Agent Skills mit jedem Paket ausliefert.

Der Grund, warum dies für einen Solo-SaaS-Entwickler im August 2026 relevant ist: Das Ökosystem hat aufgehört, eine Sammlung unabhängiger Bibliotheken zu sein, und beginnt, sich wie eine Plattform zu verhalten. Es gibt jetzt eine kanonische Antwort auf die Frage „wie baue ich ein React SaaS". Für einen breiteren Überblick besuchen Sie die TanStack Ship Features-Seite, das TanStack Ship Comparison Hub und den breiteren TanStack Ship Blog Index.

Bibliothek-für-Bibliothek-Status im August 2026

Ich betreibe jede Bibliothek in Produktion. Die Versionsnummern unten sind die, die ich tatsächlich in meiner package.json habe, Stand 1. August 2026; die Migrationsnotizen stammen aus Upgrades, die ich persönlich geshippt habe, nicht aus Changelog-Scraping.

TanStack Router — jetzt adoptieren, v1.131+ im Auge behalten

Router hat 2024 v1.0 überschritten und hat seitdem eine stetige Minor-Version-Taktung. Die Version, die ich nutze, ist v1.131.x. Die großen Änderungen seit v1.50 sind: Search-Params-Validierung unterstützt jetzt Zod 4 und Valibot, dateibasiertes Routing generiert einen typisierten Route-Tree zur Build-Zeit, und die notFoundComponent/errorComponent-Oberfläche deckt finally defer-Style-Data-Patterns sauber ab. Laut der TanStack GitHub Organization waren die v1.100+-Releases größtenteils Stabilitäts- und SSR-Politur — keine große API-Turbulenz seit v1.80.

Das Produktionspattern, das sich über alle zwölf Apps gehalten hat, ist der typisierte Route Context:

// src/routes/__root.tsx
import {
  createRootRouteWithContext,
  Outlet,
} from "@tanstack/react-router"
import { QueryClient } from "@tanstack/react-query"
import type { D1Database } from "@cloudflare/workers-types"

interface RouterContext {
  auth: Auth
  queryClient: QueryClient
  db: D1Database
}

export const Route = createRootRouteWithContext<RouterContext>()({
  component: () => (
    <>
      <Header />
      <Outlet />
    </>
  ),
  notFoundComponent: () => <NotFound />,
  errorComponent: ({ error }) => <ErrorBoundary error={error} />,
})

Jede Child-Route ruft context() auf und erhält ein typisiertes Handle auf Auth, Query und das Database Binding. Dies ist der Hauptgrund, warum Router React Router für typsicheres SaaS schlägt — der Route Tree ist ein Typ, über den der Compiler nachdenkt, keine string-keyed Lookup.

Migrationsreibungen, die ich erlebt habe: Der v1.50 → v1.80-Sprung änderte, wie defer-Returns funktionieren; Loaders, die useLoaderData() verwendeten, mussten als Route.useLoaderData() umgeschrieben werden. Die mechanische Migration dauerte etwa zwei Stunden pro App. Der v1.80 → v1.131-Bogen war für mich bisher drop-in.

TanStack Query — jetzt adoptieren, auf v6.x

Query v5 war das letzte Release, bei dem man „die Docs neu lesen sollte". Query v6, das ich seit Ende 2025 nutze, ist ein Stabilitäts- und Developer-Experience-Release: Die Optimistic-Update-API ist sicherer (der Rollback-Kontext ist jetzt typisiert), die SSR-Integration mit Start ist First-Class, und der neue queryOptions-Helper hat den meisten useQuery({ queryKey, queryFn })-Boilerplate eliminiert.

// src/queries/products.ts
import { queryOptions } from "@tanstack/react-query"

export const productsQuery = (filters: ProductFilters) =>
  queryOptions({
    queryKey: ["products", filters],
    queryFn: () => fetchProducts(filters),
    staleTime: 30_000,
    gcTime: 5 * 60_000,
  })

Das queryOptions-Pattern komponiert sauber mit Router Loaders — der Loader ruft die Options Factory auf, gibt die Daten zurück, und die Komponente liest dieselben Options via useQuery(productsQuery(filters)). Die Single Source of Truth für die Query-Konfiguration ist die productsQuery()-Funktion. Ich habe seit sechs Monaten kein Raw-useQuery mehr geschrieben.

Migrationsreibungen, die ich erlebt habe: Der v5 → v6-Sprung entfernte die deprecated cacheTime-Option zugunsten von gcTime. Das Umbenennen ist mechanisch, aber ich musste jeden useQuery-Block in allen zwölf Apps greppen. Die mechanische Migration dauerte einen Nachmittag.

TanStack Form — jetzt adoptieren, wenn Sie nicht-triviale Formulare haben

Form v1 ist seit Anfang 2025 stabil. Die Version, die ich nutze, ist v1.x. Die Bibliothek ist das am meisten unterschätzte Stück des Ökosystems; die meisten React-Apps implementieren Form State, Validierung und Dirty-Field-Tracking schlecht. Form macht alle drei. Das Pattern, das sich gehalten hat, ist der Field-Level-Validation-Hook:

import { useForm } from "@tanstack/react-form"

const form = useForm({
  defaultValues: { email: "", password: "" },
  validators: {
    onChange: ({ value }) => {
      if (!value.email.includes("@")) return "Invalid email"
      return undefined
    },
  },
  onSubmit: async ({ value }) => {
    await signIn(value)
  },
})

Die ehrliche Einschätzung: Form ist ausgezeichnet. Die meisten meiner Apps brauchen es nicht, weil Validierung in der Server Function lebt und das Formular ein dünner Client ist. Für mehrstufige Formulare, komplexe Field Arrays oder Cross-Field-Validierung lohnt sich Form. Für alles andere ist Vanilla-React-State in Ordnung.

TanStack Table — jetzt adoptieren für alles mit mehr als 50 Zeilen

Table v8 ist das Arbeitstier. Die Version, die ich nutze, ist v8.x. Headless, typsicher, Framework-agnostisch im Kern. Die Integration mit Query ist das Schlüsselpattern: Server-paginierten Daten fließen über einen einzelnen Hook in die Tabelle, und die Tabelle steuert den Page/Sort/Filter-State, der den nächsten Fetch antreibt. Table ist keine Beginner-Bibliothek — die API-Oberfläche ist groß — aber für jeden Screen, der eine Liste von Datensätzen zeigt, ist Table die einzige React-Table-Bibliothek, die Sie nicht dafür bestraft, sie zu nutzen. Die TanStack Table Dokumentation ist gründlich; die Migration von v7 auf v8 war ein Rewrite, kein Port.

TanStack Virtual — jetzt adoptieren für lange Listen

Virtual v3 ist klein, schnell und korrekt. Die Version, die ich nutze, ist v3.x. Die Bibliothek virtualisiert lange Listen (10.000+ Zeilen), ohne ein spezifisches Komponentenmodell zu erzwingen. Das kanonische Pattern ist: Virtualisiert die Zeilen, rendert mit Table, und der Browser malt nur, was sichtbar ist. Virtual ist die Bibliothek, die ich vergesse, dass sie existiert — Einmal einbauen und nie wieder anfassen.

TanStack Store — evaluieren, nicht standardmäßig adoptieren

Store v1 wurde Ende 2025 ausgeliefert. Die Version, die ich nutze, ist v1.x. Store ist ein Framework-agnostischer State-Primitive — denken Sie an Zustand, aber gebaut vom TanStack-Team. Ich habe eine App mit Store geshippt und die Änderung rückgängig gemacht. Die App brauchte keinen globalen Store; Query deckte den Server State ab, und der verbleibende Client State waren zwei useState-Calls. Store ist die richtige Antwort für Multi-Tab-Sync oder ephemeralen UI-State über viele Komponenten, aber für eine typische SaaS-App ist der Client State zu klein, um die Dependency zu rechtfertigen.

TanStack Start — jetzt adoptieren für neue Projekte

Start ist das Full-Stack-Framework, das Router und Query mit Server Functions und Deployment Adapters komponiert. Laut der TanStack Start Dokumentation zielt Start standardmäßig auf Cloudflare Workers, Netlify, Vercel und Node. Die Version, die ich in Produktions-Apps nutze, ist die v0.x-Linie, die Mitte 2026 Beta überschritten hat.

Das Pattern, das sich gehalten hat, ist die Server Function:

// src/server/products.ts
import { createServerFn } from "@tanstack/start"
import { z } from "zod"

export const getProducts = createServerFn()
  .validator(z.object({ page: z.number().min(1).default(1) }))
  .handler(async ({ data, context }) => {
    return context.db.products.findMany({
      page: data.page,
      limit: 25,
    })
  })

Die Server Function läuft nur auf dem Server, nimmt eine typisierte Input, gibt eine typisierte Output zurück und integriert sich automatisch mit dem Query Cache. Das Pattern hat jeden API Route in meinen neueren Apps ersetzt. Start ist der richtige Standard für ein neues TanStack-SaaS-Projekt im August 2026. Für ein bestehendes Router-only-Projekt ist die Migration nicht trivial — Start ändert den Bundler, die SSR-Pipeline und das Deployment Target — also würde ich nicht migrieren, es sei denn, das Projekt braucht Server Functions oder SSR Streaming.

TanStack Intent — jetzt adoptieren, das ist die Wette

Intent ist das neueste Stück des Ökosystems. Laut dem TanStack Intent Repository ermöglicht Intent einem Paket, Agent Skills zu versenden — versionierte Markdown-Artefakte, die KI-Coding-Tools direkt aus node_modules konsumieren. Die Version, die ich verfolge, ist pre-1.0.

Der Mechanismus ist straightforward: Wenn Sie ein TanStack-Paket installieren, kommen die Skills mit. Wenn Claude Code oder Cursor Ihr Projekt indexiert, werden die Skills automatisch gelesen. Intent ist die folgenreichste Ökosystem-Ergänzung seit Router v1.0 — die Skills werden mit dem Code geshippt, also wird „die KI kennt die Konventionen meines Frameworks" von einem Dokumentationsproblem zu einem Distributionsproblem. TanStack Ship nutzt Intent, um Skills für jedes seiner 14 Module zu bündeln. Wenn Sie ein TanStack-Projekt im August 2026 starten, installieren Sie die Skills einmal, und der Rest des Projekts ist schneller.

Öffentliche Roadmap-Signale für Ende 2026

Die TanStack-öffentlich Roadmap ist kein einzelnes Dokument; sie ist eine Sammlung von GitHub-Meilensteinen, Diskussionsthreads und Tanner Linsleys periodischen Posts. Die Signale, die ich verfolge, in Prioritätsreihenfolge:

Signal 1 — Start 1.0 mit stabilem SSR

Der Start-Repo-1.0-Meilenstein umfasst stabiles SSR-Streaming, vollständige Router-Parität und einen einzelnen kanonischen Deployment Adapter pro Plattform. Ich erwarte, dass Start 1.0 vor Ende 2026 ausgeliefert wird. Die Signalstärke ist hoch — es gibt einen Meilenstein-Tracker auf der TanStack GitHub Organization und die Commits landen seit Q1 auf einer stabilen Taktung.

Signal 2 — Intent 1.0

Das Intent-Repo war die meiste Zeit von 2026 in der Pre-1.0-Phase. Der 1.0-Meilenstein umfasst eine stabile Skills-Spezifikation, ein Registry von Community-contribuierten Skills und Integration mit den großen KI-Coding-Tools. Die Signalstärke ist mittel — Intent ist jünger als Start und die Release-Taktung ist weniger vorhersehbar.

Signal 3 — Router Typegen Pipeline-Konsolidierung

Die Router-Typegen-Pipeline generiert derzeit einen Route-Tree zur Build-Zeit. Das Roadmap-Signal ist eine Konsolidierung hin zu einer einzelnen, schnelleren, Monorepo-freundlichen Pipeline, die sowohl dateibasierte als auch codebasierte Routen unterstützt. Die Signalstärke ist mittel.

Signal 4 — Query SSR-Ausrichtung mit Start

Query hat seine eigenen SSR-Helper; Start hat seine eigenen Data-Loading-Helper. Das Roadmap-Signal ist Ausrichtung — ein kanonisches Pattern für die Hydration von Server-Daten auf dem Client. Signalstärke: mittel bis hoch.

Signal 5 — MCP/WebMCP-Integration

Das TanStack-Ökosystem fügt still und leise Model Context Protocol Support hinzu. Die Signalstärke ist explorativ — es gibt einen WebMCP-Vorschlag und ein TanStack Router Server-Card-Pattern. Für einen breiteren Überblick, wo KI-Tooling in TanStack passt, lesen Sie den TanStack Intent erklärt-Post und den WebMCP und TanStack Router Server Card-Post.

Was Sie jetzt adoptieren sollten versus warten

Die Adoption-Tabelle unten spiegelt die Produktionsreibungen von zwölf Apps wider. Es ist kein Roadmap-Dokument; es ist das, was ich einem anderen Solo-Dev im August 2026 sagen würde.

Die „Vermeiden"-Spalte ist leer, weil ich auf keine TanStack-Bibliothek gestoßen bin, die aktiv schlecht ist. Die „Warten"-Spalte erfasst Bibliotheken, die sich für eine bestimmte Art von Projekt lohnen, aber nicht im Default-SaaS-Stack enthalten sein müssen.

Anti-Patterns, die mich Zeit gekostet haben

Drei Anti-Patterns sind erwähnenswert. Erstens, TanStack-Pakete upgraden, ohne die Migrationsanleitung zu lesen. Die v5 → v6-Query-Migration hat cacheTime in gcTime umbenannt; die v1.50 → v1.80-Router-Migration hat geändert, wie defer funktioniert. Die Anleitung überspringen kostet einen Nachmittag; sie zu lesen kostet zehn Minuten. Zweitens, Store standardmäßig adoptieren. Zwei meiner Apps haben Store hinzugefügt, bevor sie es brauchten; beide haben revertiert, als sich herausstellte, dass der globale State ein oder zwei useState-Calls waren. Drittens, eine Custom Table schreiben. Das React-Table-Ökosystem ist groß und das meiste davon ist schlecht. TanStack Table ist die einzige React-Table-Bibliothek, die ich 2026 geshippt habe und die keinen Rewrite in Monat sechs generiert hat.

Abschließende CTA

Das TanStack-Ökosystem im August 2026 ist so stabil wie nie zuvor. Router und Query sind ausgereift. Table, Virtual und Form sind produktionsreif. Start ist der richtige Standard für neue Projekte. Intent ist die Wette, die sich jetzt lohnt. Das Günstigste, was Sie tun können, ist auf Router v1.131+ / Query v6 / Start Beta / Intent Pre-1.0 zu pinnen und zu shippen.

Für die Runtime-Entscheidungen am Edge lesen Sie den Cloudflare Workers 2026 Guide; für die Data Layer den Cloudflare D1 Production Guide; für die Auth-Oberfläche den SaaS Authentication Guide. Die TanStack Ship Features-Seite hat die Runtime-Primitives; die Pricing-Seite hat das Packaging-Modell. Wenn Sie zwischen TanStack und anderen React-Stacks wählen, hat das TanStack Ship Comparison Hub die Side-by-Side-Analysen.