Stack

Kern-Stack

Schicht	Technologie
Framework	TanStack Start (React, SSR)
UI	UUI (Untitled UI) — kein shadcn
Auth	Better Auth + Drizzle ORM
Server-Logik	Effect v4 Beta
Deployment	Cloudflare Workers
Auth-DB	D1 (addxion-auth)
App-DB	Neon + Hyperdrive (geplant)
E-Mail	Resend
LLM	OpenRouter

Konventionen

• Bun als Package Manager
• Server-only: Auth, DB und PG-Module nicht im Client-Bundle — .server-Suffix und dynamische Imports in Loaders
• Drizzle-Migrationen: immer mit --name: bun run db generate -- --name=descriptive-name
• Lint-Gate: bun run lint:server für Worker-/Effect-/API-Änderungen

Environment

Pflicht (Server): AUTH_SECRET, Binding AUTH_DB
Pflicht (Build): VITE_BASE_URL = öffentliche App-URL (https://addxion.ai)
Optional: BETTER_AUTH_URL, AUTH_GOOGLE_*, GITHUB_CLIENT_*, RESEND_API_KEY, OPENROUTER_API_KEY

Verwandte Docs

• Architecture — Repos, Deployment, Neon-Migration
• Repo Boundaries — Grenzen zwischen addxion-ai, addxion-com und addxion-neon

Truths

ID	Wahrheit
T-PKG-AI	LLM-SSOT in @addxion/ai
T-PKG-BOUNDARY	Package-Grenzen nicht ohne Vertrag überschreiten
T-MAINTAIN	Einmal pflegen — keine Doppelpflege

Für Agents

Scope: Technologie-Stack der addxion.ai App.

• Stack-Änderungen mit Package-Grenzen in packages.md abgleichen
• Shared Packages vor App-lokaler Reimplementierung