Dokumentation

Einführung

Was Motoko Base ist, was enthalten ist und wie Sie diese Dokumentation nutzen.

Motoko Base ist ein produktionsreifer, full-stack SaaS-Starter für Next.js. Es ist kein fertiges Endnutzerprodukt — es ist eine Grundlage, die Sie klonen, konfigurieren und erweitern, während Sie dieselben Muster für Auth, Daten, Billing und Integrationen beibehalten.

Nutzen Sie diese Dokumentation, um zu verstehen, wie der Starter aufgebaut ist, was out of the box mitgeliefert wird und wie Sie ihn für Ihr eigenes Produkt anpassen.

Was ist Motoko Base?

Motoko Base liefert ein vollständiges Anwendungsskelett: authentifiziertes Dashboard, geschützte Routen, Datenbankschicht, Billing-Abstraktion, Transaktions-E-Mail, optionale Storage- und KI-Demos, Analytics- und Monitoring-Anbindung, Marketing-Seiten und Entwickler-Tooling.

Das Ziel ist einfach — bauen Sie Ihr SaaS, nicht dessen Infrastruktur. Sie konzentrieren sich auf Produktfeatures; der Starter übernimmt die repetitive Verdrahtung, die jedes SaaS braucht.

Was ist im Starter enthalten?

Kern-Foundation

Authentifizierung — Better Auth mit E-Mail/Passwort, Verifizierung, Passwort-Reset und optionalem Google- und GitHub-OAuth
Datenbank — PostgreSQL mit Drizzle ORM, typsicheren Schemas und Migrationen
Billing — Polar-Integration mit Checkout, Abonnements, Webhooks und Entitlements (soft-fail, wenn nicht konfiguriert)
E-Mail — Resend für Transaktionsmail (Verifizierung, Passwort-Reset, Templates)
Dashboard-Shell — Sidebar-Navigation, Einstellungen, Theme und geschütztes Layout
Marketing-Site — Landingpage, Pricing-Bereich, Docs und Changelog
Analytics & Monitoring — PostHog- und Sentry-Integrationen (optional, nicht blockierend)
KI-bereite Infrastruktur — Vercel AI SDK mit einem OpenAI-kompatiblen Provider

Demo-Features

Demo-Features liegen unter der Nav-Gruppe Demos. Sie zeigen echte Architektur, die Sie in Ihr Produkt übernehmen oder vollständig löschen können:

Link Manager — CRUD für Links mit öffentlichen Redirect-Routen (/r/[slug])
File Storage — Cloudflare-R2-Uploads mit Ownership-Checks
AI Email — Streaming-KI-Endpoint im Dashboard

Demos sind bewusst entfernbar. Siehe README für eine sichere Lösch-Checkliste.

Für wen ist es gedacht?

Motoko Base ist für Entwickler und kleine Teams gebaut, die ein SaaS-Produkt schneller ausliefern wollen, ohne denselben Stack jedes Mal von Grund auf zusammenzusetzen.

Es passt gut, wenn Sie:

Eine echte, funktionierende Anwendung wollen — kein Minimal-Template mit Platzhalter-Routen
Meinungsstarke Muster einem leeren Canvas vorziehen (Server Actions, Feature-Ordner, Zod-Validierung)
Produktionsintegrationen verdrahtet brauchen, die aber soft-failen, wenn Env-Vars fehlen
Den Quellcode besitzen und anpassen wollen — Features hinzufügen, Demos entfernen, Provider tauschen

Es richtet sich nicht an Nicht-Entwickler oder Teams, die einen No-Code-Builder suchen.

Wie diese Dokumentation organisiert ist

Docs sind versionierte MDX-Dateien unter content/docs/, gerendert unter /docs mit Fumadocs.

Sidebar — gesteuert durch meta.json-Dateien in jedem Ordner; Seiten hinzufügen, indem Sie eine MDX-Datei anlegen und sie in der meta.json des Ordners auflisten
Erste Schritte — Installation und Erst-Setup (hier starten)
Guides — tiefere Einblicke in Features und Integrationen (werden ergänzt, wenn die Docs wachsen)
Changelog — Produktupdates unter /changelog, ebenfalls MDX unter content/changelog/

Jede Seite unterstützt Frontmatter (title, description) und Standard-Markdown. Codeblöcke, Überschriften und Querverweise funktionieren out of the box.

Für agentenorientierte Architekturregeln siehe AGENTS.md im Repository-Root.

Live-Demo ausprobieren

Bevor Sie lokal installieren, erkunden Sie die laufende Anwendung:

Live-Demo öffnen →

Die Demo lässt Sie sich anmelden, das Dashboard durchstöbern und die enthaltenen Demo-Features ausprobieren — Authentifizierung, Billing-UI, Einstellungen, Link Manager, Storage und AI Email —, damit Sie sehen, wie sich der Starter in der Praxis verhält.

Nächste Schritte

Bereit, Ihre eigene Kopie einzurichten?

Installation — Klonen, Env-Vars konfigurieren, Migrationen ausführen und den Dev-Server starten.

Projektstruktur — Wo Code liegt und wie Ordner organisiert sind.

Weiter →