Zum Inhalt springen
supastack
Dokumentation durchstöbern
WebTanStack Start

For AI agents: fetch the complete documentation index at /llms.txt, the full documentation corpus at /llms-full.txt, the agent skill at /skill.md, or this page as Markdown at /de/docs/tanstack/tech-stack.md (or send Accept: text/markdown).

Tech-Stack

Die Technologien hinter dem Kit und die Rolle jeder einzelnen.

Bevor Sie beginnen

Öffnen Sie Ihr heruntergeladenes Supastack-Projekt in Visual Studio Code über Datei → Ordner öffnen und wählen Sie dann Terminal → Neues Terminal. Das Repository-Stammverzeichnis ist der Ordner, der package.json, Apps und Pakete enthält. Führen Sie dort den Befehl unten aus und lassen Sie das Terminal geöffnet. Wenn ein Befehl nicht erkannt wird, lesen Sie die Installationsanleitung für das Tool durch, bevor Sie fortfahren.

Lesen Sie zuerst das Plattform-Tutorial. Ein Server ist der App-Prozess, der Browser- oder Telefonanfragen beantwortet. Web liest apps/web-tanstack/.env.local, Expo liest apps/mobile/.env.local und Datenbankmigrationsbefehle lesen root .env. Die Demonstration ohne Datenbank /Dashboard ist getrennt von echten /Auth-Konten, die migriert werden müssen Postgres. Für eine reine Telefon- oder Desktop-Kaufabwicklung ist ein separat ausgeführtes Web-Backend erforderlich.

corepack pnpm --filter @supastack/web-tanstack dev

Anwendungs-Stack

Die Web-App ist eine TanStack Start-Anwendung aus gemeinsamen TypeScript-Paketen — dieselben Pakete speisen die Expo-Mobile-App. Produkt-Chrome nutzt CSS Modules über Design-Tokens, es gibt also kein Runtime-CSS-in-JS zu debuggen, und der Objektspeicher ist S3-kompatibel. Die folgenden Tools sind die bewussten Defaults.

TanStack Start + React

Die Web-App läuft auf TanStack Start mit TanStack Router-Dateirouten und React 19 Server Components.

TypeScript + Turborepo

TypeScript Strict Mode gilt im gesamten pnpm-Workspace, und Turborepo koordiniert Builds.

Better Auth

Better Auth ist die Identitäts-Engine; eine Auth.js-Engine steht für Teams bereit, die darauf standardisieren.

Drizzle + PostgreSQL

Persistenz läuft über das Drizzle-ORM auf PostgreSQL — das Schema und die Helfer, durch die jeder Datensatz fließt.

Abrechnung

Stripe-Abrechnung ist der Standard, und ein Lemon Squeezy-Adapter ist enthalten.

Trigger.dev

Hintergrundjobs laufen über Trigger.dev.

Transaktions-E-Mail

Transaktions-E-Mails werden über Resend oder AWS SES versendet.

Sentry + PostHog

Observability läuft über Sentry und PostHog.

Expo

Die Expo-Mobile-App nutzt dieselben TypeScript-Pakete, sodass Vertragsänderungen gegen beide Oberflächen gleichzeitig typgeprüft werden. Expo liefert Builds für iOS und Android.

Geteilte Module

Jede querschnittliche Fähigkeit lebt in einem Paket mit kleinem Vertrag: auth, db, billing, ai, jobs, email, storage, observability, config, i18n und api. Anwendungen komponieren sie; Produkt-Domänenlogik bleibt außerhalb des Kits.

Jedes anbietergebundene Modul bringt einen Fake- oder Local-Adapter mit, damit die Standard-Test- und Entwicklungsschleife nie einen kostenpflichtigen Dienst aufruft.

Verifizierungs-Tooling

Vitest deckt Unit- und Integrationsverhalten ab, Playwright Browser-Abläufe, und ESLint plus Prettier halten den Code konsistent. Die deterministische Suite läuft ohne Anbieter-Credentials; echte Anbieter-Akzeptanz ist ein separat abgesicherter Pfad.

corepack pnpm test              # deterministic unit + integration
corepack pnpm check             # lint, types, tests, format
corepack pnpm build             # production builds
corepack pnpm test:e2e:tanstack  # browser flows