Entwicklungsumgebung

Dieser Abschnitt beschreibt den eingesetzten Stack und wie die Anwendung lokal gestartet werden kann.

Stack Übersicht

Die wichtigsten Komponenten der Webanwendung sind:

Bun als JavaScript Runtime und Package Manager
React 19 für das User Interface
TanStack Start als Full-Stack Framework (SSR, Serverfunktionen)
TanStack Router für das File-basierte Routing
Tailwind CSS und shadcn/ui für Styling und UI Bausteine
better-auth zur Authentifizierung
Drizzle ORM beziehungsweise eigene DB Pakete in packages/db

Projektstruktur

Die Wurzel des Repositories enthält:

apps/web als React Webfrontend
apps/fumadocs als Dokumentationsfrontend
packages für gemeinsame Pakete wie DB Schema und Auth Konfiguration

Web App

Unter apps/web befinden sich:

src/components für UI Komponenten
src/routes für tanstack Routen
src/server für Serverfunktionen
src/lib für Hilfsfunktionen wie auth-client oder Navigationsparser

Dokumentation

Unter apps/fumadocs/content/docs liegen die MDX Dateien, die diese Dokumentation bilden.
Fumadocs erzeugt daraus die Dokumentationsoberfläche.

Lokaler Start

Um die Anwendung lokal zu starten:

Im Projektstamm bun install ausführen
Anschließend bun dev beziehungsweise turbo dev starten
Für DB bezogene Aufgaben die Scripts unter package.json nutzen, etwa bun db:start über die turbo Pipeline

Je nach Setup können zusätzliche Umgebungsvariablen erforderlich sein, etwa für DB Verbindungen oder OAuth Provider.
Diese werden in der Regel in einer .env Datei hinterlegt und von bun beziehungsweise tanstack Start geladen.