Zum Inhalt springen
supastack
Dokumentation durchstöbern
WebNext.js

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/web/tech-stack.md (or send Accept: text/markdown).

Tech-Stack

Die Technologien hinter dem Kit und die Rolle jeder einzelnen.

Zu dieser Anleitung fragen
Öffnen in

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/.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 dev

Anwendungs-Stack

Die Web-App ist eine Next.js-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.

Next.js + React

Die Web-App läuft auf Next.js 16 mit dem App Router 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      # browser flows

Häufige Fragen

14 Fragen

Was ist supastack?

supastack ist eine modulare Basis zum Bauen von KI-gestützten SaaS-Produkten. Sie bündelt die gemeinsame Infrastruktur, damit du dich auf die Funktionen konzentrieren kannst, die dein Produkt ausmachen.

Unterstützt es Web und Mobil?

Ja. supastack enthält Next.js- und Expo-Apps als Ausgangspunkt für Web- und Mobile-Erlebnisse.

Welche Authentifizierung ist enthalten?

Better Auth deckt E-Mail/Passwort, OTP und Social Login ab. Persönliche Workspaces werden mit dem Konto provisioniert, damit Datensätze vom ersten Tag an begrenzt sind.

Wie wird KI unterstützt?

supastack enthält konfigurierbare Multi-Anbieter-KI, Nutzungsverfolgung, Budgets und verschlüsselte Bring-your-own-key-Unterstützung.

Wie werden Abonnements gehandhabt?

Für Produkte, die auf dem Kit aufbauen, bilden Stripe-Abrechnung, Abonnements und Berechtigungen die Basis für bezahlten Zugang. Anbieter-Geheimnisse bleiben serverseitig.

Wo liegt mein produktspezifischer Code?

Produktspezifische Funktionen bleiben in einem separaten Codebase, während das Produkt die Basismodule von supastack konfiguriert und integriert.

Wie funktioniert die Preisgestaltung von supastack?

Das Kit ist ein Einmalkauf mit lebenslangen Updates: Ein Framework für 249 $ (befristeter Einführungspreis — 100 $ Rabatt auf den regulären Preis von 349 $) oder Alle Frameworks (Next.js, iOS, Android) für 499 $ (befristeter Einführungspreis — 100 $ Rabatt auf den regulären Preis von 599 $), plus 75 $ pro zusätzlichem Entwickler-Sitz. Kein Kit-Abo. Checkout auf dieser Website liefert deinen Lizenzschlüssel per E-Mail, mit Repo-Zugang per GitHub-Einladung.

Wie begrenzen Workspaces meine Daten?

Nutzerdatensätze sind über workspaceId begrenzt. Identität, Berechtigungen, KI-Nutzung, Abrechnungsereignisse und Audit-Einträge bleiben innerhalb der persönlichen Workspace-Grenze.

Wie funktionieren Hintergrundjobs?

Trigger.dev ist die explizite Job-Laufzeit. Der JobRunner-Vertrag verspricht nur enqueue, status und cancel — Workflow-Semantik bleibt Trigger.dev-spezifisch und explizit.

Wie unterscheidet sich E-Mail von Outreach?

Transaktions-E-Mail deckt Produktabläufe wie Task-Abschluss-Hinweise ab. Cold Outreach und Kampagnen gehören zum Produkt selbst, außerhalb des E-Mail-Moduls dieses Kits.

Wie funktionieren mobile Käufe?

Mobile bietet native Käufe und Wiederherstellung über RevenueCat; dein Server prüft den Zugriff. Konfiguriere die Store-Konten und schließe Gerätetests vor der Veröffentlichung ab. Web-Abrechnung bleibt separat.

Wo liegen die KI-Anbieter-Schlüssel?

BYOK-Zugangsdaten sind verschlüsselt und bleiben serverseitig. Schlüssel werden in Logs bereinigt; Nutzung und Budgets bleiben auf Workspace-Ebene sichtbar.

Welche Zahlungsmethoden akzeptiert der Checkout?

Der von Stripe gehostete Checkout akzeptiert Karten und kann — sobald die Wallets im Stripe-Konto aktiviert sind — auch Alipay und WeChat Pay anbieten, praktisch für Käufer in China. Wallet-Autorisierungen werden asynchron bestätigt, sodass sich die Lizenzseite aktualisiert, sobald die Zahlung eingegangen ist.

Kann ich eine Rückerstattung erhalten?

Sobald du Zugriff auf das Repository hast, gehört supastack für immer dir und kann daher nicht zurückerstattet werden. Aber keine Sorge: Du erhältst den vollständigen Quellcode mit lebenslangen Updates, um unbegrenzt viele Produkte für dich oder deine Kunden zu erstellen und zu veröffentlichen. Du darfst den Code lediglich nicht weiterverkaufen oder das Repository als Starter-Kit oder Vorlage weitergeben.

DE
Design