> ## Documentation Index
> Fetch the complete documentation index at: https://supastack.dev/llms.txt
> Use this file to discover all available pages before exploring further.
> For the full documentation corpus in one file, fetch: https://supastack.dev/llms-full.txt

# Einführung

Was supastack ist, was du bekommst und der Weg zu einer laufenden App.

## Beginnen Sie hier: was Sie erhalten haben

Das Kit ist eine Start-App, die Sie individuell anpassen können. Web ist die Browseroberfläche plus der Server API; Mobile ist die Telefonschnittstelle; Desktop ist ein natives Fenster, in dem die Web-App angezeigt wird. Ein API ist die Serveradresse, die ein Client aufruft, um sich anzumelden oder Daten zu lesen. Geteilte Pakete sind wiederverwendbare Teile, die von diesen Apps verwendet werden.

Beginnen Sie mit dem folgenden Web-Local-Tutorial. Es erklärt Ihnen genau, wie Sie Bibliotheken herunterladen, den Server starten und einen gefälschten AI task ausführen. Fügen Sie dann die Datenbank für gespeicherte Konten hinzu, wählen Sie nur die Anbieter aus, die Ihr Produkt benötigt, passen Sie Ihre Marke an und bereiten Sie das Hosting vor. Die technischen Erläuterungen können Sie später nachlesen; Sie sind keine Voraussetzung für die Eröffnung der ersten Demo.

[Installieren Sie die Tools und erhalten Sie den Code](https://supastack.dev/de/docs/web/before-you-start.md)

[Erfahren Sie, wie Sie einen Befehl ausführen und eine Datei bearbeiten](https://supastack.dev/de/docs/web/terminal-basics.md)

[Folgen Sie dem vollständigen Web-First-Run-Tutorial](https://supastack.dev/de/docs/web/ship-in-5-minutes.md)


## Auf gemeinsamer Grundlage bauen

supastack ist eine modulare Grundlage für KI-SaaS im Web, auf Mobilgeräten und auf dem Desktop. Next.js stellt die Weboberfläche und API bereit, Expo bietet native Referenzabläufe, und die Tauri-Desktop-Shell lädt dieselbe Web-App. Gemeinsame Pakete übernehmen Identität, Workspaces, Abrechnung, KI, Jobs, E-Mail, Speicher und Observability.

Beginnen Sie mit dem lokalen Referenzablauf, um zu verstehen, wie die Module zusammenarbeiten. Konfigurieren Sie Produktionsanbieter erst, wenn dieser Ablauf in Ihrer Umgebung funktioniert.


## Orientieren Sie sich

Anwendungen setzen die gemeinsamen Pakete zusammen. Produktspezifische Funktionen gehören in die Codebasis des jeweiligen Produkts und nicht in den wiederverwendbaren Kern.

```
apps/
  web/       Next.js interface and API routes
  mobile/    Expo application
packages/
  auth/      Identity and sessions
  db/        Schema and workspace persistence
  billing/   Billing and entitlements
  ai/        Providers, routing, and usage
  jobs/      Background job contract
  email/     Transactional delivery
```


## Wählen Sie Ihren Einstiegspunkt

Beginnen Sie mit der lokalen Einrichtung in fünf Minuten. Folgen Sie anschließend dem Link „Einrichtung fortsetzen“ am Ende jedes Leitfadens: Konfigurieren Sie Datenbank, Authentifizierung, Pläne und Anbieter, bevor Sie die Bereitstellung vorbereiten. Im vollständigen Dokumentationsindex finden Sie alle Funktionen, Anbieter, Komponenten und Referenzen.

Der lokale Golden Path wurde in der Entwicklungsumgebung des Projekts erfolgreich durchlaufen. Eine Zeitmessung bei einer sauberen Klon-Kopie, Tests mit echten Anbietern, Bereitstellung und Abnahme auf physischen Geräten sind separate Prüfschritte.

[Lokale Einrichtung in fünf Minuten](https://supastack.dev/de/docs/web/ship-in-5-minutes.md)

[Gesamte Dokumentation durchsuchen](https://supastack.dev/de/docs/web/project-structure.md)

[Mobile Einrichtung](https://supastack.dev/de/docs/mobile/ship-in-5-minutes.md)

[Desktop-Setup](https://supastack.dev/de/docs/desktop/ship-in-5-minutes.md)

[Erfahren Sie, wie Sie in dieser Dokumentation navigieren](https://supastack.dev/de/docs/web/using-the-docs.md)


## Willkommen bei supastack

supastack ist ein modulares Kit für KI-SaaS-Produkte: eine Next.js-Web-App, eine Expo-Mobile-App und eine Tauri-Desktop-Shell, alle gebaut auf geteilten TypeScript-Paketen für Auth, Billing, KI, Jobs, E-Mail, Storage und Observability.

Nach dem Kauf erhältst du eine GitHub-Einladung zu den Kit-Repositories — Web, Mobile und Desktop (das All-Platforms-Bundle liefert das volle Monorepo). Klone die Oberfläche, die du auslieferst, und mache sie zu deiner.

Diese Docs sind ein Schritt-für-Schritt-Pfad, keine Referenz-Ausschüttung: Bring die App zuerst lokal zum Laufen und gehe dann die Anbieter-Setup-Seiten der Reihe nach durch. Jede Seite endet mit einem Verweis auf die nächste.


## Einen lokalen Server starten

Du brauchst Node.js 22 oder neuer. Das Repo pinnt seinen Paketmanager (packageManager: pnpm@11.19.0), also führe pnpm über Corepack aus — keine globale Installation nötig.

1. Kopiere die Umgebungsdatei, um deine lokale Konfiguration zu erstellen.

2. Installiere die Workspace-Abhängigkeiten.

3. Starte optional den lokalen Postgres-Container für echte Persistenz — die Defaults laufen ohne ihn.

4. Starte den Dev-Server und öffne http://localhost:3000.

```
cp .env.example .env
corepack pnpm install
docker compose up -d postgres   # optional local database
corepack pnpm dev

# → http://localhost:3000
```


## Die .env-Datei

In den Umgebungseinstellungen wird der vom Kit verwendete lokale oder gehostete Dienst ausgewählt. Kopieren Sie .env.example für Migrationen in das Stammverzeichnis .env und für den Webserver nach apps/web/.env.local. Expo verwendet apps/mobile/.env.local.. Durch das Kopieren nur der Root-.env-Datei wird nicht jede App konfiguriert.

Die standardmäßigen gefälschten/lokalen Anbieter benötigen keine kostenpflichtigen API-Anmeldeinformationen. Sie ermöglichen es Ihnen, die In-Memory-/Dashboard-Demonstration durchzuführen. Für die echte Anmeldung unter /auth sind weiterhin PostgreSQL und Migrationen erforderlich. Ändern Sie bei einem echten Anbieter nur die benannten Einstellungen in der Webkonfigurationsdatei, speichern Sie sie, stoppen Sie dann den Server und starten Sie ihn neu. Geben Sie niemals Geheimnisse über die Werte NEXT_PUBLIC_ oder EXPO_PUBLIC_ preis.


## Wähle deinen Weg

Neu hier? In 5 Minuten shippen führt dich vom Klon zu einer laufenden App — nur mit Defaults.

Du baust für Telefon oder Desktop? Die Tabs Mobile und Desktop decken die Expo- und Tauri-Oberflächen ab. Sobald die App läuft, führt dich die Gruppe Anbieter einrichten Doc für Doc durch jede Integration.


Wenn du die Einrichtung fortsetzen möchtest, lies [In 5 Minuten shippen](https://supastack.dev/de/docs/web/ship-in-5-minutes.md).


## Weiter

[In 5 Minuten shippen](https://supastack.dev/de/docs/web/ship-in-5-minutes.md)
