diff --git a/.env.macmini.example b/.env.macmini.example
index 69a075427..a0b2c73a6 100644
--- a/.env.macmini.example
+++ b/.env.macmini.example
@@ -1,5 +1,21 @@
+# =============================================================================
 # Mac Mini Production Environment
-# Copy to .env.macmini and fill in the values
+# =============================================================================
+#
+# Copy to .env.macmini (gitignored) and fill in the values. This file is
+# loaded by `docker compose -f docker-compose.macmini.yml ...` on the
+# Mac Mini host. The compose file references vars via ${VAR} (REQUIRED —
+# missing means container fails to start) and ${VAR:-default} (OPTIONAL
+# — falls back to the inline default if unset).
+#
+# Sections below mirror that split:
+#   1. REQUIRED — production deployment cannot boot without these
+#   2. OPTIONAL — defaults exist in compose; only set to override
+#
+# Verify the example covers every var the compose file uses:
+#   grep -ohE '\$\{[A-Z_][A-Z0-9_]*' docker-compose.macmini.yml | sort -u
+# (audit baseline established 2026-04-08, see
+# docs/REFACTORING_AUDIT_2026_04.md item #9)
 
 # ============================================
 # Compose project name (pinned, do not change)
@@ -69,3 +85,120 @@ GRAFANA_PASSWORD=your-grafana-admin-password
 # Web Analytics (Umami)
 # ============================================
 UMAMI_APP_SECRET=your-umami-secret-here
+
+# =============================================================================
+# REQUIRED — production cannot boot without these
+# =============================================================================
+
+# ─── Azure OpenAI ───────────────────────────────────────────
+# Some compose entries reference ${AZURE_OPENAI_KEY} (no default), distinct
+# from the ${AZURE_OPENAI_API_KEY:-} above. Provide both — they may be the
+# same value or different keys depending on which deployment they hit.
+AZURE_OPENAI_KEY=
+AZURE_OPENAI_DEPLOYMENT=
+
+# ─── Azure Speech (mana-stt / mana-tts fallback) ────────────
+# Four rotation keys + endpoint. Get from Azure Portal → Speech resource.
+AZURE_SPEECH_ENDPOINT=
+AZURE_SPEECH_KEY_1=
+AZURE_SPEECH_KEY_2=
+AZURE_SPEECH_KEY_3=
+AZURE_SPEECH_KEY_4=
+
+# ─── Azure Blob Storage (Memoro batch audio) ────────────────
+AZURE_STORAGE_ACCOUNT_NAME=
+AZURE_STORAGE_ACCOUNT_KEY=
+
+# ─── Google Gemini ──────────────────────────────────────────
+# Used by mana-llm + several Gemini-Vision modules (planta, nutriphi).
+GEMINI_API_KEY=
+
+# ─── Service-to-service auth keys ───────────────────────────
+# Shared secrets backends use to call each other without going through
+# user JWTs. Generate with: openssl rand -base64 32
+# MANA_SERVICE_KEY appears in compose with BOTH a default and a no-default
+# reference, so it MUST be set to a real value in production.
+MANA_SERVICE_KEY=
+MANA_CREDITS_SERVICE_KEY=
+MEMORO_SERVICE_KEY=
+
+# ─── Memoro Supabase (legacy) ───────────────────────────────
+# Memoro still keeps recording metadata in Supabase. Move to mana_platform
+# is tracked in the Memoro CLAUDE.md.
+MEMORO_SUPABASE_URL=
+MEMORO_SUPABASE_SERVICE_KEY=
+
+# =============================================================================
+# OPTIONAL — defaults baked into docker-compose.macmini.yml
+# =============================================================================
+# Only uncomment + set if you want to override the in-compose default.
+# Each line shows the default that ships in the compose file so you know
+# what you're overriding.
+
+# ─── Database / Cache (defaults are insecure!) ──────────────
+# POSTGRES_PASSWORD=devpassword          # CHANGE for prod
+# REDIS_PASSWORD=redis123                # CHANGE for prod
+
+# ─── MinIO (defaults are insecure!) ─────────────────────────
+# MINIO_ACCESS_KEY=minioadmin            # CHANGE for prod
+# MINIO_SECRET_KEY=minioadmin            # CHANGE for prod
+
+# ─── Better Auth ────────────────────────────────────────────
+# Default falls back to ${JWT_SECRET}. Override only if you want a
+# distinct session-signing key.
+# BETTER_AUTH_SECRET=
+
+# ─── LLM models ─────────────────────────────────────────────
+# MANA_LLM_API_KEY=                      # default empty (open llm.mana.how)
+# MANA_LLM_MODEL=ollama/gemma3:12b
+# OLLAMA_URL=http://host.docker.internal:13434
+# OLLAMA_MODEL=gemma3:12b
+
+# ─── Third-party AI APIs (optional) ─────────────────────────
+# OPENROUTER_API_KEY=
+# GROQ_API_KEY=
+# GOOGLE_API_KEY=
+# TOGETHER_API_KEY=
+
+# ─── STT / TTS (defaults point to GPU box on LAN) ───────────
+# STT_SERVICE_URL=http://192.168.178.11:3020
+# TTS_SERVICE_URL=http://192.168.178.11:3022
+# MANA_STT_API_KEY=
+
+# ─── Stripe (defaults empty — billing disabled if unset) ────
+# STRIPE_SECRET_KEY=
+# STRIPE_CREDITS_WEBHOOK_SECRET=
+# STRIPE_SUBSCRIPTIONS_WEBHOOK_SECRET=
+
+# ─── Mail (Stalwart) — defaults work for the bundled stack ──
+# SMTP_HOST=stalwart
+# SMTP_PORT=587
+# SMTP_USER=noreply
+# SMTP_PASSWORD=ManaNoReply2026!         # CHANGE for prod
+# STALWART_ADMIN_PASSWORD=ChangeMe123!   # CHANGE for prod
+
+# ─── Search (SearXNG) ───────────────────────────────────────
+# SEARXNG_SECRET=change-me-searxng-secret
+
+# ─── Error tracking (GlitchTip / Sentry) ────────────────────
+# GLITCHTIP_DSN_MANA_WEB=
+# GLITCHTIP_SECRET_KEY=change-me-in-production
+
+# ─── Notifications ──────────────────────────────────────────
+# NTFY_TOPIC=
+# TELEGRAM_BOT_TOKEN=
+# TELEGRAM_CHAT_ID=
+
+# ─── Cloudflare (only if deploying landings via wrangler) ───
+# CLOUDFLARE_ACCOUNT_ID=
+# CLOUDFLARE_API_TOKEN=
+# EXPO_ACCESS_TOKEN=
+
+# ─── Admin / abuse limits ───────────────────────────────────
+# ADMIN_USER_IDS=                        # comma-separated user IDs
+# MAX_DAILY_SIGNUPS=0                    # 0 = unlimited
+
+# ─── Misc ───────────────────────────────────────────────────
+# AZURE_OPENAI_API_VERSION=
+# AZURE_STORAGE_CONTAINER=memoro-batch-audio
+# AZURE_SPEECH_REGION=germanywestcentral
diff --git a/apps/api/src/modules/chat/routes.ts b/apps/api/src/modules/chat/routes.ts
index df6aa607f..fe248010f 100644
--- a/apps/api/src/modules/chat/routes.ts
+++ b/apps/api/src/modules/chat/routes.ts
@@ -9,10 +9,11 @@
 import { Hono } from 'hono';
 import { streamSSE } from 'hono/streaming';
 import { consumeCredits, validateCredits } from '@mana/shared-hono/credits';
+import type { AuthVariables } from '@mana/shared-hono';
 
 const LLM_URL = process.env.MANA_LLM_URL || 'http://localhost:3025';
 
-const routes = new Hono();
+const routes = new Hono<{ Variables: AuthVariables }>();
 
 // ─── Chat Completion (sync) ──────────────────────────────────
 
diff --git a/apps/api/src/modules/contacts/routes.ts b/apps/api/src/modules/contacts/routes.ts
index 8a6a0051a..e2e4fd4cc 100644
--- a/apps/api/src/modules/contacts/routes.ts
+++ b/apps/api/src/modules/contacts/routes.ts
@@ -4,6 +4,7 @@
  */
 
 import { Hono } from 'hono';
+import type { AuthVariables } from '@mana/shared-hono';
 
 const ALLOWED_AVATAR_TYPES = new Set([
 	'image/jpeg',
@@ -13,7 +14,7 @@ const ALLOWED_AVATAR_TYPES = new Set([
 	'image/svg+xml',
 ]);
 
-const routes = new Hono();
+const routes = new Hono<{ Variables: AuthVariables }>();
 
 // ─── Avatar Upload (S3) ─────────────────────────────────────
 
@@ -33,9 +34,7 @@ routes.post('/:id/avatar', async (c) => {
 
 		if (file.type === 'image/svg+xml') {
 			// SVGs stay on shared-storage (Sharp can't process SVG)
-			const { createContactsStorage, generateUserFileKey } = await import(
-				'@mana/shared-storage'
-			);
+			const { createContactsStorage, generateUserFileKey } = await import('@mana/shared-storage');
 			const storage = createContactsStorage();
 			const key = generateUserFileKey(userId, `avatar-${c.req.param('id')}.svg`);
 			const result = await storage.upload(key, Buffer.from(buffer), {
diff --git a/apps/api/src/modules/context/routes.ts b/apps/api/src/modules/context/routes.ts
index 15305ffa7..8f3bdd2fd 100644
--- a/apps/api/src/modules/context/routes.ts
+++ b/apps/api/src/modules/context/routes.ts
@@ -7,10 +7,11 @@
 
 import { Hono } from 'hono';
 import { consumeCredits, validateCredits } from '@mana/shared-hono/credits';
+import type { AuthVariables } from '@mana/shared-hono';
 
 const LLM_URL = process.env.MANA_LLM_URL || 'http://localhost:3025';
 
-const routes = new Hono();
+const routes = new Hono<{ Variables: AuthVariables }>();
 
 // ─── AI Generation (server-only: mana-llm) ──────────────────
 
diff --git a/apps/api/src/modules/guides/routes.ts b/apps/api/src/modules/guides/routes.ts
index 365c0f635..238e19ac3 100644
--- a/apps/api/src/modules/guides/routes.ts
+++ b/apps/api/src/modules/guides/routes.ts
@@ -6,7 +6,8 @@
  * This module handles web import via mana-search + mana-llm, and share links.
  */
 
-import { Hono } from 'hono';
+import { Hono, type Context } from 'hono';
+import { logger } from '@mana/shared-hono';
 
 const MANA_SEARCH_URL = process.env.MANA_SEARCH_URL ?? 'http://localhost:3021';
 const MANA_LLM_URL = process.env.MANA_LLM_URL ?? 'http://localhost:3030';
@@ -35,7 +36,7 @@ routes.post('/import/url', async (c) => {
 			extracted = await res.json();
 		}
 	} catch (e) {
-		console.error('mana-search extract failed:', e);
+		logger.error('guides.extract_failed', { error: e instanceof Error ? e.message : String(e) });
 	}
 
 	const content = extracted.markdown ?? extracted.content ?? '';
@@ -128,7 +129,7 @@ routes.get('/share/:token', (c) => {
 // ─── Shared: LLM guide generation ──────────────────────────
 
 async function generateGuideFromText(
-	c: Parameters<Parameters<typeof Hono.prototype.post>[1]>[0],
+	c: Context,
 	opts: { text: string; title?: string; sourceUrl?: string; isAiPrompt?: boolean }
 ) {
 	const systemPrompt = `Du bist ein Experte für das Erstellen strukturierter Schritt-für-Schritt-Anleitungen.
@@ -189,7 +190,7 @@ Regeln:
 			throw new Error(`LLM error: ${llmRes.status}`);
 		}
 
-		const llmData = await llmRes.json<{ content: string }>();
+		const llmData = (await llmRes.json()) as { content: string };
 		const rawJson = llmData.content.trim();
 
 		// Extract JSON from potential markdown code fences
@@ -209,7 +210,7 @@ Regeln:
 			sections: parsed.sections ?? [],
 		});
 	} catch (e) {
-		console.error('Guide generation failed:', e);
+		logger.error('guides.generate_failed', { error: e instanceof Error ? e.message : String(e) });
 		return c.json({ error: 'Guide-Generierung fehlgeschlagen', details: String(e) }, 500);
 	}
 }
diff --git a/apps/api/src/modules/music/routes.ts b/apps/api/src/modules/music/routes.ts
index 41a2782e7..475dcd1cd 100644
--- a/apps/api/src/modules/music/routes.ts
+++ b/apps/api/src/modules/music/routes.ts
@@ -4,8 +4,9 @@
  */
 
 import { Hono } from 'hono';
+import type { AuthVariables } from '@mana/shared-hono';
 
-const routes = new Hono();
+const routes = new Hono<{ Variables: AuthVariables }>();
 
 // ─── Song Upload (presigned URL) ────────────────────────────
 
diff --git a/apps/api/src/modules/nutriphi/routes.ts b/apps/api/src/modules/nutriphi/routes.ts
index 2ae67b675..358fe4987 100644
--- a/apps/api/src/modules/nutriphi/routes.ts
+++ b/apps/api/src/modules/nutriphi/routes.ts
@@ -7,6 +7,7 @@
  */
 
 import { Hono } from 'hono';
+import { logger, type AuthVariables } from '@mana/shared-hono';
 
 const LLM_URL = process.env.MANA_LLM_URL || 'http://localhost:3025';
 
@@ -20,7 +21,7 @@ const ANALYSIS_PROMPT = `Du bist ein Ernährungsexperte. Analysiere die Mahlzeit
   "suggestions": []
 }`;
 
-const routes = new Hono();
+const routes = new Hono<{ Variables: AuthVariables }>();
 
 // ─── Photo Analysis (server-only: Gemini Vision) ────────────
 
@@ -81,7 +82,9 @@ routes.post('/analysis/photo', async (c) => {
 
 		return c.json(analysis);
 	} catch (err) {
-		console.error('Photo analysis failed:', err);
+		logger.error('nutriphi.photo_analysis_failed', {
+			error: err instanceof Error ? err.message : String(err),
+		});
 		return c.json({ error: 'Analysis failed' }, 500);
 	}
 });
@@ -115,7 +118,9 @@ routes.post('/analysis/text', async (c) => {
 
 		return c.json(analysis);
 	} catch (err) {
-		console.error('Text analysis failed:', err);
+		logger.error('nutriphi.text_analysis_failed', {
+			error: err instanceof Error ? err.message : String(err),
+		});
 		return c.json({ error: 'Analysis failed' }, 500);
 	}
 });
diff --git a/apps/api/src/modules/picture/routes.ts b/apps/api/src/modules/picture/routes.ts
index a1b380237..c7e8648e3 100644
--- a/apps/api/src/modules/picture/routes.ts
+++ b/apps/api/src/modules/picture/routes.ts
@@ -8,11 +8,12 @@
 
 import { Hono } from 'hono';
 import { consumeCredits, validateCredits } from '@mana/shared-hono/credits';
+import type { AuthVariables } from '@mana/shared-hono';
 
 const REPLICATE_TOKEN = process.env.REPLICATE_API_TOKEN || '';
 const IMAGE_GEN_URL = process.env.MANA_IMAGE_GEN_URL || '';
 
-const routes = new Hono();
+const routes = new Hono<{ Variables: AuthVariables }>();
 
 // ─── AI Image Generation (server-only: Replicate/local) ─────
 
diff --git a/apps/api/src/modules/planta/routes.ts b/apps/api/src/modules/planta/routes.ts
index 5ce574403..a34d79e20 100644
--- a/apps/api/src/modules/planta/routes.ts
+++ b/apps/api/src/modules/planta/routes.ts
@@ -7,10 +7,11 @@
  */
 
 import { Hono } from 'hono';
+import { logger, type AuthVariables } from '@mana/shared-hono';
 
 const LLM_URL = process.env.MANA_LLM_URL || 'http://localhost:3025';
 
-const routes = new Hono();
+const routes = new Hono<{ Variables: AuthVariables }>();
 
 // ─── Photo Upload (server-only: S3 storage) ─────────────────
 
@@ -38,7 +39,9 @@ routes.post('/photos/upload', async (c) => {
 			201
 		);
 	} catch (err) {
-		console.error('Upload failed:', err);
+		logger.error('planta.upload_failed', {
+			error: err instanceof Error ? err.message : String(err),
+		});
 		return c.json({ error: 'Upload failed' }, 500);
 	}
 });
@@ -81,7 +84,9 @@ routes.post('/analysis/identify', async (c) => {
 
 		return c.json(analysis);
 	} catch (err) {
-		console.error('Analysis failed:', err);
+		logger.error('planta.analysis_failed', {
+			error: err instanceof Error ? err.message : String(err),
+		});
 		return c.json({ error: 'Analysis failed' }, 500);
 	}
 });
diff --git a/apps/api/src/modules/presi/routes.ts b/apps/api/src/modules/presi/routes.ts
index 3adb31d73..641e18164 100644
--- a/apps/api/src/modules/presi/routes.ts
+++ b/apps/api/src/modules/presi/routes.ts
@@ -10,6 +10,7 @@ import { Hono } from 'hono';
 import { eq, and, gt, or, isNull, asc } from 'drizzle-orm';
 import { HTTPException } from 'hono/http-exception';
 import { authMiddleware } from '@mana/shared-hono/auth';
+import type { AuthVariables } from '@mana/shared-hono';
 import { drizzle } from 'drizzle-orm/postgres-js';
 import postgres from 'postgres';
 import {
@@ -112,7 +113,7 @@ function generateShareCode(): string {
 
 // ─── Routes ─────────────────────────────────────────────────
 
-const routes = new Hono();
+const routes = new Hono<{ Variables: AuthVariables }>();
 
 // ─── Public endpoint (no auth) ──────────────────────────────
 
@@ -187,7 +188,9 @@ routes.post('/share/deck/:deckId', async (c) => {
 	}
 
 	// Parse optional expiry
-	const body = await c.req.json<{ expiresAt?: string }>().catch(() => ({}));
+	const body = (await c.req.json<{ expiresAt?: string }>().catch(() => ({}))) as {
+		expiresAt?: string;
+	};
 
 	const [share] = await db
 		.insert(sharedDecks)
@@ -223,6 +226,7 @@ routes.get('/share/deck/:deckId/links', async (c) => {
 routes.delete('/share/:shareId', authMiddleware(), async (c) => {
 	const userId = c.get('userId');
 	const shareId = c.req.param('shareId');
+	if (!shareId) throw new HTTPException(400, { message: 'shareId required' });
 
 	const share = await db.query.sharedDecks.findFirst({
 		where: eq(sharedDecks.id, shareId),
diff --git a/apps/api/src/modules/storage/routes.ts b/apps/api/src/modules/storage/routes.ts
index b87bd08b1..a3ee7c34e 100644
--- a/apps/api/src/modules/storage/routes.ts
+++ b/apps/api/src/modules/storage/routes.ts
@@ -7,8 +7,9 @@
  */
 
 import { Hono } from 'hono';
+import type { AuthVariables } from '@mana/shared-hono';
 
-const routes = new Hono();
+const routes = new Hono<{ Variables: AuthVariables }>();
 
 // ─── File Upload (server-only: S3) ──────────────────────────
 
@@ -46,9 +47,8 @@ routes.post('/files/upload', async (c) => {
 		}
 
 		// Non-images -> shared-storage as before
-		const { createStorageStorage, generateUserFileKey, getContentType } = await import(
-			'@mana/shared-storage'
-		);
+		const { createStorageStorage, generateUserFileKey, getContentType } =
+			await import('@mana/shared-storage');
 		const storage = createStorageStorage();
 		const key = generateUserFileKey(userId, file.name);
 
@@ -91,10 +91,13 @@ routes.get('/files/:id/download', async (c) => {
 			return c.json({ url });
 		}
 
-		const data = await storage.download(storagePath);
-		return new Response(data.body, {
+		const [buffer, metadata] = await Promise.all([
+			storage.download(storagePath),
+			storage.getMetadata(storagePath).catch(() => null),
+		]);
+		return new Response(new Uint8Array(buffer), {
 			headers: {
-				'Content-Type': data.contentType || 'application/octet-stream',
+				'Content-Type': metadata?.contentType || 'application/octet-stream',
 				'Content-Disposition': `attachment; filename="${storagePath.split('/').pop()}"`,
 			},
 		});
diff --git a/apps/api/src/modules/todo/routes.ts b/apps/api/src/modules/todo/routes.ts
index 32e954959..111045607 100644
--- a/apps/api/src/modules/todo/routes.ts
+++ b/apps/api/src/modules/todo/routes.ts
@@ -18,7 +18,7 @@ import { z } from 'zod';
 import { eq, and, asc, sql } from 'drizzle-orm';
 import { drizzle } from 'drizzle-orm/postgres-js';
 import postgres from 'postgres';
-import { serviceAuthMiddleware } from '@mana/shared-hono';
+import { serviceAuthMiddleware, type AuthVariables } from '@mana/shared-hono';
 import {
 	pgSchema,
 	uuid,
@@ -93,7 +93,7 @@ const db = drizzle(connection, { schema: { tasks, projects, reminders } });
 
 // ─── Routes ────────────────────────────────────────────────
 
-const routes = new Hono();
+const routes = new Hono<{ Variables: AuthVariables }>();
 
 // ─── RRULE Compute ─────────────────────────────────────────
 
diff --git a/apps/api/src/modules/traces/routes.ts b/apps/api/src/modules/traces/routes.ts
index f924f5b6c..6b8c697f8 100644
--- a/apps/api/src/modules/traces/routes.ts
+++ b/apps/api/src/modules/traces/routes.ts
@@ -7,6 +7,7 @@
  */
 
 import { Hono } from 'hono';
+import { logger, type AuthVariables } from '@mana/shared-hono';
 import { eq, and } from 'drizzle-orm';
 import { drizzle } from 'drizzle-orm/postgres-js';
 import postgres from 'postgres';
@@ -120,7 +121,7 @@ const db = drizzle(connection, { schema: { locations, cities, pois, guides, guid
 
 // ─── Routes ─────────────────────────────────────────────────
 
-const routes = new Hono();
+const routes = new Hono<{ Variables: AuthVariables }>();
 
 // ─── Guide Generation (server-only: AI + search) ────────────
 
@@ -152,7 +153,11 @@ routes.post('/guides/generate', async (c) => {
 	// Fire-and-forget async pipeline
 	runGuidePipeline(guide.id, userId, city, params.language || 'de', params.maxPois || 10).catch(
 		(err) => {
-			console.error('Guide generation failed:', err);
+			logger.error('traces.guide_generation_failed', {
+				guideId: guide.id,
+				cityId: city.id,
+				error: err instanceof Error ? err.message : String(err),
+			});
 			db.update(guides)
 				.set({ status: 'error' })
 				.where(eq(guides.id, guide.id))
diff --git a/apps/calendar/CLAUDE.md b/apps/calendar/CLAUDE.md
index 3773b7c16..b397f2861 100644
--- a/apps/calendar/CLAUDE.md
+++ b/apps/calendar/CLAUDE.md
@@ -1,660 +1,18 @@
-# Calendar Project Guide
+# Calendar — consolidated into the unified Mana app
 
-## Übersicht
+This product was migrated into the unified Mana monorepo. The legacy
+per-product `apps/calendar/apps/server/` and `apps/calendar/apps/web/`
+directories have been removed. Active code now lives in:
 
-**Kalender** ist eine vollständige Kalender-Anwendung für persönliches und geteiltes Zeitmanagement. Die App unterstützt mehrere Kalender, wiederkehrende Termine, CalDAV/iCal-Synchronisation und Erinnerungen.
+- **Backend compute routes**: [`apps/api/src/modules/calendar/routes.ts`](../api/src/modules/calendar/routes.ts)
+- **Frontend module** (local-first): [`apps/mana/apps/web/src/lib/modules/calendar/`](../mana/apps/web/src/lib/modules/calendar/)
+- **Web route**: [`apps/mana/apps/web/src/routes/(app)/calendar/`](../mana/apps/web/src/routes/(app)/calendar/)
+- **Landing page** (still standalone): [`apps/calendar/apps/landing/`](apps/landing/)
 
-| App | Port | URL |
-|-----|------|-----|
-| Server | 3014 | http://localhost:3014 |
-| Web App | 5179 | http://localhost:5179 |
-| Landing Page | 4322 | http://localhost:4322 |
-| Mobile | 8081 | Expo Go |
+For monorepo-wide patterns (auth, sync, encryption, services), see the
+[root `CLAUDE.md`](../../CLAUDE.md) and [`apps/mana/CLAUDE.md`](../mana/CLAUDE.md).
 
-## Project Structure
-
-```
-apps/calendar/
-├── apps/
-│   ├── server/       # Hono/Bun compute server (@calendar/server)
-│   │   └── src/
-│   │       ├── main.ts
-│   │       ├── app.module.ts
-│   │       ├── db/           # Drizzle schemas + migrations
-│   │       │   ├── schema/
-│   │       │   │   ├── calendars.schema.ts
-│   │       │   │   ├── events.schema.ts
-│   │       │   │   ├── reminders.schema.ts
-│   │       │   │   ├── calendar-shares.schema.ts
-│   │       │   │   └── external-calendars.schema.ts
-│   │       │   └── db.ts
-│   │       ├── calendar/     # Calendar CRUD
-│   │       ├── event/        # Event CRUD + queries
-│   │       ├── reminder/     # Reminders + notifications
-│   │       ├── sync/         # CalDAV/iCal sync
-│   │       ├── share/        # Calendar sharing
-│   │       └── health/
-│   │
-│   ├── web/          # SvelteKit web application (@calendar/web)
-│   │   └── src/
-│   │       ├── lib/
-│   │       │   ├── api/          # API clients
-│   │       │   │   ├── client.ts
-│   │       │   │   ├── calendars.ts
-│   │       │   │   ├── events.ts
-│   │       │   │   ├── reminders.ts
-│   │       │   │   └── shares.ts
-│   │       │   ├── stores/       # Svelte 5 runes stores
-│   │       │   │   ├── auth.svelte.ts
-│   │       │   │   ├── view.svelte.ts
-│   │       │   │   ├── calendars.svelte.ts
-│   │       │   │   ├── events.svelte.ts
-│   │       │   │   ├── theme.ts
-│   │       │   │   ├── navigation.ts
-│   │       │   │   └── toast.ts
-│   │       │   ├── components/
-│   │       │   │   ├── calendar/
-│   │       │   │   │   ├── CalendarHeader.svelte
-│   │       │   │   │   ├── WeekView.svelte
-│   │       │   │   │   ├── DayView.svelte
-│   │       │   │   │   ├── MonthView.svelte
-│   │       │   │   │   ├── MiniCalendar.svelte
-│   │       │   │   │   └── CalendarSidebar.svelte
-│   │       │   │   └── event/
-│   │       │   │       └── EventForm.svelte
-│   │       │   └── i18n/         # Internationalization (5 Sprachen)
-│   │       └── routes/
-│   │           ├── +layout.svelte
-│   │           ├── +page.svelte          # Hauptkalender (Wochenansicht)
-│   │           ├── agenda/+page.svelte   # Agenda-Ansicht
-│   │           ├── event/
-│   │           │   ├── new/+page.svelte  # Neuer Termin
-│   │           │   └── [id]/+page.svelte # Termin bearbeiten
-│   │           ├── calendars/+page.svelte
-│   │           ├── settings/+page.svelte
-│   │           ├── feedback/+page.svelte
-│   │           └── (auth)/
-│   │               ├── login/+page.svelte
-│   │               ├── register/+page.svelte
-│   │               └── forgot-password/+page.svelte
-│   │
-│   ├── landing/      # Astro marketing landing page (@calendar/landing)
-│   │   └── src/
-│   │       ├── pages/index.astro
-│   │       ├── layouts/Layout.astro
-│   │       └── components/
-│   │           ├── Hero.astro
-│   │           ├── Features.astro
-│   │           ├── CTA.astro
-│   │           └── Footer.astro
-│   │
-│   └── mobile/       # Expo/React Native mobile app (@calendar/mobile) [TODO]
-│
-├── packages/
-│   ├── shared/       # Shared types, utils, constants (@calendar/shared)
-│   │   └── src/
-│   │       ├── types/
-│   │       │   ├── calendar.ts
-│   │       │   ├── event.ts
-│   │       │   ├── reminder.ts
-│   │       │   └── share.ts
-│   │       └── index.ts
-│   └── web-ui/       # Shared Svelte components (@calendar/web-ui) [TODO]
-│
-├── package.json
-└── CLAUDE.md
-```
-
-## Commands
-
-### Root Level (from monorepo root)
-
-```bash
-# Alle Apps starten
-pnpm calendar:dev                 # Run all calendar apps
-
-# Einzelne Apps starten
-pnpm dev:calendar:server          # Start server (port 3014)
-pnpm dev:calendar:web             # Start web app (port 5179)
-pnpm dev:calendar:landing         # Start landing page (port 4322)
-pnpm dev:calendar:mobile          # Start mobile app [TODO]
-pnpm dev:calendar:app             # Start web + server together
-pnpm dev:calendar:local           # Start web + sync (no auth needed)
-
-# Datenbank
-pnpm calendar:db:push             # Push schema to database
-pnpm calendar:db:studio           # Open Drizzle Studio
-pnpm calendar:db:seed             # Seed initial data
-```
-
-### Server (apps/calendar/apps/server)
-
-```bash
-pnpm dev                         # Start with hot reload
-pnpm build                       # Build for production
-pnpm start:prod                  # Start production server
-pnpm db:push                     # Push schema to database
-pnpm db:studio                   # Open Drizzle Studio
-pnpm db:seed                     # Seed initial data
-```
-
-### Web App (apps/calendar/apps/web)
-
-```bash
-pnpm dev                         # Start dev server
-pnpm build                       # Build for production
-pnpm preview                     # Preview production build
-```
-
-### Landing Page (apps/calendar/apps/landing)
-
-```bash
-pnpm dev                         # Start dev server (port 4322)
-pnpm build                       # Build for production
-pnpm preview                     # Preview build
-```
-
-## Technology Stack
-
-| Layer | Technology |
-|-------|------------|
-| **Server** | Hono + Bun, Drizzle ORM, PostgreSQL |
-| **Web** | SvelteKit 2.x, Svelte 5 (runes mode), Tailwind CSS 4 |
-| **Landing** | Astro 5.x, Tailwind CSS |
-| **Mobile** | React Native 0.81 + Expo SDK 54, NativeWind [TODO] |
-| **Auth** | Mana Auth (JWT) |
-| **i18n** | svelte-i18n (DE, EN, FR, ES, IT) |
-| **Dates** | date-fns |
-| **Sync** | ical.js, tsdav (CalDAV) |
-
-## Architecture
-
-### Core Features
-
-1. **Persönliche Kalender** - Erstelle und verwalte mehrere farbcodierte Kalender
-2. **Termine** - Vollständiges CRUD mit Wiederholungsunterstützung (RFC 5545 RRULE)
-3. **Geteilte Kalender** - Teile Kalender mit Lese-/Schreib-/Admin-Berechtigungen
-4. **CalDAV/iCal Sync** - Bi-direktionale Synchronisation mit Google, Apple, etc.
-5. **Erinnerungen** - Push-Benachrichtigungen und E-Mail-Erinnerungen
-
-### Kalender-Ansichten
-
-| Ansicht | Route | Beschreibung |
-|---------|-------|--------------|
-| **Woche** | `/` (default) | 7-Tage-Raster mit Stunden |
-| **Tag** | Click auf Tag | 24-Stunden-Timeline |
-| **Monat** | Header-Switch | Traditionelles Kalenderraster |
-| **Agenda** | `/agenda` | Chronologische Terminliste |
-| **Jahr** | [TODO] | Kompakte 12-Monats-Übersicht |
-
-### Web App Stores (Svelte 5 Runes)
-
-```typescript
-// auth.svelte.ts - Authentifizierung
-authStore.isAuthenticated  // boolean
-authStore.user             // User | null
-authStore.signIn(email, password)
-authStore.signOut()
-authStore.getAccessToken()
-
-// view.svelte.ts - Kalender-Ansicht
-viewStore.currentDate      // Date
-viewStore.viewType         // 'day' | 'week' | 'month' | 'year' | 'agenda'
-viewStore.setDate(date)
-viewStore.setViewType(type)
-viewStore.goToToday()
-viewStore.navigate(direction) // 'prev' | 'next'
-
-// calendars.svelte.ts - Kalender-Verwaltung
-calendarsStore.calendars   // Calendar[]
-calendarsStore.loading     // boolean
-calendarsStore.fetchCalendars()
-calendarsStore.createCalendar(data)
-calendarsStore.updateCalendar(id, data)
-calendarsStore.deleteCalendar(id)
-calendarsStore.getColor(calendarId)
-
-// events.svelte.ts - Termine
-eventsStore.events         // Event[]
-eventsStore.loading        // boolean
-eventsStore.fetchEvents(start, end)
-eventsStore.getEventsForDay(date)
-eventsStore.getEventsForWeek(date)
-eventsStore.createEvent(data)
-eventsStore.updateEvent(id, data)
-eventsStore.deleteEvent(id)
-```
-
-### Server API Endpoints
-
-#### Health
-
-| Endpoint | Method | Description |
-|----------|--------|-------------|
-| `/api/v1/health` | GET | Health check |
-
-#### Calendars
-
-| Endpoint | Method | Description |
-|----------|--------|-------------|
-| `/api/v1/calendars` | GET | List user's calendars |
-| `/api/v1/calendars` | POST | Create calendar |
-| `/api/v1/calendars/:id` | GET | Get calendar details |
-| `/api/v1/calendars/:id` | PUT | Update calendar |
-| `/api/v1/calendars/:id` | DELETE | Delete calendar |
-
-#### Events
-
-| Endpoint | Method | Description |
-|----------|--------|-------------|
-| `/api/v1/events` | GET | Query events (date range) |
-| `/api/v1/events` | POST | Create event |
-| `/api/v1/events/:id` | GET | Get event details |
-| `/api/v1/events/:id` | PUT | Update event |
-| `/api/v1/events/:id` | DELETE | Delete event |
-| `/api/v1/events/calendar/:calendarId` | GET | Get events by calendar |
-
-#### Reminders
-
-| Endpoint | Method | Description |
-|----------|--------|-------------|
-| `/api/v1/events/:eventId/reminders` | GET | List event reminders |
-| `/api/v1/events/:eventId/reminders` | POST | Add reminder |
-| `/api/v1/reminders/:id` | DELETE | Remove reminder |
-
-#### Sharing
-
-| Endpoint | Method | Description |
-|----------|--------|-------------|
-| `/api/v1/calendars/:id/shares` | GET | List calendar shares |
-| `/api/v1/calendars/:id/shares` | POST | Share calendar |
-| `/api/v1/shares/:shareId/accept` | POST | Accept invitation |
-| `/api/v1/shares/:shareId/decline` | POST | Decline invitation |
-
-#### Sync
-
-| Endpoint | Method | Description |
-|----------|--------|-------------|
-| `/api/v1/sync/external` | GET | List external calendars |
-| `/api/v1/sync/external` | POST | Connect external calendar |
-| `/api/v1/sync/external/:id` | DELETE | Disconnect external |
-| `/api/v1/sync/external/:id/sync` | POST | Trigger manual sync |
-| `/api/v1/sync/caldav/discover` | POST | Discover CalDAV calendars |
-| `/api/v1/calendars/:id/export.ics` | GET | Export calendar as iCal |
-
-### Database Schema
-
-#### calendars
-
-| Column | Type | Description |
-|--------|------|-------------|
-| `id` | UUID | Primary key |
-| `user_id` | UUID | Owner |
-| `name` | VARCHAR(255) | Calendar name |
-| `description` | TEXT | Optional description |
-| `color` | VARCHAR(7) | Hex color code (#3B82F6) |
-| `is_default` | BOOLEAN | Default calendar flag |
-| `is_visible` | BOOLEAN | Visibility in UI |
-| `timezone` | VARCHAR(100) | Default timezone |
-| `settings` | JSONB | CalendarSettings object |
-| `created_at` | TIMESTAMP | Creation time |
-| `updated_at` | TIMESTAMP | Last update |
-
-#### events
-
-| Column | Type | Description |
-|--------|------|-------------|
-| `id` | UUID | Primary key |
-| `calendar_id` | UUID | FK to calendars |
-| `user_id` | UUID | Owner |
-| `title` | VARCHAR(500) | Event title |
-| `description` | TEXT | Event description |
-| `location` | VARCHAR(500) | Location |
-| `start_time` | TIMESTAMP | Start datetime |
-| `end_time` | TIMESTAMP | End datetime |
-| `is_all_day` | BOOLEAN | All-day flag |
-| `timezone` | VARCHAR(100) | Event timezone |
-| `recurrence_rule` | VARCHAR(500) | RFC 5545 RRULE |
-| `recurrence_end_date` | TIMESTAMP | End of recurrence |
-| `recurrence_exceptions` | JSONB | Exception dates |
-| `parent_event_id` | UUID | Parent for instances |
-| `color` | VARCHAR(7) | Override color |
-| `status` | VARCHAR(20) | confirmed/tentative/cancelled |
-| `external_id` | VARCHAR(255) | External calendar ID |
-| `metadata` | JSONB | Attendees, URL, etc. |
-| `created_at` | TIMESTAMP | Creation time |
-| `updated_at` | TIMESTAMP | Last update |
-
-#### calendar_shares
-
-| Column | Type | Description |
-|--------|------|-------------|
-| `id` | UUID | Primary key |
-| `calendar_id` | UUID | FK to calendars |
-| `shared_with_user_id` | UUID | Target user (optional) |
-| `shared_with_email` | VARCHAR(255) | Email for invite |
-| `permission` | VARCHAR(20) | read/write/admin |
-| `share_token` | VARCHAR(64) | For link sharing |
-| `share_url` | VARCHAR(500) | Public share URL |
-| `status` | VARCHAR(20) | pending/accepted/declined |
-| `invited_by` | UUID | Inviter user ID |
-| `accepted_at` | TIMESTAMP | Accept timestamp |
-| `expires_at` | TIMESTAMP | Expiration date |
-| `created_at` | TIMESTAMP | Creation time |
-| `updated_at` | TIMESTAMP | Last update |
-
-#### reminders
-
-| Column | Type | Description |
-|--------|------|-------------|
-| `id` | UUID | Primary key |
-| `event_id` | UUID | FK to events |
-| `user_id` | UUID | Owner |
-| `minutes_before` | INTEGER | Reminder offset |
-| `reminder_time` | TIMESTAMP | Calculated time |
-| `notify_push` | BOOLEAN | Push notification |
-| `notify_email` | BOOLEAN | Email notification |
-| `status` | VARCHAR(20) | pending/sent/failed |
-| `sent_at` | TIMESTAMP | Send timestamp |
-| `event_instance_date` | TIMESTAMP | For recurring events |
-| `created_at` | TIMESTAMP | Creation time |
-
-#### external_calendars
-
-| Column | Type | Description |
-|--------|------|-------------|
-| `id` | UUID | Primary key |
-| `user_id` | UUID | Owner |
-| `name` | VARCHAR(255) | Display name |
-| `provider` | VARCHAR(50) | google/apple/caldav/ical_url |
-| `calendar_url` | TEXT | CalDAV or iCal URL |
-| `username` | VARCHAR(255) | CalDAV username |
-| `encrypted_password` | TEXT | Encrypted password |
-| `access_token` | TEXT | OAuth token |
-| `refresh_token` | TEXT | OAuth refresh token |
-| `token_expires_at` | TIMESTAMP | Token expiration |
-| `sync_enabled` | BOOLEAN | Sync toggle |
-| `sync_direction` | VARCHAR(20) | both/import/export |
-| `sync_interval` | INTEGER | Minutes between syncs |
-| `last_sync_at` | TIMESTAMP | Last sync time |
-| `last_sync_error` | TEXT | Error message |
-| `color` | VARCHAR(7) | Display color |
-| `is_visible` | BOOLEAN | Visibility in UI |
-| `provider_data` | JSONB | Provider-specific data |
-| `created_at` | TIMESTAMP | Creation time |
-| `updated_at` | TIMESTAMP | Last update |
-
-### Recurrence (RFC 5545 RRULE)
-
-Beispiele für wiederkehrende Termine:
-
-```
-FREQ=DAILY                           # Täglich
-FREQ=WEEKLY;BYDAY=MO,WE,FR           # Mo, Mi, Fr
-FREQ=WEEKLY;INTERVAL=2;BYDAY=TU      # Jeden 2. Dienstag
-FREQ=MONTHLY;BYMONTHDAY=15           # Am 15. jeden Monats
-FREQ=MONTHLY;BYDAY=2MO               # Am 2. Montag jeden Monats
-FREQ=YEARLY;BYMONTH=12;BYMONTHDAY=25 # Jährlich am 25.12.
-FREQ=DAILY;COUNT=10                  # Täglich, 10 mal
-FREQ=WEEKLY;UNTIL=20241231T235959Z   # Wöchentlich bis Ende 2024
-```
-
-## Environment Variables
-
-### Server (.env)
-
-```env
-NODE_ENV=development
-PORT=3014
-DATABASE_URL=postgresql://mana:devpassword@localhost:5432/calendar
-MANA_AUTH_URL=http://localhost:3001
-CORS_ORIGINS=http://localhost:5173,http://localhost:5179,http://localhost:8081
-
-# Notifications (optional)
-EXPO_ACCESS_TOKEN=your-expo-access-token
-RESEND_API_KEY=your-resend-api-key
-EMAIL_FROM=calendar@mana.how
-```
-
-### Web (.env)
-
-```env
-PUBLIC_BACKEND_URL=http://localhost:3014
-PUBLIC_MANA_AUTH_URL=http://localhost:3001
-```
-
-### Mobile (.env)
-
-```env
-EXPO_PUBLIC_BACKEND_URL=http://localhost:3014
-EXPO_PUBLIC_MANA_AUTH_URL=http://localhost:3001
-```
-
-## Shared Packages
-
-### @calendar/shared
-
-**Types:**
-- `Calendar` - Kalender-Entity
-- `CalendarSettings` - Kalender-Einstellungen (JSONB)
-- `CalendarViewType` - 'day' | 'week' | 'month' | 'year' | 'agenda'
-- `Event` - Termin-Entity
-- `EventStatus` - 'confirmed' | 'tentative' | 'cancelled'
-- `Reminder` - Erinnerung-Entity
-- `ReminderStatus` - 'pending' | 'sent' | 'failed'
-- `CalendarShare` - Freigabe-Entity
-- `SharePermission` - 'read' | 'write' | 'admin'
-- `ExternalCalendar` - Externe Kalender-Entity
-
-**Constants:**
-- `DEFAULT_CALENDAR_COLORS` - 8 vordefinierte Farben
-- `DEFAULT_TIMEZONES` - Häufige Zeitzonen
-
-## Code Style Guidelines
-
-- **TypeScript**: Strict typing mit Interfaces
-- **Web**: Svelte 5 runes mode (`$state`, `$derived`, `$effect`)
-- **Styling**: Tailwind CSS mit CSS-Variablen
-- **Formatting**: Prettier mit Projekt-Config
-- **i18n**: Alle UI-Texte in Locale-Dateien
-
-### Svelte 5 Runes Beispiel
-
-```svelte
-<script lang="ts">
-  import { viewStore } from '$lib/stores/view.svelte';
-
-  // Reaktiver State
-  let loading = $state(false);
-
-  // Abgeleiteter Wert
-  let formattedDate = $derived(
-    format(viewStore.currentDate, 'MMMM yyyy', { locale: de })
-  );
-
-  // Side Effect
-  $effect(() => {
-    console.log('Date changed:', viewStore.currentDate);
-  });
-</script>
-```
-
-## Quick Add Syntax
-
-Natural language event creation via `event-parser.ts`:
-
-```
-"Meeting morgen 14 Uhr 1h @Arbeit #wichtig"
-```
-
-Recognized patterns:
-- **Date**: heute, morgen, nächsten Montag, 15.12.
-- **Time**: um 14 Uhr, 14:00
-- **Time Range**: 14-16 Uhr, 10:00-11:30
-- **Duration**: 30min, 2h, 1.5 Stunden, 2h30m
-- **All-Day**: ganztägig, ganzer Tag
-- **Calendar**: @Kalender (first @ref matches calendar)
-- **Attendees**: @Name (subsequent @refs become attendees)
-- **Tags**: #tag1 #tag2
-- **Location**: in Berlin, im Büro, bei Dr. Müller
-- **Recurrence**: jeden Tag, wöchentlich, monatlich
-
-### Multi-Event Input
-
-Split multiple events with keywords (`danach`, `dann`, `und dann`, `anschließend`) or semicolons:
-
-```
-"Meeting 14 Uhr 1h danach Review 30min"
-→ Event 1: Meeting (14:00-15:00)
-→ Event 2: Review (15:00-15:30, auto-offset)
-
-"Standup 9 Uhr 30min @Arbeit; Sprint Planning 1h; Code Review 30min"
-→ 3 events chained: 9:00-9:30, 9:30-10:30, 10:30-11:00
-```
-
-Context inheritance: subsequent events inherit date, time, and calendar from the first event. If the first event has a duration, the next event starts where it ends.
-
-### Smart Duration (Auto-Estimation)
-
-Duration is **automatically applied** to new events when no explicit duration is typed. Uses `estimateEventDuration()` from `event-estimator.ts` with weighted similarity (calendar, title overlap, tags). Falls back to `defaultEventDuration` from settings. Controllable via Settings > Termin-Einstellungen:
-
-- **Smarte Dauer** toggle (`smartDurationEnabled`, default: on)
-- **Standard-Dauer** fallback (`defaultEventDuration`, default: 60min)
-
-Priority: explicit duration in text > history estimate > default fallback > 1h (if disabled). Runs fully offline against IndexedDB.
-
-### Conflict Detection
-
-`detectConflicts()` in `event-estimator.ts` checks for overlapping events. Ignores all-day events, supports exclude-by-ID for edit mode. Returns list of conflicting events with title and time.
-
-## Quick Start
-
-### 1. Datenbank erstellen
-
-```bash
-# PostgreSQL Container muss laufen
-docker compose -f docker-compose.dev.yml up -d postgres
-
-# Datenbank erstellen
-PGPASSWORD=devpassword psql -h localhost -U mana -d postgres -c "CREATE DATABASE calendar;"
-
-# Schema pushen
-pnpm calendar:db:push
-```
-
-### 2. Apps starten
-
-```bash
-# Server + Web zusammen
-pnpm dev:calendar:app
-
-# Oder einzeln:
-pnpm dev:calendar:server   # Terminal 1
-pnpm dev:calendar:web      # Terminal 2
-pnpm dev:calendar:landing  # Terminal 3 (optional)
-```
-
-### 3. URLs öffnen
-
-- Web App: http://localhost:5179
-- Landing: http://localhost:4322
-- API Health: http://localhost:3014/api/v1/health
-
-## Testing API (mit curl)
-
-```bash
-# Health Check
-curl http://localhost:3014/api/v1/health
-
-# Login (get token)
-TOKEN=$(curl -s -X POST http://localhost:3001/api/v1/auth/login \
-  -H "Content-Type: application/json" \
-  -d '{"email": "test@example.com", "password": "password"}' | jq -r '.accessToken')
-
-# Kalender abrufen
-curl http://localhost:3014/api/v1/calendars \
-  -H "Authorization: Bearer $TOKEN"
-
-# Neuen Kalender erstellen
-curl -X POST http://localhost:3014/api/v1/calendars \
-  -H "Authorization: Bearer $TOKEN" \
-  -H "Content-Type: application/json" \
-  -d '{"name": "Arbeit", "color": "#3B82F6"}'
-
-# Termine abrufen (Datumsbereich)
-curl "http://localhost:3014/api/v1/events?start=2024-12-01&end=2024-12-31" \
-  -H "Authorization: Bearer $TOKEN"
-
-# Neuen Termin erstellen
-curl -X POST http://localhost:3014/api/v1/events \
-  -H "Authorization: Bearer $TOKEN" \
-  -H "Content-Type: application/json" \
-  -d '{
-    "calendarId": "calendar-uuid",
-    "title": "Meeting",
-    "startTime": "2024-12-15T10:00:00Z",
-    "endTime": "2024-12-15T11:00:00Z"
-  }'
-```
-
-## Production Readiness
-
-**Status: Production-Ready (2026-03-24)**
-
-### Checklist
-
-| Category | Status | Details |
-|----------|--------|---------|
-| **Error Handling** | ✅ | Global `+error.svelte` with i18n (5 languages), error tracking via GlitchTip |
-| **Offline Support** | ✅ | Offline page with shared `OfflinePage` component |
-| **PWA** | ✅ | Service worker, manifest, icons, apple-touch-icon, shortcuts |
-| **Security Headers** | ✅ | CSP, X-Frame-Options, HSTS via `setSecurityHeaders()` |
-| **Loading States** | ✅ | Skeleton loaders: CalendarView, EventDetail, Agenda, AppLoading |
-| **i18n** | ✅ | 5 languages (DE/EN/FR/ES/IT), all pages including settings fully localized |
-| **Meta/SEO** | ✅ | OG tags, meta description in root layout |
-| **Accessibility** | ✅ | Focus trapping in all modals, ARIA roles, keyboard navigation |
-| **Rate Limiting** | ✅ | ThrottlerGuard global (100 req/min) |
-| **API Validation** | ✅ | DTOs with class-validator, whitelist + forbidNonWhitelisted |
-| **Auth** | ✅ | JWT via mana-auth, guards on all controllers |
-| **Toast System** | ✅ | All toast messages localized via svelte-i18n |
-| **Docker** | ✅ | Multi-stage build, health checks, entrypoint script |
-| **Tests** | ✅ | 13 unit tests, 7 E2E test suites (Playwright) |
-| **Error Tracking** | ✅ | GlitchTip integration (client + server) |
-| **Metrics** | ✅ | Prometheus via MetricsModule |
-| **Context Menu** | ✅ | Shared ContextMenu on WeekView + AgendaView events |
-
-### E2E Test Suites
-
-```bash
-pnpm --filter @calendar/web test:e2e
-```
-
-| Suite | Coverage |
-|-------|----------|
-| `auth.spec.ts` | Login, redirect, invalid credentials |
-| `calendar-views.spec.ts` | Week/month/agenda views, navigation |
-| `events.spec.ts` | Event CRUD |
-| `calendars.spec.ts` | Calendar management |
-| `settings.spec.ts` | Settings page |
-| `week-view-interactions.spec.ts` | Drag-to-create, time indicator |
-| `error-page.spec.ts` | 404 error page |
-
-## Roadmap / TODO
-
-- [ ] Mobile App (Expo)
-- [ ] Year View
-- [ ] CalDAV Sync Implementation
-- [ ] Push Notifications
-- [ ] E-Mail Reminders
-- [ ] Event Attendees
-- [ ] Calendar Import/Export
-- [ ] Dark/Light Theme in Landing
-
-## Important Notes
-
-1. **Authentication**: Nutzt Mana Auth (JWT im Authorization Header)
-2. **Database**: PostgreSQL mit Drizzle ORM (Port 5432)
-3. **Port**: Server läuft auf Port 3014
-4. **Recurrence**: Verwendet RFC 5545 RRULE Format
-5. **i18n**: 5 Sprachen unterstützt (DE, EN, FR, ES, IT)
-6. **Theme**: Ocean-Theme (Blautöne) als Standard
+The previous 660-line "Calendar Project Guide" that described a per-product
+Hono backend with its own Drizzle schemas, RRULE service, CalDAV sync,
+etc. has been deleted — it had been inaccurate since the consolidation
+of early 2026. Pre-consolidation reference is in git history.
diff --git a/apps/chat/CLAUDE.md b/apps/chat/CLAUDE.md
index 04bc87a02..6dd4e7325 100644
--- a/apps/chat/CLAUDE.md
+++ b/apps/chat/CLAUDE.md
@@ -1,195 +1,19 @@
-# Chat Project Guide
+# Chat — consolidated into the unified Mana app
 
-## Project Structure
+This product was migrated into the unified Mana monorepo. The legacy
+per-product `apps/chat/apps/server/` and `apps/chat/apps/web/` directories
+have been removed. Active code now lives in:
 
-```
-apps/chat/
-├── apps/
-│   ├── server/       # Hono/Bun compute server (@chat/server)
-│   ├── landing/      # Astro marketing landing page (@chat/landing)
-│   ├── web/          # SvelteKit web application (@chat/web)
-│   └── mobile/       # Expo/React Native mobile app (@chat/mobile)
-├── packages/
-│   └── chat-types/   # Shared TypeScript types (@chat/types)
-└── package.json
-```
+- **Backend compute routes**: [`apps/api/src/modules/chat/routes.ts`](../api/src/modules/chat/routes.ts)
+- **Frontend module** (local-first): [`apps/mana/apps/web/src/lib/modules/chat/`](../mana/apps/web/src/lib/modules/chat/)
+- **Web route**: [`apps/mana/apps/web/src/routes/(app)/chat/`](../mana/apps/web/src/routes/(app)/chat/)
+- **Landing page** (still standalone): [`apps/chat/apps/landing/`](apps/landing/)
+- **Mobile app**: [`apps/chat/apps/mobile/`](apps/mobile/)
 
-## Commands
+For monorepo-wide patterns (auth, sync, encryption, services), see the
+[root `CLAUDE.md`](../../CLAUDE.md) and [`apps/mana/CLAUDE.md`](../mana/CLAUDE.md).
 
-### Root Level
-
-```bash
-pnpm chat:dev                    # Run all chat apps
-pnpm dev:chat:mobile             # Start mobile app
-pnpm dev:chat:web                # Start web app
-pnpm dev:chat:landing            # Start landing page
-pnpm dev:chat:server             # Start server
-pnpm dev:chat:local              # Start web + sync (no auth needed)
-pnpm dev:chat:full               # Start server + web + auth together
-```
-
-### Mobile App (chat/apps/mobile)
-
-```bash
-pnpm dev                         # Start Expo dev server
-pnpm ios                         # Run on iOS simulator
-pnpm android                     # Run on Android emulator
-pnpm build:dev                   # Build development version
-pnpm build:preview               # Build preview version
-pnpm build:prod                  # Build production version
-```
-
-### Server (apps/chat/apps/server)
-
-```bash
-pnpm start:dev                   # Start with hot reload
-pnpm build                       # Build for production
-pnpm start:prod                  # Start production server
-pnpm db:push                     # Push schema to database
-pnpm db:seed                     # Seed AI models
-pnpm db:studio                   # Open Drizzle Studio
-```
-
-### Web App (chat/apps/web)
-
-```bash
-pnpm dev                         # Start dev server
-pnpm build                       # Build for production
-pnpm preview                     # Preview production build
-```
-
-### Landing Page (chat/apps/landing)
-
-```bash
-pnpm dev                         # Start dev server
-pnpm build                       # Build for production
-pnpm preview                     # Preview production build
-```
-
-## Technology Stack
-
-- **Mobile**: React Native 0.76.7 + Expo SDK 52, NativeWind, Expo Router
-- **Web**: SvelteKit 2.x, Svelte 5, Tailwind CSS 4
-- **Landing**: Astro 5.16, Tailwind CSS
-- **Server**: Hono + Bun, OpenRouter AI + mana-llm (local), Drizzle ORM, PostgreSQL
-- **Auth**: Mana Auth (JWT)
-- **Types**: TypeScript 5.x
-
-## Architecture
-
-### Server API Endpoints
-
-| Endpoint                          | Method | Description                 |
-| --------------------------------- | ------ | --------------------------- |
-| `/api/v1/health`                  | GET    | Health check                |
-| `/api/v1/chat/models`             | GET    | List available AI models    |
-| `/api/v1/chat/completions`        | POST   | Create chat completion      |
-| `/api/v1/conversations`           | GET    | List user conversations     |
-| `/api/v1/conversations/:id`       | GET    | Get conversation details    |
-| `/api/v1/conversations/:id/messages` | GET | Get conversation messages   |
-| `/api/v1/conversations`           | POST   | Create new conversation     |
-| `/api/v1/conversations/:id/messages` | POST | Add message to conversation |
-
-### Environment Variables
-
-#### Server (.env)
-
-```env
-# Cloud AI models via OpenRouter (optional if using only local models)
-OPENROUTER_API_KEY=sk-or-v1-xxx    # Get at https://openrouter.ai/keys
-
-# Local AI via mana-llm service
-MANA_LLM_URL=http://localhost:3025 # mana-llm service URL
-LLM_TIMEOUT=120000                 # Timeout in ms (default: 120s)
-
-# Database (uses shared Docker PostgreSQL)
-DATABASE_URL=postgresql://mana:devpassword@localhost:5432/chat
-
-# Auth
-MANA_AUTH_URL=http://localhost:3001
-
-# Server
-PORT=3002
-```
-
-#### Mobile (.env)
-
-```env
-EXPO_PUBLIC_MANA_AUTH_URL=http://localhost:3001
-EXPO_PUBLIC_BACKEND_URL=http://localhost:3002
-```
-
-#### Web (.env)
-
-```env
-PUBLIC_MANA_AUTH_URL=http://localhost:3001
-PUBLIC_BACKEND_URL=http://localhost:3002
-```
-
-## Code Style Guidelines
-
-- **TypeScript**: Strict typing with interfaces
-- **Mobile**: Functional components with hooks
-- **Web**: Svelte 5 runes mode
-- **Styling**: Tailwind CSS everywhere
-- **Formatting**: 100 char line limit, 2 space tabs, single quotes
-
-## AI Models Available
-
-### Local Models (Ollama - Free, runs on Mac Mini)
-
-| Model ID | Name | Best For |
-| -------- | ---- | -------- |
-| ...440101 | Gemma 3 4B (Lokal) | Everyday tasks (default) |
-| ...440102 | Qwen2.5 Coder 7B (Lokal) | Code generation (92.7% HumanEval) |
-| ...440103 | LLaVA 7B Vision (Lokal) | Image/screenshot analysis |
-| ...440104 | Qwen3 VL 4B (Lokal) | Fast image analysis |
-| ...440105 | DeepSeek OCR (Lokal) | Text recognition in images |
-| ...440106 | Phi 3.5 (Lokal) | Compact, efficient |
-| ...440107 | Ministral 3B (Lokal) | Very fast, simple tasks |
-
-### Cloud Models (OpenRouter - Paid)
-
-| Model ID | Name | Price | Best For |
-| -------- | ---- | ----- | -------- |
-| ...440201 | Llama 3.1 8B | $0.05/M | Fast cloud alternative |
-| ...440202 | Llama 3.1 70B | $0.35/M | Complex reasoning |
-| ...440203 | DeepSeek V3 | $0.14/M | Reasoning at low cost |
-| ...440204 | Mistral Small | $0.10/M | General tasks |
-| ...440205 | Claude 3.5 Sonnet | $3/M | Best quality |
-| ...440206 | GPT-4o Mini | $0.15/M | Balanced performance |
-
-### Adding New Local Models
-
-```bash
-# Add new models to existing database
-pnpm --filter @chat/server db:add-local-models
-```
-
-## Quick Start
-
-1. **Get OpenRouter API key** at https://openrouter.ai/keys
-2. **Create `.env`** in `apps/chat/apps/server/`:
-   ```env
-   OPENROUTER_API_KEY=sk-or-v1-xxx
-   DATABASE_URL=postgresql://mana:devpassword@localhost:5432/chat
-   MANA_AUTH_URL=http://localhost:3001
-   PORT=3002
-   ```
-3. **Start services**:
-   ```bash
-   pnpm docker:up              # Start PostgreSQL
-   pnpm dev:chat:full          # Start auth + backend + web
-   ```
-4. **Seed database** (first time only):
-   ```bash
-   pnpm --filter @chat/server db:push
-   pnpm --filter @chat/server db:seed
-   ```
-
-## Important Notes
-
-1. **Security**: API keys are stored in the server only - never in client apps
-2. **Authentication**: Uses Mana Auth (JWT tokens)
-3. **Database**: PostgreSQL with Drizzle ORM (uses shared Docker container)
-4. **Deployment**: Server runs on port 3002
+The previous standalone "Chat Project Guide" describing a per-product
+backend was deleted in the audit cleanup of 2026-04-09 — it had been
+inaccurate since the consolidation. Pre-consolidation reference is in
+git history.
diff --git a/apps/contacts/CLAUDE.md b/apps/contacts/CLAUDE.md
index 2409c266e..69396e0c0 100644
--- a/apps/contacts/CLAUDE.md
+++ b/apps/contacts/CLAUDE.md
@@ -1,260 +1,17 @@
-# Contacts Project Guide
+# Contacts — consolidated into the unified Mana app
 
-## Project Structure
+This product was migrated into the unified Mana monorepo. The legacy
+per-product `apps/contacts/apps/server/` and `apps/contacts/apps/web/`
+directories have been removed. Active code now lives in:
 
-```
-apps/contacts/
-├── apps/
-│   ├── server/       # Hono/Bun compute server (@contacts/server) - Port 3015
-│   ├── landing/      # Astro marketing landing page (@contacts/landing)
-│   ├── web/          # SvelteKit web application (@contacts/web) - Port 5184
-│   └── mobile/       # Expo/React Native mobile app (@contacts/mobile)
-├── packages/
-│   └── shared/       # Shared types, utils, configs (@contacts/shared)
-└── package.json
-```
+- **Backend compute routes**: [`apps/api/src/modules/contacts/routes.ts`](../api/src/modules/contacts/routes.ts)
+- **Frontend module** (local-first): [`apps/mana/apps/web/src/lib/modules/contacts/`](../mana/apps/web/src/lib/modules/contacts/)
+- **Web route**: [`apps/mana/apps/web/src/routes/(app)/contacts/`](../mana/apps/web/src/routes/(app)/contacts/)
+- **Landing page** (still standalone): [`apps/contacts/apps/landing/`](apps/landing/)
 
-## Commands
+For monorepo-wide patterns (auth, sync, encryption, services), see the
+[root `CLAUDE.md`](../../CLAUDE.md) and [`apps/mana/CLAUDE.md`](../mana/CLAUDE.md).
 
-### Root Level (from monorepo root)
-
-```bash
-pnpm contacts:dev                   # Run all contacts apps
-pnpm dev:contacts:mobile            # Start mobile app
-pnpm dev:contacts:web               # Start web app
-pnpm dev:contacts:landing           # Start landing page
-pnpm dev:contacts:server            # Start server
-pnpm dev:contacts:app               # Start web + server together
-pnpm dev:contacts:local             # Start web + sync (no auth needed)
-```
-
-### Mobile App (apps/contacts/apps/mobile)
-
-```bash
-pnpm dev                         # Start Expo dev server
-pnpm ios                         # Run on iOS simulator
-pnpm android                     # Run on Android emulator
-```
-
-### Backend (apps/contacts/apps/backend)
-
-```bash
-pnpm dev                         # Start with hot reload
-pnpm build                       # Build for production
-pnpm start:prod                  # Start production server
-pnpm db:push                     # Push schema to database
-pnpm db:studio                   # Open Drizzle Studio
-```
-
-### Web App (apps/contacts/apps/web)
-
-```bash
-pnpm dev                         # Start dev server
-pnpm build                       # Build for production
-pnpm preview                     # Preview production build
-```
-
-### Landing Page (apps/contacts/apps/landing)
-
-```bash
-pnpm dev                         # Start dev server
-pnpm build                       # Build for production
-```
-
-## Technology Stack
-
-- **Mobile**: React Native 0.81 + Expo SDK 54, NativeWind, Expo Router, Zustand
-- **Web**: SvelteKit 2.x, Svelte 5 (runes mode), Tailwind CSS
-- **Landing**: Astro 5.x, Tailwind CSS
-- **Backend**: NestJS 10, Drizzle ORM, PostgreSQL
-- **Types**: TypeScript 5.x
-
-## Architecture
-
-### Backend API Endpoints
-
-| Endpoint                              | Method | Description                |
-| ------------------------------------- | ------ | -------------------------- |
-| `/api/v1/health`                      | GET    | Health check               |
-| `/api/v1/contacts`                    | GET    | Get user's contacts        |
-| `/api/v1/contacts`                    | POST   | Create new contact         |
-| `/api/v1/contacts/:id`                | GET    | Get contact details        |
-| `/api/v1/contacts/:id`                | PATCH  | Update contact             |
-| `/api/v1/contacts/:id`                | DELETE | Delete contact             |
-| `/api/v1/contacts/:id/favorite`       | POST   | Toggle favorite            |
-| `/api/v1/contacts/:id/archive`        | POST   | Toggle archive             |
-| `/api/v1/contacts/:id/photo`          | POST   | Upload contact photo       |
-| `/api/v1/tags`                        | GET    | Get user's tags            |
-| `/api/v1/tags`                        | POST   | Create new tag             |
-| `/api/v1/tags/:id`                    | DELETE | Delete tag                 |
-| `/api/v1/contacts/:id/notes`          | GET    | Get contact notes          |
-| `/api/v1/contacts/:id/notes`          | POST   | Add note to contact        |
-| `/api/v1/notes/:id`                   | PATCH  | Update note                |
-| `/api/v1/notes/:id`                   | DELETE | Delete note                |
-| `/api/v1/contacts/:id/activities`     | GET    | Get contact activities     |
-| `/api/v1/contacts/:id/activities`     | POST   | Log activity               |
-| `/api/v1/import/preview`              | POST   | Preview file import (vCard/CSV) |
-| `/api/v1/import/execute`              | POST   | Execute contact import     |
-| `/api/v1/import/template/csv`         | GET    | Download CSV template      |
-| `/api/v1/google/auth-url`             | GET    | Get Google OAuth URL       |
-| `/api/v1/google/callback`             | POST   | Exchange OAuth code        |
-| `/api/v1/google/status`               | GET    | Get Google connection status |
-| `/api/v1/google/disconnect`           | DELETE | Disconnect Google account  |
-| `/api/v1/google/contacts`             | GET    | Fetch Google contacts      |
-| `/api/v1/google/import`               | POST   | Import from Google         |
-| `/api/v1/export`                      | GET    | Quick export all contacts  |
-| `/api/v1/export`                      | POST   | Export with options        |
-| `/api/v1/organizations/:orgId/contacts` | GET  | Get organization contacts  |
-| `/api/v1/teams/:teamId/contacts`      | GET    | Get team contacts          |
-| `/api/v1/contacts/:id/share`          | POST   | Share contact              |
-
-### Database Schema
-
-**contacts** - Contact information
-
-- `id` (UUID) - Primary key
-- `user_id` (VARCHAR) - User reference
-- `first_name`, `last_name`, `display_name`, `nickname` (VARCHAR)
-- `email`, `phone`, `mobile` (VARCHAR)
-- `street`, `city`, `postal_code`, `country` (VARCHAR)
-- `company`, `job_title`, `department` (VARCHAR)
-- `website`, `birthday`, `notes`, `photo_url` (VARCHAR/TEXT/DATE)
-- `is_favorite`, `is_archived` (BOOLEAN)
-- `organization_id`, `team_id` (UUID) - Mana integration
-- `visibility` (VARCHAR) - private/team/organization/public
-- `shared_with` (JSONB) - Array of user IDs
-- `created_at`, `updated_at` (TIMESTAMP)
-
-**contact_tags** - Tags for contacts
-
-- `id` (UUID) - Primary key
-- `user_id` (VARCHAR) - User reference
-- `name` (VARCHAR) - Tag name
-- `color` (VARCHAR) - Tag color
-
-**contact_to_tags** - Many-to-many relation
-
-- `contact_id` (UUID) - Contact reference
-- `tag_id` (UUID) - Tag reference
-
-**contact_notes** - Notes for contacts
-
-- `id` (UUID) - Primary key
-- `contact_id` (UUID) - Contact reference
-- `user_id` (VARCHAR) - User reference
-- `content` (TEXT) - Note content
-- `is_pinned` (BOOLEAN)
-- `created_at`, `updated_at` (TIMESTAMP)
-
-**contact_activities** - Activity log
-
-- `id` (UUID) - Primary key
-- `contact_id` (UUID) - Contact reference
-- `user_id` (VARCHAR) - User reference
-- `activity_type` (VARCHAR) - created/updated/called/emailed/met/note_added
-- `description` (TEXT)
-- `metadata` (JSONB)
-- `created_at` (TIMESTAMP)
-
-**connected_accounts** - OAuth provider connections (Google, etc.)
-
-- `id` (UUID) - Primary key
-- `user_id` (VARCHAR) - User reference
-- `provider` (VARCHAR) - Provider name (e.g., 'google')
-- `provider_account_id` (VARCHAR) - Provider's user ID
-- `provider_email` (VARCHAR) - Provider account email
-- `access_token` (TEXT) - OAuth access token (encrypted)
-- `refresh_token` (TEXT) - OAuth refresh token (encrypted)
-- `token_expires_at` (TIMESTAMP) - Token expiration time
-- `scope` (TEXT) - Granted OAuth scopes
-- `provider_data` (JSONB) - Additional provider-specific data
-- `created_at`, `updated_at` (TIMESTAMP)
-
-### Environment Variables
-
-#### Backend (.env)
-
-```
-NODE_ENV=development
-PORT=3015
-DATABASE_URL=postgresql://mana:devpassword@localhost:5432/contacts
-MANA_AUTH_URL=http://localhost:3001
-CORS_ORIGINS=http://localhost:5173,http://localhost:5184,http://localhost:8081
-S3_ENDPOINT=http://localhost:9000
-S3_REGION=us-east-1
-S3_ACCESS_KEY=minioadmin
-S3_SECRET_KEY=minioadmin
-S3_BUCKET=contacts-photos
-
-# Google OAuth (for contacts import)
-# Get credentials from https://console.cloud.google.com/apis/credentials
-GOOGLE_CLIENT_ID=your-client-id.apps.googleusercontent.com
-GOOGLE_CLIENT_SECRET=your-client-secret
-GOOGLE_REDIRECT_URI=http://localhost:5184/data?tab=import&source=google
-```
-
-#### Mobile (.env)
-
-```
-EXPO_PUBLIC_BACKEND_URL=http://localhost:3015
-EXPO_PUBLIC_MANA_AUTH_URL=http://localhost:3001
-```
-
-#### Web (.env)
-
-```
-PUBLIC_BACKEND_URL=http://localhost:3015
-PUBLIC_MANA_AUTH_URL=http://localhost:3001
-```
-
-## Shared Packages
-
-### @contacts/shared
-
-- Types: `Contact`, `ContactGroup`, `ContactTag`, `ContactNote`, `ContactActivity`
-- Utils: Search, filter, import/export functions
-- Configs: App configuration
-
-## Quick Input Syntax
-
-The NewContactModal includes a NL quick-input bar that parses contact info and pre-fills form fields:
-
-```
-"Max Mustermann @ACME Corp max@example.com +49 170 1234567 #kunde"
-→ firstName: Max, lastName: Mustermann, company: ACME Corp,
-  email: max@example.com, phone: +49 170..., tags: [kunde]
-```
-
-Recognized patterns:
-- **Name**: First and last name (remaining text after extraction)
-- **Company**: `@CompanyName` or `bei CompanyName` or `von CompanyName`
-- **Email**: Standard email format
-- **Phone**: International (+49...), German (0123...), or 6+ digit numbers
-- **Tags**: `#tag1 #tag2`
-
-Type the full text and press **Enter** to apply. Fields are pre-filled and can be edited before saving.
-
-### Live Duplicate Detection
-
-While typing in the name or email fields, the system checks for duplicates against IndexedDB in real-time:
-- **Email**: Exact match (case-insensitive)
-- **Name**: Fuzzy match (Levenshtein distance, tolerates typos)
-- Shows warning with matched contact name, company, and match type
-
-Implementation: `duplicate-detector.ts` — runs fully offline, no server calls.
-
-## Code Style Guidelines
-
-- **TypeScript**: Strict typing with interfaces
-- **Mobile**: Functional components with hooks, Zustand for state
-- **Web**: Svelte 5 runes mode (`$state`, `$derived`, `$effect`)
-- **Styling**: Tailwind CSS / NativeWind
-- **Formatting**: Prettier with project config
-
-## Important Notes
-
-1. **Authentication**: Uses Mana Auth (JWT in Authorization header)
-2. **Database**: PostgreSQL with Drizzle ORM
-3. **Port**: Backend runs on port 3015, Web on port 5184 by default
-4. **Storage**: Uses MinIO/S3 for contact photos via @mana/shared-storage
-5. **Mana Integration**: Contacts can be linked to Organizations and Teams
+The previous standalone "Contacts Project Guide" was deleted in the
+audit cleanup of 2026-04-09 — it had been inaccurate since the
+consolidation. Pre-consolidation reference is in git history.
diff --git a/apps/context/CLAUDE.md b/apps/context/CLAUDE.md
index 8335a1269..e81cbb1e6 100644
--- a/apps/context/CLAUDE.md
+++ b/apps/context/CLAUDE.md
@@ -1,210 +1,24 @@
-# Context App
+# Context — consolidated into the unified Mana app
 
-AI-powered document management and context system for knowledge organization.
+This product was migrated into the unified Mana monorepo. The legacy
+per-product `apps/context/apps/backend/` (NestJS) and
+`apps/context/apps/web/` directories have been removed. Active code now
+lives in:
 
-| App | Port | URL |
-|-----|------|-----|
-| Backend | 3020 | http://localhost:3020 |
-| Web App | 5192 | http://localhost:5192 |
-| Mobile | 8081 | Expo Go |
+- **Backend compute routes**: [`apps/api/src/modules/context/routes.ts`](../api/src/modules/context/routes.ts) (AI text generation via mana-llm, server-side credit deduction)
+- **Frontend module** (local-first): [`apps/mana/apps/web/src/lib/modules/context/`](../mana/apps/web/src/lib/modules/context/)
+- **Web route**: [`apps/mana/apps/web/src/routes/(app)/context/`](../mana/apps/web/src/routes/(app)/context/)
+- **Mobile app**: [`apps/context/apps/mobile/`](apps/mobile/)
 
-## Structure
+For monorepo-wide patterns (auth, sync, encryption, services), see the
+[root `CLAUDE.md`](../../CLAUDE.md) and [`apps/mana/CLAUDE.md`](../mana/CLAUDE.md).
 
-```
-apps/context/
-├── apps/
-│   ├── backend/     # Hono/Bun compute server (@context/server)
-│   │   └── src/
-│   │       ├── main.ts
-│   │       ├── app.module.ts
-│   │       ├── db/           # Drizzle schemas + migrations
-│   │       │   ├── schema/
-│   │       │   │   ├── spaces.schema.ts
-│   │       │   │   ├── documents.schema.ts
-│   │       │   │   ├── token-transactions.schema.ts
-│   │       │   │   ├── model-prices.schema.ts
-│   │       │   │   └── user-tokens.schema.ts
-│   │       │   ├── connection.ts
-│   │       │   ├── database.module.ts
-│   │       │   ├── migrate.ts
-│   │       │   └── seed.ts
-│   │       ├── space/        # Space CRUD
-│   │       ├── document/     # Document CRUD + versions + tags
-│   │       ├── ai/           # AI generation (Azure + Google)
-│   │       ├── token/        # Token balance + stats
-│   │       └── common/
-│   ├── web/         # SvelteKit web application (@context/web)
-│   ├── mobile/      # Expo React Native app (@context/mobile)
-│   └── landing/     # (Planned) Astro Landing Page
-├── packages/        # Project-specific shared code
-└── package.json     # Workspace root
-```
+The previous "Context App" guide describing a NestJS backend with its
+own spaces/documents/token tables was deleted in the audit cleanup of
+2026-04-09 — it had been inaccurate since the consolidation. The
+token-economy logic now lives in `mana-credits`. Pre-consolidation
+reference is in git history.
 
-## Development Commands
-
-```bash
-# From monorepo root
-pnpm dev:context:full          # Start auth + backend + web (with DB setup)
-pnpm dev:context:server       # Start backend only (port 3020)
-pnpm dev:context:web           # Start web only (port 5192)
-pnpm dev:context:app           # Start web + backend together
-pnpm dev:context:mobile        # Start mobile app
-
-# Database
-pnpm context:db:push           # Push schema to database
-pnpm context:db:studio         # Open Drizzle Studio
-pnpm context:db:seed           # Seed model prices
-pnpm setup:db:context          # Create DB + push schema
-```
-
-## Tech Stack
-
-| Layer | Technology |
-|-------|------------|
-| **Backend** | Hono + Bun, Drizzle ORM, PostgreSQL |
-| **Web** | SvelteKit 2.x, Svelte 5 (runes mode), Tailwind CSS 4 |
-| **Mobile** | React Native 0.76 + Expo SDK 52, NativeWind |
-| **Auth** | Mana Auth (JWT) |
-| **AI** | Azure OpenAI (GPT-4.1), Google Gemini (Pro, Flash) |
-| **i18n** | svelte-i18n (DE, EN) |
-
-## Core Features
-
-- **Spaces**: Organize documents into collections with prefix-based short IDs
-- **Documents**: Text, context references, and AI prompts with versioning
-- **AI Generation**: Multi-model support (Azure OpenAI, Google Gemini)
-- **Token Economy**: Track and manage AI usage credits per user
-- **Document Versioning**: AI-generated summaries, continuations, rewrites
-
-## Backend API Endpoints
-
-### Health
-
-| Endpoint | Method | Description |
-|----------|--------|-------------|
-| `/health` | GET | Health check |
-
-### Spaces
-
-| Endpoint | Method | Description |
-|----------|--------|-------------|
-| `/api/v1/spaces` | GET | List user's spaces |
-| `/api/v1/spaces` | POST | Create space |
-| `/api/v1/spaces/:id` | GET | Get space details |
-| `/api/v1/spaces/:id` | PUT | Update space |
-| `/api/v1/spaces/:id` | DELETE | Delete space (cascades documents) |
-
-### Documents
-
-| Endpoint | Method | Description |
-|----------|--------|-------------|
-| `/api/v1/documents` | GET | List documents (?spaceId=&preview=true&limit=) |
-| `/api/v1/documents/recent` | GET | Recent documents (?limit=) |
-| `/api/v1/documents` | POST | Create document |
-| `/api/v1/documents/:id` | GET | Get document |
-| `/api/v1/documents/:id` | PUT | Update document |
-| `/api/v1/documents/:id` | DELETE | Delete document |
-| `/api/v1/documents/:id/tags` | PUT | Update document tags |
-| `/api/v1/documents/:id/pinned` | PUT | Toggle pinned |
-| `/api/v1/documents/:id/versions` | GET | Get document versions |
-| `/api/v1/documents/:id/versions` | POST | Create AI version |
-
-### AI
-
-| Endpoint | Method | Description |
-|----------|--------|-------------|
-| `/api/v1/ai/generate` | POST | Generate text (server-side AI) |
-| `/api/v1/ai/estimate` | POST | Estimate token cost |
-
-### Tokens
-
-| Endpoint | Method | Description |
-|----------|--------|-------------|
-| `/api/v1/tokens/balance` | GET | Get user token balance |
-| `/api/v1/tokens/stats` | GET | Usage stats (?timeframe=day\|week\|month\|year) |
-| `/api/v1/tokens/transactions` | GET | Transaction history (?limit=&offset=) |
-| `/api/v1/tokens/models` | GET | Available model prices |
-
-## Database Schema
-
-### spaces
-| Column | Type | Description |
-|--------|------|-------------|
-| `id` | UUID | Primary key |
-| `user_id` | TEXT | Owner |
-| `name` | VARCHAR(255) | Space name |
-| `description` | TEXT | Optional description |
-| `settings` | JSONB | Space settings |
-| `pinned` | BOOLEAN | Pinned in sidebar |
-| `prefix` | VARCHAR(10) | Short ID prefix (e.g. "A") |
-| `text_doc_counter` | INTEGER | Counter for text docs |
-| `context_doc_counter` | INTEGER | Counter for context docs |
-| `prompt_doc_counter` | INTEGER | Counter for prompt docs |
-
-### documents
-| Column | Type | Description |
-|--------|------|-------------|
-| `id` | UUID | Primary key |
-| `user_id` | TEXT | Owner |
-| `space_id` | UUID | FK to spaces (cascade delete) |
-| `title` | VARCHAR(500) | Document title |
-| `content` | TEXT | Document content |
-| `type` | VARCHAR(20) | text / context / prompt |
-| `short_id` | VARCHAR(20) | Short ID (e.g. "AD1") |
-| `pinned` | BOOLEAN | Pinned flag |
-| `metadata` | JSONB | Tags, word count, version info |
-
-### token_transactions
-| Column | Type | Description |
-|--------|------|-------------|
-| `id` | UUID | Primary key |
-| `user_id` | TEXT | User |
-| `amount` | INTEGER | Tokens used (negative for usage) |
-| `transaction_type` | VARCHAR(50) | usage / bonus / purchase |
-| `model_used` | VARCHAR(100) | AI model name |
-| `prompt_tokens` | INTEGER | Input tokens |
-| `completion_tokens` | INTEGER | Output tokens |
-| `cost_usd` | NUMERIC(10,6) | Actual USD cost |
-
-### model_prices
-| Column | Type | Description |
-|--------|------|-------------|
-| `model_name` | VARCHAR(100) | Unique model name |
-| `input_price_per_1k_tokens` | NUMERIC(10,6) | Input price |
-| `output_price_per_1k_tokens` | NUMERIC(10,6) | Output price |
-| `tokens_per_dollar` | INTEGER | App tokens per USD |
-
-### user_tokens
-| Column | Type | Description |
-|--------|------|-------------|
-| `user_id` | TEXT | Primary key |
-| `token_balance` | INTEGER | Current balance |
-| `monthly_free_tokens` | INTEGER | Free monthly allocation |
-
-## Environment Variables
-
-### Backend (.env)
-```env
-NODE_ENV=development
-PORT=3020
-DATABASE_URL=postgresql://mana:devpassword@localhost:5432/context
-MANA_AUTH_URL=http://localhost:3001
-AZURE_OPENAI_API_KEY=your-key
-AZURE_OPENAI_ENDPOINT=https://your-endpoint.openai.azure.com/
-GOOGLE_API_KEY=your-key
-```
-
-### Web (.env)
-```env
-PUBLIC_BACKEND_URL=http://localhost:3020
-PUBLIC_MANA_AUTH_URL=http://localhost:3001
-```
-
-## Important Patterns
-
-1. **API Client pattern** - All web services use `@mana/shared-api-client` (Go-style `{ data, error }`)
-2. **Svelte 5 runes** - `$state`, `$derived`, `$effect` throughout
-3. **Server-side AI keys** - API keys only on backend, never in frontend
-4. **Auto word/token count** - Backend calculates on create/update
-5. **Optimistic updates** - Immediate UI feedback in stores
-6. **Document versioning** - AI generations linked via `parent_document` in metadata
+> **Note:** The legacy `apps/context/pnpm-lock.yaml` (242 KB, separate
+> workspace setup) and the broken `dev:web` / `dev:server` filter scripts
+> in `apps/context/package.json` are tracked in audit items #2 and #26.
diff --git a/apps/context/package.json b/apps/context/package.json
index 162f63ad2..a1f05c94f 100644
--- a/apps/context/package.json
+++ b/apps/context/package.json
@@ -3,9 +3,6 @@
 	"version": "0.1.0",
 	"private": true,
 	"scripts": {
-		"dev": "turbo run dev",
-		"dev:web": "pnpm --filter @context/web dev",
-		"dev:server": "pnpm --filter @context/server dev",
 		"dev:mobile": "pnpm --filter @context/mobile dev"
 	}
 }
diff --git a/apps/guides/CLAUDE.md b/apps/guides/CLAUDE.md
index 5373a37c5..e83959c9a 100644
--- a/apps/guides/CLAUDE.md
+++ b/apps/guides/CLAUDE.md
@@ -1,108 +1,21 @@
-# Guides — CLAUDE.md
+# Guides — consolidated into the unified Mana app
 
-Mana Guides is a local-first step-by-step guide app (SOPs, recipes, tutorials, learning paths).
-Port: **5200** (web), **3027** (server)
-Theme: Teal `#0d9488`
-Tier: `beta`
+This product was migrated into the unified Mana monorepo. The legacy
+per-product `apps/guides/apps/server/` and `apps/guides/apps/web/`
+directories have been removed. Active code now lives in:
 
-## Apps
+- **Backend compute routes**: [`apps/api/src/modules/guides/routes.ts`](../api/src/modules/guides/routes.ts) (URL/text/AI import, structured guide generation via mana-search + mana-llm)
+- **Frontend module** (mostly static content): [`apps/mana/apps/web/src/lib/modules/guides/`](../mana/apps/web/src/lib/modules/guides/)
+- **Web route**: [`apps/mana/apps/web/src/routes/(app)/guides/`](../mana/apps/web/src/routes/(app)/guides/)
 
-| App | Package | Port | Description |
-|-----|---------|------|-------------|
-| `apps/web` | `@guides/web` | 5200 | SvelteKit 5 local-first UI |
-| `apps/server` | `@guides/server` | 3025 | Hono/Bun compute server (import, share) |
+For monorepo-wide patterns (auth, sync, encryption, services), see the
+[root `CLAUDE.md`](../../CLAUDE.md) and [`apps/mana/CLAUDE.md`](../mana/CLAUDE.md).
 
-## Dev Commands
+The previous standalone "Guides" guide was deleted in the audit cleanup
+of 2026-04-09 — it had been inaccurate since the consolidation.
+Pre-consolidation reference is in git history.
 
-```bash
-pnpm dev:guides:web      # Web only
-pnpm dev:guides:server   # Server only
-pnpm dev:guides:app      # Server + web
-pnpm dev:guides:local    # Sync + server + web (no auth)
-pnpm dev:guides:full     # Auth + sync + server + web
-```
-
-## Architecture
-
-**Local-first**: All CRUD goes through `guidesStore` (Dexie.js IndexedDB), synced via mana-sync.
-**Server (port 3025)**: Compute-only — web import via mana-search + mana-llm, shareable links.
-
-### Data Model
-
-```
-LocalGuide         → has many LocalSection, LocalStep
-LocalSection       → has many LocalStep (order field)
-LocalStep          → belongs to LocalGuide, optional LocalSection
-LocalCollection    → has many LocalGuide (ordered list)
-LocalRun           → belongs to LocalGuide, stepStates: Record<stepId, StepState>
-```
-
-### Collections
-
-| Collection | Index | Description |
-|------------|-------|-------------|
-| `guides` | category, difficulty, collectionId | Guide library |
-| `sections` | guideId, order | Optional sections within a guide |
-| `steps` | guideId, sectionId, order | Steps (instruction/warning/tip/checkpoint/code) |
-| `collections` | type | Path or Library groupings |
-| `runs` | guideId, startedAt | Execution history |
-
-## Routes
-
-```
-/                        Library (guide grid, search, filters)
-/guide/[id]              Guide detail + edit mode + run history
-/guide/[id]/run          Run mode (?mode=scroll|focus)
-/collections             Collections grid
-/collections/[id]        Collection detail with progress
-/history                 All run history
-/shared/[token]          Public shared guide (no auth needed) — Phase 4
-/(auth)/login            Login page
-```
-
-## Server Routes (port 3025)
-
-```
-POST /api/v1/import/url    → fetch URL → mana-search extract → mana-llm → { guide, sections }
-POST /api/v1/import/text   → raw text/markdown → mana-llm → { guide, sections }
-POST /api/v1/import/ai     → AI prompt → mana-llm → { guide, sections }
-POST /api/v1/share         → create shareable link (7-day TTL) → { token, url, expiresAt }
-GET  /api/v1/share/:token  → retrieve shared guide snapshot
-GET  /health               → service health check
-```
-
-## Environment Variables
-
-```env
-# Web
-PUBLIC_SYNC_SERVER_URL=ws://localhost:3050
-PUBLIC_GUIDES_SERVER_URL=http://localhost:3027
-
-# Server
-PORT=3027
-CORS_ORIGINS=http://localhost:5200
-MANA_SEARCH_URL=http://localhost:3021
-MANA_LLM_URL=http://localhost:3030
-PUBLIC_BASE_URL=http://localhost:5200
-```
-
-## Key Files
-
-| File | Purpose |
-|------|---------|
-| `apps/web/src/lib/data/local-store.ts` | 5 Dexie collections with TypeScript types |
-| `apps/web/src/lib/data/guest-seed.ts` | 3 demo guides, 1 collection for onboarding |
-| `apps/web/src/lib/stores/guides.svelte.ts` | Guide/section/step/collection mutations |
-| `apps/web/src/lib/stores/runs.svelte.ts` | Run start/step state/complete mutations |
-| `apps/web/src/routes/(app)/guide/[id]/run/+page.svelte` | Scroll + focus run modes |
-| `apps/server/src/routes/import.ts` | URL/text/AI import via mana-llm |
-| `apps/server/src/routes/share.ts` | Shareable guide links (in-memory MVP) |
-
-## Phase Status
-
-| Phase | Status | Description |
-|-------|--------|-------------|
-| 1 | Done | Core CRUD, local-first, guest seed, library/detail/run views |
-| 2 | Done | Collections, StepEditorModal, CollectionEditModal, inline step add |
-| 3 | In progress | Hono server (import + share done), ImportModal frontend, share button |
-| 4 | Planned | DB persistence for shares, /shared/[token] public route, XP/gamification |
+> **Note:** Guides is one of the few modules that doesn't own a Dexie
+> collection (the catalogue is hardcoded in `index.ts`); only `tags` are
+> stored. See `apps/mana/CLAUDE.md` for the standard module pattern this
+> intentionally diverges from.
diff --git a/apps/memoro/CLAUDE.md b/apps/memoro/CLAUDE.md
index 71bc15a55..96ce76c66 100644
--- a/apps/memoro/CLAUDE.md
+++ b/apps/memoro/CLAUDE.md
@@ -1,459 +1,63 @@
-# CLAUDE.md
+# Memoro
 
-This file provides guidance to Claude Code (claude.ai/code) when working with code in this repository.
+AI-powered voice recording + memo management. Memoro is a **hybrid**: its
+frontend was consolidated into the unified Mana web app, but its backend
+was kept as standalone services (Hono + Supabase) because of the
+audio-processing pipeline and the legacy Supabase Storage bucket layout.
 
-## Repository Overview
+## Where things live
 
-Memoro is a monorepo containing an AI-powered voice recording and memo management application with two apps:
+| Surface | Path | Notes |
+|---------|------|-------|
+| **Web frontend** (local-first, in unified Mana app) | [`apps/mana/apps/web/src/lib/modules/memoro/`](../mana/apps/web/src/lib/modules/memoro/) | Same module pattern as every other module — Dexie collections, Svelte 5 stores, runes UI. Reachable via `/memoro` route in mana.how. |
+| **Native mobile app** | [`apps/memoro/apps/mobile/`](apps/mobile/) | React Native + Expo SDK 55. Talks directly to `memoro-server` (NOT to mana.how). Build via EAS, see `apps/mobile/eas.json`. |
+| **Backend compute** | [`apps/memoro/apps/server/`](apps/server/) (`@memoro/server`) | Hono + Bun. Handles memo CRUD, transcription callbacks, spaces, invites, credits, settings, cleanup, meetings. **Still uses Supabase** for some legacy state. Deployed as `memoro-server` container. |
+| **Audio processing** | [`apps/memoro/apps/audio-server/`](apps/audio-server/) | Separate Hono+Bun service for audio uploads + transcoding. Deployed as `memoro-audio-server` container. |
+| **Landing page** | [`apps/memoro/apps/landing/`](apps/landing/) | Astro static landing → Cloudflare Pages |
 
-- **Mobile App** (`apps/mobile/`): React Native + Expo cross-platform app (iOS, Android, Web)
-- **Web App** (`apps/web/`): SvelteKit companion web application
+## Why memoro is not (yet) in `apps/api`
 
-Both apps share the same Supabase backend.
+Most consolidated products migrated their compute routes into
+`apps/api/src/modules/{name}/`. Memoro stayed standalone because:
 
-## Development Commands
+1. **Audio pipeline.** The audio-server runs background transcoding/
+   upload jobs that don't fit the request-response shape of `apps/api`.
+2. **Legacy Supabase coupling.** Memo and storage records still live
+   in Supabase tables (`storage.objects`, RLS policies on `memos`).
+   Migrating to mana_platform was descoped in the consolidation sprint.
+3. **Three deploy targets.** `memoro-server`, `memoro-audio-server`,
+   and the mobile app all need to coordinate. Easier to evolve as one
+   unit while migration is in flight.
 
-### Mobile App (`apps/mobile/`)
+A future cleanup item is to either fold the routes into `apps/api`
+(once Supabase is gone) or document this exception explicitly in the
+root architecture overview.
 
-```bash
-# Development
-npm start                    # Start Expo dev server
-npm run start:dev            # Start with dev environment
-npm run start:prod           # Start with prod environment
-npm run ios                  # Run on iOS simulator
-npm run android              # Run on Android emulator
-npm run web                  # Run web version
-npm run web:dev              # Run web with dev environment
+## Production deployment
 
-# Code Quality
-npm run lint                 # Run ESLint and Prettier check
-npm run lint:fix             # Auto-fix linting issues
-npm run lint:unused          # Find unused imports/vars
-npm run format               # Format code with ESLint + Prettier
-
-# Build & Deploy
-npm run prebuild             # Generate native projects
-npm run rebuild              # Clean rebuild (removes node_modules, ios/, android/)
-npm run web:build            # Build for web deployment
-eas build --profile development   # Development build
-eas build --profile preview       # Preview build
-eas build --profile production    # Production build
-```
-
-### Web App (`apps/web/`)
-
-```bash
-npm run dev                  # Start development server
-npm run build                # Build for production
-npm run preview              # Preview production build
-npm run check                # Run svelte-check
-npm run check:watch          # Watch mode for svelte-check
-```
-
-## Architecture
-
-### Mobile App Architecture
-
-**Framework Stack:**
-- React Native 0.83.2 + Expo SDK 55
-- Expo Router (file-based routing)
-- TypeScript
-- NativeWind (Tailwind CSS for React Native)
-- Zustand (state management)
-
-**Key Design Patterns:**
-
-1. **Feature-Based Architecture** (`features/`):
-   - Each feature is self-contained with its own services, hooks, components, and stores
-   - Features: auth, audioRecordingV2, memos, spaces, credits, subscription, i18n, theme, etc.
-   - 33 feature modules in total
-
-2. **Atomic Design System** (`components/`):
-   - `atoms/`: Basic UI components (Button, Input, Text, Icon, etc.)
-   - `molecules/`: Composite components (MemoPreview, RecordingBar, TagSelector, etc.)
-   - `organisms/`: Complex components (AudioRecorder, Memory, TranscriptDisplay, etc.)
-   - `statistics/`: Specialized analytics components
-
-3. **Route Structure** (`app/`):
-   - `(public)/`: Unauthenticated routes (login, register)
-   - `(protected)/`: Authenticated routes with auth guard
-     - `(tabs)/`: Main tab navigation (home, memos, spaces)
-     - `(memo)/[id]`: Dynamic memo detail pages
-     - `(space)/[id]`: Dynamic space detail pages
-   - Uses Expo Router's file-based routing with typed routes enabled
-
-### Authentication System
-
-Uses a **middleware-based authentication bridge** between the app and Supabase:
+Both backends are part of `docker-compose.macmini.yml`:
 
 ```
-Mobile App → Middleware Auth Service → Supabase
+memoro-server         (apps/memoro/apps/server)         — main backend
+memoro-audio-server   (apps/memoro/apps/audio-server)   — audio worker
 ```
 
-**Key Points:**
-- Middleware issues three tokens: `manaToken`, `appToken` (Supabase-compatible JWT), `refreshToken`
-- Tokens stored securely via platform-specific `safeStorage` utility
-- Auth state managed via `AuthContext` provider
-- Supabase client configured to use JWT from middleware
-- Row Level Security (RLS) policies use JWT claims (`sub`, `role`, `app_id`)
-- Supports email/password, Google Sign-In, and Apple Sign-In
-- Automatic token refresh mechanism
+The mobile app builds via EAS — not part of the monorepo CI.
 
-See `apps/mobile/features/auth/README.md` for detailed authentication flow.
+## Known issues / cleanup items
 
-### Audio Recording System
+- **`@mana/notify-client` is imported by `apps/memoro/apps/server/src/lib/notify.ts:6` but NOT declared as a dependency** in `apps/memoro/apps/server/package.json`. Currently works via hoisted node_modules but should either be added as a workspace dep or replaced with a direct call to `mana-notify`. Tracked in `docs/REFACTORING_AUDIT_2026_04.md` items #29.
+- **`apps/memoro/apps/server` still pulls `@supabase/supabase-js`** — not a bug, but flagged as a dependency to remove once Supabase migration completes.
+- **No `apps/memoro/apps/web`** — was removed during the consolidation. The old SvelteKit "companion web app" lives now under `apps/mana/apps/web/src/lib/modules/memoro/`.
 
-**AudioRecordingV2** is the current audio recording implementation:
+## For monorepo-wide patterns
 
-- Uses `expo-audio` (migrated from deprecated `expo-av`)
-- Platform-specific services: `IOSRecordingService`, `AndroidRecordingService`
-- Zustand store for state management (`recordingStore`)
-- Comprehensive error handling with retry strategies
-- Android: Foreground service with wake locks
-- iOS: Background audio capability with `mixWithOthers` mode
-- Real-time status updates via polling
-- Prevents zero-byte recordings with validation
-- **Background recording works correctly** - continues when app is backgrounded or locked
+See [root `CLAUDE.md`](../../CLAUDE.md) for the overall architecture and
+[`apps/mana/CLAUDE.md`](../mana/CLAUDE.md) for the unified web app's
+module pattern (which the memoro frontend follows).
 
-**iOS Background Recording:**
-- Uses `interruptionMode: 'mixWithOthers'` for background recording support
-- Recording continues when pressing home button, switching apps, or locking device
-- Audio session automatically restored when returning to foreground
-- JavaScript timers suspended in background, but native recording continues
-- Handles real interruptions (phone calls, Siri) automatically
-
-**Recording Options:**
-- High quality: M4A format with AAC encoding (MONO for compatibility)
-- Presets: HIGH_QUALITY, MEDIUM_QUALITY, LOW_QUALITY, VOICE_MEMO
-- Max duration and size limits
-- Pause/resume support
-- Audio level metering for waveform visualization
-- Optimized for voice (MONO, 96 quality) to prevent FFmpeg 'chnl' box errors
-
-**Key Technical Details:**
-- MONO recording prevents iOS spatial audio metadata issues
-- Audio session verification on cold start prevents first-recording failures
-- Status polling restarts when app returns from background
-- Full duration captured (foreground + background time)
-
-See `apps/mobile/features/audioRecordingV2/README.md` for full details.
-See `apps/mobile/features/audioRecordingV2/TROUBLESHOOTING.md` for bug fixes and solutions.
-
-### AI Processing System
-
-**Blueprints:**
-- Reusable AI analysis patterns for different use cases
-- Examples: Text Analysis, Creative Writing, Meeting Notes
-- Each blueprint has localized advice tips (32 languages)
-- Stored in Supabase with public/private visibility
-
-**Prompts:**
-- Specific AI tasks for content transformation
-- Examples: Summary, To-Do extraction, Translation, Q&A
-- Associated with blueprints via `blueprint_prompts` join table
-- Multi-language support (German/English minimum)
-
-**Content Organization:**
-- 8 categories: Coaching, Crafts, Healthcare, Journal, Journalism, Office, Sales, University
-- Categories provide contextual grouping for blueprints/prompts
-
-See `apps/mobile/docs/blueprints_and_prompts.md` for full documentation.
-
-### Theme System
-
-**Multi-Theme Support:**
-- 4 theme variants: Lume (gold), Nature (green), Stone (slate), Ocean (blue)
-- Each theme has light and dark mode variants
-- 13 semantic color tokens per theme (primary, secondary, borders, backgrounds, text)
-- Theme state managed via `ThemeProvider` context
-- Dark mode detection + manual override
-- All colors defined in `tailwind.config.js`
-
-**Markdown Rendering:**
-- Full Markdown support in memo display
-- Theme-aware styles adapt to light/dark mode
-- Centralized styles in `features/theme/markdownStyles.ts`
-- Hybrid rendering with auto-detection
-
-### Spaces (Collaboration)
-
-**Team Workspaces:**
-- Create unlimited collaborative spaces
-- Role-based permissions (owner, member)
-- Memo sharing within spaces
-- Email-based invitation system
-- Credit pools shared among team members
-- Real-time sync via Supabase Realtime
-
-**Backend Integration:**
-- RESTful API for space management
-- RLS policies for access control
-- Space-specific memo filtering
-
-See `apps/mobile/docs/SPACES.md` for implementation details.
-
-### Subscription & Credits
-
-**Mana Credit System:**
-- Backend-driven transparent pricing
-- Real-time credit validation before operations
-- Usage tracking and analytics
-- Credit sharing in team spaces
-- Free tier: 150 Mana + 5 daily Mana
-
-**RevenueCat Integration:**
-- Cross-platform (iOS, Android, Web)
-- Subscription lifecycle management
-- User identification tied to auth
-- Purchase restoration across devices
-- 4 individual plans: Stream (€5.99), River (€14.99), Lake (€29.99), Ocean (€49.99)
-- Team and Enterprise plans available
-
-### Internationalization
-
-**32 Languages Supported:**
-- Arabic, Bengali, Bulgarian, Chinese, Czech, Danish, Dutch, English, Estonian, Finnish, French, Gaelic, German, Greek, Hindi, Croatian, Hungarian, Indonesian, Italian, Japanese, Korean, Lithuanian, Latvian, Maltese, Norwegian, Persian, Polish, Portuguese, Romanian, Russian, Serbian, Slovak, Slovenian, Spanish, Swedish, Turkish, Ukrainian, Urdu, Vietnamese
-
-**Implementation:**
-- `react-i18next` for translations
-- Automatic device language detection
-- Persistent user preference storage
-- RTL support for Arabic/Hebrew
-- Translation files in `features/i18n/translations/`
-
-### Real-Time Features
-
-**Supabase Realtime:**
-- Live memo updates (INSERT, UPDATE, DELETE)
-- Real-time collaboration in spaces
-- `MemoRealtimeProvider` context for subscriptions
-- Automatic reconnection handling
-- RLS-aware subscriptions
-
-### Platform-Specific Notes
-
-**Web Platform:**
-- Uses `.web.ts` file extensions for web-specific implementations
-- `safeStorage.web.ts` uses localStorage (vs AsyncStorage on native)
-- Web Audio API for recording (vs expo-audio)
-- Some features unavailable: push notifications, haptics, native gestures
-
-**iOS:**
-- Background audio capability required
-- Audio session management
-- Apple Sign-In integration
-- RevenueCat StoreKit 2
-
-**Android:**
-- Foreground service for recording
-- Wake lock to prevent sleep
-- Android 16+ requires foreground to start recording
-- Google Sign-In integration
-
-## Environment Configuration
-
-The mobile app uses environment-specific `.env` files:
-
-- `.env.dev`: Development environment (copy from `.env.dev.example`)
-- `.env.prod`: Production environment (copy from `.env.prod.example`)
-- `.env.local`: Active environment (auto-generated by npm scripts)
-
-**Key Environment Variables:**
-- `EXPO_PUBLIC_SUPABASE_URL`: Supabase project URL
-- `EXPO_PUBLIC_SUPABASE_ANON_KEY`: Supabase anon key
-- `EXPO_PUBLIC_MIDDLEWARE_API_URL`: Middleware auth service URL
-- `EXPO_PUBLIC_APPID`: Application ID for middleware
-- RevenueCat keys for iOS/Android
-
-## Code Quality
-
-**Linting:**
-- ESLint with TypeScript plugin
-- React/React Native rules
-- Unused imports auto-removal
-- Configuration in `eslint.config.js`
-
-**Formatting:**
-- Prettier with Tailwind plugin
-- Auto-format on save recommended
-
-**TypeScript:**
-- Strict mode enabled
-- Typed routes from Expo Router
-- Type definitions in `types/` and feature-specific types
-
-## Migration Notes
-
-**Expo SDK 55 (Current):**
-- React Native 0.83.2, React 19.2
-- Native `allowsBackgroundRecording` support in expo-audio (no more workarounds needed)
-- All Expo packages use `^55.x.x` version scheme
-- New Architecture is the default (Legacy Architecture dropped)
-- Android compileSdkVersion/targetSdkVersion 36
-
-**Expo SDK 54 Migration (Historical):**
-- Migrated from `expo-av` to `expo-audio`
-- New audio recording API (`AudioModule.AudioRecorder`)
-- Status polling instead of callbacks
-- See `EXPO_54_AUDIO_RECORDING_MIGRATION.md`
-
-**SvelteKit Web App:**
-- Separate web app being built as companion
-- Shares Supabase backend with mobile app
-- See `SVELTEKIT_MIGRATION_ANALYSIS.md` for migration plan
-
-## Testing Strategy
-
-**Manual Testing:**
-- Test on both iOS and Android before commits
-- Verify web platform compatibility
-- Check dark mode and all theme variants
-- Test with different languages
-
-**Platform Matrix:**
-- iOS (simulator + device)
-- Android (emulator + device)
-- Web (Chrome, Safari, Firefox)
-
-## Common Patterns
-
-### Creating a New Feature
-
-1. Create feature directory in `features/`
-2. Add subdirectories: `components/`, `hooks/`, `services/`, `store/`, `types/`
-3. Export public API via `index.ts`
-4. Add feature-specific README if complex
-5. Update this CLAUDE.md if architectural
-
-### Adding a New Route
-
-1. Add file in `app/` directory following Expo Router conventions
-2. Use `(protected)/` group if authentication required
-3. Use `[id]` for dynamic routes
-4. Enable typed routes in `app.json` (already enabled)
-5. Import route types from `expo-router`
-
-### Working with Zustand Stores
-
-```typescript
-// Create store
-export const useMyStore = create<MyState>((set, get) => ({
-  // state
-  data: null,
-
-  // actions
-  setData: (data) => set({ data }),
-
-  // computed/derived
-  getData: () => get().data,
-}));
-```
-
-Stores are located in:
-- Global: `store/store.ts`
-- Feature-specific: `features/[feature]/store/`
-
-### Platform-Specific Code
-
-Use file extensions for platform-specific implementations:
-- `file.ts`: Default (mobile)
-- `file.web.ts`: Web platform
-- `file.ios.ts`: iOS only
-- `file.android.ts`: Android only
-
-Metro bundler automatically resolves based on platform.
-
-### Error Handling
-
-1. Use feature-specific error types
-2. Provide user-friendly messages
-3. Include retry mechanisms where appropriate
-4. Log errors to console for debugging
-5. Consider Sentry integration for production
-
-## Build and Deployment
-
-**EAS Build Profiles:**
-- `development`: Dev client with debugging
-- `preview`: Internal distribution (TestFlight/Google Play Internal)
-- `simulator`: iOS simulator build
-- `production`: Auto-increment version, store-ready
-
-**Environment Selection:**
-EAS profiles automatically load correct environment via `EXPO_PUBLIC_USE_ENV_FILE` in `eas.json`.
-
-**Version Management:**
-- iOS: `buildNumber` in `app.json`
-- Android: `versionCode` in `app.json`
-- Production profile auto-increments both
-
-## Important Files
-
-- `app.json`: Expo configuration, plugins, permissions
-- `eas.json`: EAS Build configuration
-- `package.json`: Dependencies and scripts
-- `tailwind.config.js`: Theme colors and styling
-- `eslint.config.js`: Linting rules
-- `babel.config.js`: Babel configuration
-- `metro.config.js`: Metro bundler configuration (if present)
-- `types/supabase.ts`: Auto-generated Supabase types
-
-## Database Schema
-
-The app uses Supabase with the following key tables:
-- `memos`: Audio recordings and transcriptions
-- `memories`: AI-generated insights from memos
-- `blueprints`: AI analysis templates
-- `prompts`: AI task templates
-- `blueprint_prompts`: Many-to-many join table
-- `categories`: Organization categories
-- `tags`: User-defined tags
-- `memo_tags`: Many-to-many join table
-- `spaces`: Collaborative workspaces
-- `space_members`: User-space relationships
-- `profiles`: User profiles and settings
-
-All tables use RLS policies based on JWT claims.
-
-## Auto-Delete Audio Files (30-Day Retention)
-
-When users enable `autoDeleteAudiosAfter30Days` in their settings, audio files older than 30 days are automatically deleted while preserving memo records (transcripts, metadata).
-
-**Setting Location:** `app_settings.memoro.autoDeleteAudiosAfter30Days` (default: `false`)
-
-**Two Cleanup Mechanisms:**
-
-1. **Cloud Storage Cleanup** (memoro-service):
-   - Daily cron job at 3 AM UTC via Google Cloud Scheduler
-   - Queries `storage.objects` table for files older than 30 days
-   - Deletes from Supabase Storage bucket `user-uploads`
-   - Updates memo `source` field: `{ audio_path: null, audio_deleted: true, audio_deleted_at: timestamp }`
-
-2. **Local Device Cleanup** (mobile app):
-   - Runs on app launch after successful authentication
-   - Throttled to once per 24 hours
-   - Uses `fileStorageService.cleanupOldFiles()` with 30-day retention
-   - Implementation: `features/storage/services/localAudioCleanup.ts`
-
-**Key Files:**
-- `memoro-service/src/cleanup/` - Cloud cleanup service
-- `mana-middleware/src/modules/users/services/user-settings.service.ts` - User settings query
-- `apps/mobile/features/storage/services/localAudioCleanup.ts` - Local device cleanup
-- `apps/mobile/features/auth/contexts/AuthContext.tsx` - Cleanup trigger after auth
-
-## Known Issues
-
-1. **Android 16+ Recording**: Must be in foreground to start recording
-2. **Zero-byte Recordings**: Occasional issue on some Android devices (retry mechanism in place)
-3. **Token Refresh**: Email may not be in refreshed token (stored separately as workaround)
-4. **Web Platform**: Limited functionality vs native (no push notifications, haptics, etc.)
-
-## Additional Documentation
-
-- `apps/mobile/README.md`: Full mobile app documentation
-- `apps/web/README.md`: Web app documentation
-- `features/auth/README.md`: Authentication system details
-- `features/audioRecordingV2/README.md`: Audio recording implementation
-- `docs/blueprints_and_prompts.md`: AI processing system
-- `docs/SPACES.md`: Collaboration features
-- `SVELTEKIT_MIGRATION_ANALYSIS.md`: Web app migration plan
+The previous 459-line "Memoro repository overview" describing memoro as
+a standalone monorepo with `mana-middleware` and a bespoke auth bridge
+was deleted in the audit cleanup of 2026-04-09. It pre-dated the
+integration into the Mana monorepo and described an architecture that
+no longer exists. Pre-consolidation reference is in git history.
diff --git a/apps/moodlit/CLAUDE.md b/apps/moodlit/CLAUDE.md
index 35f5f69e8..65c1c99f9 100644
--- a/apps/moodlit/CLAUDE.md
+++ b/apps/moodlit/CLAUDE.md
@@ -1,37 +1,17 @@
-# Moodlit — Ambient Lighting & Mood App
+# Moodlit — consolidated into the unified Mana app
 
-## Architecture
+This product was migrated into the unified Mana monorepo. The legacy
+per-product `apps/moodlit/apps/server/` and `apps/moodlit/apps/web/`
+directories have been removed. Active code now lives in:
 
-Local-first for moods/sequences, Hono/Bun server for preset library.
+- **Backend compute routes**: [`apps/api/src/modules/moodlit/routes.ts`](../api/src/modules/moodlit/routes.ts)
+- **Frontend module** (local-first): [`apps/mana/apps/web/src/lib/modules/moodlit/`](../mana/apps/web/src/lib/modules/moodlit/)
+- **Web route**: [`apps/mana/apps/web/src/routes/(app)/moodlit/`](../mana/apps/web/src/routes/(app)/moodlit/)
+- **Landing page** (still standalone): [`apps/moodlit/apps/landing/`](apps/landing/)
 
-```
-Browser → IndexedDB (Moods, Sequences)
-              ↕ sync
-         mana-sync → PostgreSQL
-```
+For monorepo-wide patterns (auth, sync, encryption, services), see the
+[root `CLAUDE.md`](../../CLAUDE.md) and [`apps/mana/CLAUDE.md`](../mana/CLAUDE.md).
 
-## Project Structure
-
-```
-apps/moodlit/
-├── apps/
-│   ├── web/        # SvelteKit web app (local-first)
-│   ├── server/     # Hono/Bun (preset moods API)
-│   └── landing/    # Astro landing page
-└── package.json
-```
-
-## Commands
-
-```bash
-pnpm dev:moodlit:web       # SvelteKit dev server
-pnpm dev:moodlit:server    # Hono/Bun server (port 3073)
-pnpm dev:moodlit:landing   # Landing page
-```
-
-## Local-First Collections
-
-| Collection | Fields |
-|-----------|--------|
-| `moods` | name, colors (hex array), animation, isDefault |
-| `sequences` | name, moodIds, duration (seconds) |
+The previous standalone "Moodlit" guide was deleted in the audit cleanup
+of 2026-04-09 — it had been inaccurate since the consolidation.
+Pre-consolidation reference is in git history.
diff --git a/apps/moodlit/package.json b/apps/moodlit/package.json
index 9cdfe4bb5..287e6a422 100644
--- a/apps/moodlit/package.json
+++ b/apps/moodlit/package.json
@@ -1,8 +1,5 @@
 {
 	"name": "@mana/moodlit",
 	"version": "0.0.1",
-	"private": true,
-	"scripts": {
-		"dev": "turbo run dev"
-	}
+	"private": true
 }
diff --git a/apps/news/CLAUDE.md b/apps/news/CLAUDE.md
index bf837a337..fa20f71a2 100644
--- a/apps/news/CLAUDE.md
+++ b/apps/news/CLAUDE.md
@@ -1,67 +1,17 @@
-# News Hub — AI News Reader & Personal Library
+# News Hub — consolidated into the unified Mana app
 
-## Architecture
+This product was migrated into the unified Mana monorepo. The legacy
+per-product `apps/news/apps/server/` and `apps/news/apps/web/` directories
+have been removed. Active code now lives in:
 
-Local-first for saved articles, Hono/Bun server for content extraction and AI feed.
+- **Backend compute routes**: [`apps/api/src/modules/news/routes.ts`](../api/src/modules/news/routes.ts) (Mozilla Readability extraction, AI feed)
+- **Frontend module** (local-first): [`apps/mana/apps/web/src/lib/modules/news/`](../mana/apps/web/src/lib/modules/news/)
+- **Web route**: [`apps/mana/apps/web/src/routes/(app)/news/`](../mana/apps/web/src/routes/(app)/news/)
+- **Landing page** (still standalone): [`apps/news/apps/landing/`](apps/landing/)
 
-```
-Browser → IndexedDB (Saved Articles, Categories)
-              ↕ sync
-         mana-sync → PostgreSQL
+For monorepo-wide patterns (auth, sync, encryption, services), see the
+[root `CLAUDE.md`](../../CLAUDE.md) and [`apps/mana/CLAUDE.md`](../mana/CLAUDE.md).
 
-Browser → Hono Server → Content Extraction (Mozilla Readability)
-                      → AI Feed (from sync_changes)
-```
-
-## Project Structure
-
-```
-apps/news/
-├── apps/
-│   ├── web/        # SvelteKit web app (local-first)
-│   ├── server/     # Hono/Bun (extraction, feed API)
-│   └── landing/    # Astro marketing page
-└── package.json
-```
-
-## Tech Stack
-
-| Layer | Technology |
-|-------|-----------|
-| **Web** | SvelteKit 2, Svelte 5 (runes), Tailwind CSS 4 |
-| **Server** | Hono + Bun, Mozilla Readability, JSDOM |
-| **Data** | Local-first (Dexie.js + mana-sync) |
-| **Auth** | mana-auth (Better Auth + EdDSA JWT) |
-
-## Commands
-
-```bash
-pnpm dev:news:web       # SvelteKit dev server
-pnpm dev:news:server    # Hono/Bun server (port 3071)
-pnpm dev:news:local     # Web + Sync + Server (no auth)
-pnpm dev:news:full      # Everything incl. auth
-```
-
-## Hono Server Routes
-
-| Route | Auth | Description |
-|-------|------|-------------|
-| `GET /health` | No | Health check |
-| `GET /api/v1/feed` | No | AI article feed (type, categoryId, limit, offset) |
-| `GET /api/v1/feed/:id` | No | Single article |
-| `POST /api/v1/extract/preview` | No | Preview URL content extraction |
-| `POST /api/v1/extract/save` | JWT | Extract + return article data |
-
-## Local-First Collections
-
-| Collection | Purpose |
-|-----------|---------|
-| `articles` | Saved articles (user_saved) + AI feed cache |
-| `categories` | Article categories |
-
-## Key Patterns
-
-- **Content Extraction**: Mozilla Readability + JSDOM for robust HTML parsing
-- **Saved Articles**: Local-first via IndexedDB, sync to server
-- **AI Feed**: Loaded from Hono server, not local-first (server-generated)
-- **Auth**: Guest mode allowed, sync starts on login
+The previous standalone "News Hub" guide was deleted in the audit cleanup
+of 2026-04-09 — it had been inaccurate since the consolidation.
+Pre-consolidation reference is in git history.
diff --git a/apps/news/package.json b/apps/news/package.json
index 9ecc86c4c..5a1d802d8 100644
--- a/apps/news/package.json
+++ b/apps/news/package.json
@@ -1,8 +1,5 @@
 {
 	"name": "@mana/news",
 	"version": "0.0.1",
-	"private": true,
-	"scripts": {
-		"dev": "turbo run dev"
-	}
+	"private": true
 }
diff --git a/apps/nutriphi/CLAUDE.md b/apps/nutriphi/CLAUDE.md
index 89ea20f97..588d8b502 100644
--- a/apps/nutriphi/CLAUDE.md
+++ b/apps/nutriphi/CLAUDE.md
@@ -1,368 +1,17 @@
-# NutriPhi Project Guide
+# NutriPhi — consolidated into the unified Mana app
 
-## Overview
+This product was migrated into the unified Mana monorepo. The legacy
+per-product `apps/nutriphi/apps/backend/` and `apps/nutriphi/apps/web/`
+directories have been removed. Active code now lives in:
 
-**NutriPhi** is an AI-powered nutrition tracking app that allows users to photograph their meals and receive instant nutritional analysis. It uses Google Gemini for image analysis and provides personalized recommendations.
+- **Backend compute routes**: [`apps/api/src/modules/nutriphi/routes.ts`](../api/src/modules/nutriphi/routes.ts) (Gemini meal-photo analysis + text analysis + recommendations)
+- **Frontend module** (local-first): [`apps/mana/apps/web/src/lib/modules/nutriphi/`](../mana/apps/web/src/lib/modules/nutriphi/)
+- **Web route**: [`apps/mana/apps/web/src/routes/(app)/nutriphi/`](../mana/apps/web/src/routes/(app)/nutriphi/)
+- **Landing page** (still standalone): [`apps/nutriphi/apps/landing/`](apps/landing/)
 
-| App | Port | URL |
-|-----|------|-----|
-| Backend | 3023 | http://localhost:3023 |
-| Web App | 5180 | http://localhost:5180 |
-| Landing Page | 4323 | http://localhost:4323 |
+For monorepo-wide patterns (auth, sync, encryption, services), see the
+[root `CLAUDE.md`](../../CLAUDE.md) and [`apps/mana/CLAUDE.md`](../mana/CLAUDE.md).
 
-## Project Structure
-
-```
-apps/nutriphi/
-├── apps/
-│   ├── backend/      # Hono/Bun compute server (@nutriphi/server)
-│   │   └── src/
-│   │       ├── main.ts
-│   │       ├── app.module.ts
-│   │       ├── db/           # Drizzle schemas
-│   │       │   ├── schema/index.ts
-│   │       │   └── db.ts
-│   │       ├── meal/         # Meal CRUD
-│   │       ├── goals/        # User goals
-│   │       ├── favorites/    # Favorite meals
-│   │       ├── analysis/     # Gemini AI integration
-│   │       ├── stats/        # Daily/weekly statistics
-│   │       ├── recommendations/  # AI hints & coaching
-│   │       └── health/
-│   │
-│   ├── web/          # SvelteKit web application (@nutriphi/web)
-│   │   └── src/
-│   │       ├── lib/
-│   │       │   ├── api/client.ts
-│   │       │   ├── stores/
-│   │       │   │   ├── auth.svelte.ts
-│   │       │   │   └── meals.svelte.ts
-│   │       │   └── components/
-│   │       │       ├── Header.svelte
-│   │       │       ├── DailySummary.svelte
-│   │       │       ├── MealList.svelte
-│   │       │       ├── AddMealButton.svelte
-│   │       │       └── ProgressRing.svelte
-│   │       └── routes/
-│   │           ├── +layout.svelte
-│   │           ├── +page.svelte      # Dashboard
-│   │           ├── login/+page.svelte
-│   │           └── add/+page.svelte  # Photo/text input
-│   │
-│   └── landing/      # Astro marketing page (@nutriphi/landing)
-│
-├── packages/
-│   └── shared/       # Shared types, utils, constants (@nutriphi/shared)
-│       └── src/
-│           ├── types/index.ts
-│           ├── constants/index.ts
-│           └── utils/index.ts
-│
-├── package.json
-└── CLAUDE.md
-```
-
-## Commands
-
-### Root Level (from monorepo root)
-
-```bash
-# Start all apps
-pnpm nutriphi:dev
-
-# Individual apps
-pnpm dev:nutriphi:server     # Backend (port 3015)
-pnpm dev:nutriphi:web         # Web app (port 5180)
-pnpm dev:nutriphi:landing     # Landing page (port 4323)
-pnpm dev:nutriphi:app         # Web + backend together
-
-# Database
-pnpm nutriphi:db:push         # Push schema to database
-pnpm nutriphi:db:studio       # Open Drizzle Studio
-```
-
-### Backend (apps/nutriphi/apps/backend)
-
-```bash
-pnpm dev                      # Start with hot reload
-pnpm build                    # Build for production
-pnpm db:push                  # Push schema to database
-pnpm db:studio                # Open Drizzle Studio
-```
-
-### Web App (apps/nutriphi/apps/web)
-
-```bash
-pnpm dev                      # Start dev server (port 5180)
-pnpm build                    # Build for production
-```
-
-### Landing Page (apps/nutriphi/apps/landing)
-
-```bash
-pnpm dev                      # Start dev server (port 4323)
-pnpm build                    # Build for production
-```
-
-## Technology Stack
-
-| Layer | Technology |
-|-------|------------|
-| **Backend** | Hono + Bun, Drizzle ORM, PostgreSQL |
-| **AI** | Google Gemini 2.5 Flash |
-| **Web** | SvelteKit 2.x, Svelte 5 (runes mode), Tailwind CSS 4 |
-| **Landing** | Astro 5.x, Tailwind CSS |
-| **Auth** | Mana Auth (JWT) |
-
-## Architecture
-
-### Core Features
-
-1. **Photo Analysis** - Take a photo, Gemini identifies foods and calculates nutrition
-2. **Text Input** - Alternative: describe your meal in text
-3. **Full Nutrition** - Calories, macros, vitamins, minerals
-4. **Daily Goals** - Set and track calorie/macro targets
-5. **AI Coaching** - Personalized tips based on eating patterns
-6. **Favorites** - Save frequently eaten meals
-7. **Privacy-First** - Photos are never stored, only analysis results
-
-### API Endpoints
-
-#### Health
-| Endpoint | Method | Description |
-|----------|--------|-------------|
-| `/api/v1/health` | GET | Health check |
-
-#### Analysis
-| Endpoint | Method | Description |
-|----------|--------|-------------|
-| `/api/v1/analysis/photo` | POST | Analyze photo (Base64) |
-| `/api/v1/analysis/text` | POST | Analyze text description |
-
-#### Meals
-| Endpoint | Method | Description |
-|----------|--------|-------------|
-| `/api/v1/meals` | GET | List meals (query by date) |
-| `/api/v1/meals` | POST | Create meal |
-| `/api/v1/meals/:id` | GET | Get meal details |
-| `/api/v1/meals/:id` | PATCH | Update meal |
-| `/api/v1/meals/:id` | DELETE | Delete meal |
-
-#### Goals
-| Endpoint | Method | Description |
-|----------|--------|-------------|
-| `/api/v1/goals` | GET | Get user goals |
-| `/api/v1/goals` | POST | Set/update goals |
-| `/api/v1/goals` | DELETE | Delete goals |
-
-#### Favorites
-| Endpoint | Method | Description |
-|----------|--------|-------------|
-| `/api/v1/favorites` | GET | List favorites |
-| `/api/v1/favorites` | POST | Create favorite |
-| `/api/v1/favorites/:id/use` | POST | Increment usage count |
-| `/api/v1/favorites/:id` | DELETE | Delete favorite |
-
-#### Stats
-| Endpoint | Method | Description |
-|----------|--------|-------------|
-| `/api/v1/stats/daily` | GET | Daily summary |
-| `/api/v1/stats/weekly` | GET | Weekly stats |
-
-#### Recommendations
-| Endpoint | Method | Description |
-|----------|--------|-------------|
-| `/api/v1/recommendations` | GET | List active recommendations |
-| `/api/v1/recommendations/:id/dismiss` | POST | Dismiss recommendation |
-
-### Database Schema
-
-#### user_goals
-| Column | Type | Description |
-|--------|------|-------------|
-| id | UUID | Primary key |
-| user_id | UUID | User ID |
-| daily_calories | INTEGER | Daily calorie target |
-| daily_protein | INTEGER | Protein target (g) |
-| daily_carbs | INTEGER | Carbs target (g) |
-| daily_fat | INTEGER | Fat target (g) |
-
-#### meals
-| Column | Type | Description |
-|--------|------|-------------|
-| id | UUID | Primary key |
-| user_id | UUID | User ID |
-| date | TIMESTAMP | Meal date/time |
-| meal_type | VARCHAR | breakfast/lunch/dinner/snack |
-| input_type | VARCHAR | photo/text |
-| description | TEXT | AI-generated description |
-| confidence | REAL | AI confidence (0-1) |
-
-#### meal_nutrition
-| Column | Type | Description |
-|--------|------|-------------|
-| id | UUID | Primary key |
-| meal_id | UUID | FK to meals |
-| calories | REAL | Calories (kcal) |
-| protein | REAL | Protein (g) |
-| carbohydrates | REAL | Carbs (g) |
-| fat | REAL | Fat (g) |
-| fiber | REAL | Fiber (g) |
-| sugar | REAL | Sugar (g) |
-| vitamin_* | REAL | Various vitamins |
-| calcium, iron, etc. | REAL | Minerals |
-
-#### favorite_meals
-| Column | Type | Description |
-|--------|------|-------------|
-| id | UUID | Primary key |
-| user_id | UUID | User ID |
-| name | VARCHAR | Favorite name |
-| nutrition | JSONB | Cached nutrition data |
-| usage_count | INTEGER | Times used |
-
-#### recommendations
-| Column | Type | Description |
-|--------|------|-------------|
-| id | UUID | Primary key |
-| user_id | UUID | User ID |
-| type | VARCHAR | hint/coaching |
-| message | TEXT | Recommendation text |
-| dismissed | BOOLEAN | User dismissed |
-
-## Environment Variables
-
-### Backend (.env)
-
-```env
-NODE_ENV=development
-PORT=3023
-DATABASE_URL=postgresql://mana:devpassword@localhost:5432/nutriphi
-MANA_AUTH_URL=http://localhost:3001
-CORS_ORIGINS=http://localhost:5180,http://localhost:4323
-
-# Gemini AI (uses gemini-2.5-flash model)
-GEMINI_API_KEY=your-gemini-api-key
-```
-
-> **Note:** Get your API key from https://aistudio.google.com/apikey
-
-### Web (.env)
-
-```env
-PUBLIC_BACKEND_URL=http://localhost:3023
-PUBLIC_MANA_AUTH_URL=http://localhost:3001
-```
-
-## Shared Package (@nutriphi/shared)
-
-**Types:**
-- `UserGoals` - Daily nutrition targets
-- `Meal`, `MealNutrition` - Meal data
-- `FavoriteMeal` - Saved favorites
-- `DailySummary`, `WeeklyStats` - Statistics
-- `AIAnalysisResult` - Gemini response format
-- `Recommendation` - AI hints/coaching
-
-**Constants:**
-- `DEFAULT_DAILY_VALUES` - Reference daily values
-- `MEAL_TYPE_LABELS` - Localized meal names
-- `NUTRIENT_INFO` - Labels, units, colors
-- `CREDIT_COSTS` - Credit pricing
-
-**Utils:**
-- `calculateProgress()` - Progress towards goals
-- `sumNutrition()` - Sum multiple meals
-- `formatNutrient()` - Display formatting
-- `detectDeficiencies()` - Find nutrient gaps
-- `suggestMealType()` - Based on time of day
-
-## Quick Start
-
-### 1. Create Database
-
-```bash
-# PostgreSQL must be running
-docker compose -f docker-compose.dev.yml up -d postgres
-
-# Create database
-PGPASSWORD=devpassword psql -h localhost -U mana -d postgres -c "CREATE DATABASE nutriphi;"
-
-# Push schema
-pnpm nutriphi:db:push
-```
-
-### 2. Set Gemini API Key
-
-Add to `.env.development`:
-```env
-GEMINI_API_KEY=your-gemini-api-key
-```
-
-### 3. Start Apps
-
-```bash
-# Backend + Web together
-pnpm dev:nutriphi:app
-
-# Or individually:
-pnpm dev:nutriphi:server  # Terminal 1
-pnpm dev:nutriphi:web      # Terminal 2
-pnpm dev:nutriphi:landing  # Terminal 3
-```
-
-### 4. Open URLs
-
-- Web App: http://localhost:5180
-- Landing: http://localhost:4323
-- API Health: http://localhost:3023/api/v1/health
-
-## Testing API
-
-```bash
-# Health Check
-curl http://localhost:3023/api/v1/health
-
-# Login (get token)
-TOKEN=$(curl -s -X POST http://localhost:3001/api/v1/auth/login \
-  -H "Content-Type: application/json" \
-  -d '{"email": "test@example.com", "password": "password"}' | jq -r '.accessToken')
-
-# Analyze text
-curl -X POST http://localhost:3023/api/v1/analysis/text \
-  -H "Authorization: Bearer $TOKEN" \
-  -H "Content-Type: application/json" \
-  -d '{"description": "Spaghetti Bolognese mit Parmesan"}'
-
-# Get daily summary
-curl http://localhost:3023/api/v1/stats/daily \
-  -H "Authorization: Bearer $TOKEN"
-```
-
-## Credit System
-
-| Action | Credits |
-|--------|---------|
-| Photo Analysis | 5 |
-| Text Analysis | 2 |
-| AI Coaching | 10 |
-
-## Privacy Features
-
-- Photos are NEVER stored on servers
-- Photos are sent directly to Gemini, analyzed, then discarded
-- Only nutrition results are saved
-- Full data export available (GDPR)
-- One-click account deletion
-
-## Color Theme
-
-| Color | Value | Usage |
-|-------|-------|-------|
-| Primary | #22C55E | Main actions, progress |
-| Secondary | #F97316 | Accent, warnings |
-| Accent | #14B8A6 | Highlights |
-| Calories | #F59E0B | Calorie displays |
-| Protein | #EF4444 | Protein displays |
-| Carbs | #3B82F6 | Carb displays |
-| Fat | #8B5CF6 | Fat displays |
+The previous standalone "NutriPhi Project Guide" was deleted in the
+audit cleanup of 2026-04-09 — it had been inaccurate since the
+consolidation. Pre-consolidation reference is in git history.
diff --git a/apps/picture/CLAUDE.md b/apps/picture/CLAUDE.md
index 031c70493..7cba4e6e9 100644
--- a/apps/picture/CLAUDE.md
+++ b/apps/picture/CLAUDE.md
@@ -1,194 +1,20 @@
-# Picture App - CLAUDE.md
+# Picture — consolidated into the unified Mana app
 
-AI image generation app using Replicate API with freemium credit system.
+This product was migrated into the unified Mana monorepo. The legacy
+per-product `apps/picture/apps/backend/` and `apps/picture/apps/web/`
+directories have been removed. Active code now lives in:
 
-## Project Structure
+- **Backend compute routes**: [`apps/api/src/modules/picture/routes.ts`](../api/src/modules/picture/routes.ts) (Replicate / image-gen orchestration, server-side credit deduction)
+- **Frontend module** (local-first): [`apps/mana/apps/web/src/lib/modules/picture/`](../mana/apps/web/src/lib/modules/picture/)
+- **Web route**: [`apps/mana/apps/web/src/routes/(app)/picture/`](../mana/apps/web/src/routes/(app)/picture/)
+- **Landing page** (still standalone): [`apps/picture/apps/landing/`](apps/landing/)
+- **Mobile app**: [`apps/picture/apps/mobile/`](apps/mobile/)
 
-```
-apps/picture/
-├── apps/
-│   ├── backend/     # Hono/Bun server (port 3006)
-│   ├── mobile/      # Expo React Native app
-│   ├── web/         # SvelteKit web app
-│   └── landing/     # Astro marketing page
-└── packages/        # Shared code
-```
+For monorepo-wide patterns (auth, sync, encryption, services), see the
+[root `CLAUDE.md`](../../CLAUDE.md) and [`apps/mana/CLAUDE.md`](../mana/CLAUDE.md).
 
-## Quick Start
-
-```bash
-# From monorepo root
-pnpm dev:picture:full    # Start backend + web + auto DB setup
-
-# Individual apps
-pnpm --filter @picture/server dev    # Backend only (port 3006)
-pnpm --filter @picture/web dev        # Web only
-pnpm --filter @picture/mobile dev     # Mobile only
-```
-
-## Backend Architecture
-
-### Key Services
-
-| Service | Purpose |
-|---------|---------|
-| `GenerateService` | AI image generation with freemium/credit logic |
-| `ReplicateService` | Replicate API integration |
-| `StorageService` | MinIO/S3 storage via `@mana/shared-storage` |
-| `CreditClientService` | Credit system via `@mana-core/nestjs-integration` |
-
-### Freemium Model
-
-- **Free tier**: 3 free generations per user
-- **Paid tier**: 10 credits per generation
-- **Enforcement**: Only in staging (`NODE_ENV=staging`)
-- **Development**: Fail-open (no credit enforcement)
-
-### Environment Variables
-
-| Variable | Description | Required |
-|----------|-------------|----------|
-| `REPLICATE_API_TOKEN` | Replicate API key | Yes |
-| `DATABASE_URL` | PostgreSQL connection | Yes |
-| `S3_ENDPOINT` | MinIO/S3 endpoint | Yes |
-| `MANA_AUTH_URL` | Auth service URL | Yes |
-| `MANA_SERVICE_KEY` | Service key for credits | Staging only |
-| `APP_ID` | App identifier | Yes |
-
----
-
-## TODO List
-
-### Testing Required
-
-- [ ] **Test freemium flow with new user**
-  - Create new user ID and verify 3 free generations work
-  - Verify `freeGenerationsRemaining` decrements correctly (3 → 2 → 1 → 0)
-  - Verify 4th generation still works in development (fail-open)
-
-- [ ] **Test staging credit enforcement**
-  - Set `NODE_ENV=staging` and test credit check
-  - Verify HTTP 402 returned when credits insufficient
-  - Test with valid `MANA_SERVICE_KEY`
-
-- [ ] **Test async generation (webhook mode)**
-  - Test generation without `waitForResult: true`
-  - Verify webhook receives completion callback
-  - Verify credits consumed on webhook success
-
-- [ ] **Test error handling**
-  - Test with invalid model ID
-  - Test with invalid Replicate API token
-  - Test storage upload failures
-
-- [ ] **Integration tests**
-  - Write Jest tests for `GenerateService`
-  - Mock `CreditClientService` calls
-  - Test all generation paths (free/paid, sync/async)
-
-### Features to Implement
-
-- [ ] **Add credit balance endpoint**
-  - GET `/api/v1/credits/balance` - Return user's credit balance
-  - Use `CreditClientService.getBalance()`
-
-- [ ] **Add generation history endpoint**
-  - GET `/api/v1/generate/history` - User's generation history
-  - Include credits used per generation
-
-- [ ] **Improve error messages**
-  - Add proper error codes for credit failures
-  - Return helpful messages for insufficient credits
-
-- [ ] **Rate limiting**
-  - Add rate limits for generation endpoints
-  - Prevent abuse of free tier
-
-### Web App Tasks
-
-- [ ] **Show free generations remaining**
-  - Display counter in UI
-  - Show warning when approaching limit
-
-- [ ] **Credit purchase flow**
-  - Integrate with mana-core credit purchase
-  - Show credit balance in header
-
-- [ ] **Generation queue UI**
-  - Show pending generations
-  - Poll for status updates
-
-### Mobile App Tasks
-
-- [ ] **Implement generation screen**
-  - Model selection
-  - Prompt input with suggestions
-  - Generation progress indicator
-
-- [ ] **Gallery view**
-  - Grid view of user's generated images
-  - Favorites functionality
-
-### DevOps Tasks
-
-- [ ] **Staging deployment**
-  - Deploy backend to staging server
-  - Configure `MANA_SERVICE_KEY` in staging
-  - Test credit system end-to-end
-
-- [ ] **Monitoring**
-  - Add logging for credit operations
-  - Track generation success/failure rates
-  - Monitor Replicate API usage
-
----
-
-## API Endpoints
-
-### Generate
-
-```bash
-# Generate image (sync)
-POST /api/v1/generate
-{
-  "prompt": "A beautiful sunset",
-  "modelId": "uuid",
-  "waitForResult": true
-}
-
-# Check status
-GET /api/v1/generate/:id/status
-
-# Cancel generation
-DELETE /api/v1/generate/:id
-
-# Webhook (internal)
-POST /api/v1/generate/webhook
-```
-
-### Models
-
-```bash
-GET /api/v1/models         # List all models
-GET /api/v1/models/:id     # Get model details
-```
-
-### Images
-
-```bash
-GET /api/v1/images         # List user's images
-GET /api/v1/images/:id     # Get image details
-DELETE /api/v1/images/:id  # Delete image
-```
-
----
-
-## Recent Changes
-
-### 2025-12-10: Credit System Integration
-
-- Added `@mana-core/nestjs-integration` for credit system
-- Implemented freemium model (3 free, then 10 credits)
-- Credit enforcement only in staging environment
-- Updated `GenerateService` with `checkGenerationAccess()`
-- Response includes `freeGenerationsRemaining` count
+The previous standalone "Picture App" guide describing a per-product
+backend with `GenerateService`, `ReplicateService` etc. was deleted in
+the audit cleanup of 2026-04-09 — it had been inaccurate since the
+consolidation. The freemium credit logic now lives in `apps/api` and
+talks to `mana-credits`. Pre-consolidation reference is in git history.
diff --git a/apps/planta/CLAUDE.md b/apps/planta/CLAUDE.md
index 49cd3fdcd..7d5be689a 100644
--- a/apps/planta/CLAUDE.md
+++ b/apps/planta/CLAUDE.md
@@ -1,167 +1,22 @@
-# Planta Project Guide
+# Planta — consolidated into the unified Mana app
 
-## Project Structure
+This product was migrated into the unified Mana monorepo. The legacy
+per-product `apps/planta/apps/backend/` and `apps/planta/apps/web/`
+directories have been removed. Active code now lives in:
 
-```
-apps/planta/
-├── apps/
-│   ├── backend/      # Hono/Bun compute server (@planta/server)
-│   └── web/          # SvelteKit web application (@planta/web)
-├── packages/
-│   └── shared/       # Shared types, utils (@planta/shared)
-└── package.json
-```
+- **Backend compute routes**: [`apps/api/src/modules/planta/routes.ts`](../api/src/modules/planta/routes.ts) (Gemini Vision plant analysis, S3 upload)
+- **Frontend module** (local-first): [`apps/mana/apps/web/src/lib/modules/planta/`](../mana/apps/web/src/lib/modules/planta/)
+- **Web route**: [`apps/mana/apps/web/src/routes/(app)/planta/`](../mana/apps/web/src/routes/(app)/planta/)
 
-## Commands
+For monorepo-wide patterns (auth, sync, encryption, services), see the
+[root `CLAUDE.md`](../../CLAUDE.md) and [`apps/mana/CLAUDE.md`](../mana/CLAUDE.md).
 
-### Root Level (from monorepo root)
+The previous standalone "Planta Project Guide" describing a per-product
+backend with its own database, schema, and watering scheduler was deleted
+in the audit cleanup of 2026-04-09 — it had been inaccurate since the
+consolidation. Pre-consolidation reference is in git history.
 
-```bash
-pnpm planta:dev                   # Run all planta apps
-pnpm dev:planta:web               # Start web app
-pnpm dev:planta:server           # Start backend server
-pnpm dev:planta:app               # Start web + backend together
-pnpm dev:planta:full              # Start auth + backend + web with DB setup
-```
-
-### Backend (apps/planta/apps/backend)
-
-```bash
-pnpm dev                         # Start with hot reload
-pnpm build                       # Build for production
-pnpm start:prod                  # Start production server
-pnpm db:push                     # Push schema to database
-pnpm db:studio                   # Open Drizzle Studio
-```
-
-### Web App (apps/planta/apps/web)
-
-```bash
-pnpm dev                         # Start dev server
-pnpm build                       # Build for production
-pnpm preview                     # Preview production build
-```
-
-## Technology Stack
-
-- **Web**: SvelteKit 2.x, Svelte 5 (runes mode), Tailwind CSS
-- **Backend**: Hono + Bun, Drizzle ORM, PostgreSQL
-- **AI**: Google Gemini Vision for plant analysis
-- **Storage**: MinIO (S3-compatible)
-- **Auth**: Mana Auth (JWT)
-- **Types**: TypeScript 5.x
-
-## Architecture
-
-### Core Flow
-
-1. User uploads plant photo
-2. Photo stored in S3/MinIO
-3. Gemini Vision analyzes the image
-4. Plant profile created with care recommendations
-5. Watering schedule tracked
-
-### Backend API Endpoints
-
-| Endpoint                        | Method | Description              |
-| ------------------------------- | ------ | ------------------------ |
-| `/api/health`                   | GET    | Health check             |
-| `/api/plants`                   | GET    | Get user's plants        |
-| `/api/plants`                   | POST   | Create new plant         |
-| `/api/plants/:id`               | GET    | Get plant details        |
-| `/api/plants/:id`               | PUT    | Update plant             |
-| `/api/plants/:id`               | DELETE | Delete plant             |
-| `/api/photos/upload`            | POST   | Upload plant photo       |
-| `/api/photos/:id`               | DELETE | Delete photo             |
-| `/api/analysis/identify`        | POST   | Analyze photo with AI    |
-| `/api/analysis/:photoId`        | GET    | Get analysis results     |
-| `/api/watering/upcoming`        | GET    | Plants needing water     |
-| `/api/watering/:plantId/water`  | POST   | Log watering event       |
-
-### Database Schema
-
-**plants** - User's plants
-
-- `id` (UUID) - Primary key
-- `user_id` (TEXT) - User reference
-- `name` (TEXT) - Plant nickname
-- `scientific_name` (TEXT) - From AI analysis
-- `common_name` (TEXT) - Common name
-- `light_requirements` (TEXT) - low/medium/bright/direct
-- `watering_frequency_days` (INT) - Days between watering
-- `humidity` (TEXT) - low/medium/high
-- `care_notes` (TEXT) - Care tips
-- `health_status` (TEXT) - healthy/needs_attention/sick
-
-**plant_photos** - Plant photos
-
-- `id` (UUID) - Primary key
-- `plant_id` (UUID) - FK to plants
-- `storage_path` (TEXT) - S3 path
-- `public_url` (TEXT) - Public URL
-- `is_primary` (BOOLEAN) - Primary photo flag
-- `is_analyzed` (BOOLEAN) - Analysis flag
-
-**plant_analyses** - AI analysis results
-
-- `id` (UUID) - Primary key
-- `photo_id` (UUID) - FK to plant_photos
-- `identified_species` (TEXT) - Detected species
-- `confidence` (INT) - 0-100 confidence
-- `health_assessment` (TEXT) - Health status
-- `watering_advice` (TEXT) - Watering recommendation
-- `general_tips` (JSONB) - Care tips array
-
-**watering_schedules** - Watering tracking
-
-- `id` (UUID) - Primary key
-- `plant_id` (UUID) - FK to plants
-- `frequency_days` (INT) - Interval
-- `last_watered_at` (TIMESTAMP) - Last watering
-- `next_watering_at` (TIMESTAMP) - Next watering
-
-### Environment Variables
-
-#### Backend (.env)
-
-```
-NODE_ENV=development
-PORT=3022
-DATABASE_URL=postgresql://mana:devpassword@localhost:5432/planta
-MANA_AUTH_URL=http://localhost:3001
-GOOGLE_GEMINI_API_KEY=xxx
-CORS_ORIGINS=http://localhost:5173,http://localhost:5191
-S3_ENDPOINT=http://localhost:9000
-S3_BUCKET=planta-storage
-S3_ACCESS_KEY=minioadmin
-S3_SECRET_KEY=minioadmin
-```
-
-#### Web (.env)
-
-```
-PUBLIC_BACKEND_URL=http://localhost:3022
-PUBLIC_MANA_AUTH_URL=http://localhost:3001
-```
-
-## Shared Package
-
-### @planta/shared
-
-- Types: `Plant`, `PlantPhoto`, `PlantAnalysis`, `WateringSchedule`
-- Utils: Date helpers, care level formatters
-
-## Code Style Guidelines
-
-- **TypeScript**: Strict typing with interfaces
-- **Web**: Svelte 5 runes mode (`$state`, `$derived`, `$effect`)
-- **Styling**: Tailwind CSS
-- **Formatting**: Prettier with project config
-
-## Important Notes
-
-1. **Authentication**: Uses Mana Auth (JWT in Authorization header)
-2. **Database**: PostgreSQL with Drizzle ORM
-3. **Port**: Backend runs on port 3022 by default
-4. **Storage**: Photos stored in MinIO (S3-compatible)
-5. **AI**: Google Gemini Vision for plant identification
+> **Note:** The orphaned `apps/planta/packages/shared/` package and the
+> related sub-script entries in `apps/planta/package.json` referencing
+> non-existent `@planta/server` / `@planta/web` filters are tracked as
+> dead code in `docs/REFACTORING_AUDIT_2026_04.md` items #18/#29.
diff --git a/apps/planta/package.json b/apps/planta/package.json
index 0f7731adb..ad0d90911 100644
--- a/apps/planta/package.json
+++ b/apps/planta/package.json
@@ -3,14 +3,6 @@
 	"version": "0.1.0",
 	"private": true,
 	"description": "Planta - Plant Documentation & Care App",
-	"scripts": {
-		"dev": "turbo run dev",
-		"dev:server": "pnpm --filter @planta/server dev",
-		"dev:web": "pnpm --filter @planta/web dev",
-		"db:push": "pnpm --filter @planta/server db:push",
-		"db:studio": "pnpm --filter @planta/server db:studio",
-		"db:seed": "pnpm --filter @planta/server db:seed"
-	},
 	"devDependencies": {
 		"typescript": "^5.9.3"
 	},
diff --git a/apps/presi/CLAUDE.md b/apps/presi/CLAUDE.md
index 738ea482e..04c9ce363 100644
--- a/apps/presi/CLAUDE.md
+++ b/apps/presi/CLAUDE.md
@@ -1,213 +1,18 @@
-# Presi Project Guide
+# Presi — consolidated into the unified Mana app
 
-## Project Structure
+This product was migrated into the unified Mana monorepo. The legacy
+per-product `apps/presi/apps/backend/` (NestJS) and `apps/presi/apps/web/`
+directories have been removed. Active code now lives in:
 
-```
-apps/presi/
-├── apps/
-│   ├── backend/      # NestJS API server (@presi/backend)
-│   ├── web/          # SvelteKit web application (@presi/web)
-│   └── landing/      # Astro marketing landing page (@presi/landing)
-├── packages/
-│   └── shared/       # Shared types and utils (@presi/shared)
-└── package.json
-```
+- **Backend compute routes**: [`apps/api/src/modules/presi/routes.ts`](../api/src/modules/presi/routes.ts) (public share-link lookups, share management)
+- **Frontend module** (local-first): [`apps/mana/apps/web/src/lib/modules/presi/`](../mana/apps/web/src/lib/modules/presi/)
+- **Web route**: [`apps/mana/apps/web/src/routes/(app)/presi/`](../mana/apps/web/src/routes/(app)/presi/)
+- **Landing page** (still standalone): [`apps/presi/apps/landing/`](apps/landing/)
 
-## Commands
+For monorepo-wide patterns (auth, sync, encryption, services), see the
+[root `CLAUDE.md`](../../CLAUDE.md) and [`apps/mana/CLAUDE.md`](../mana/CLAUDE.md).
 
-### Root Level (from monorepo root)
-
-```bash
-pnpm presi:dev                   # Run all presi apps
-pnpm dev:presi:web               # Start web app (port 5178)
-pnpm dev:presi:backend           # Start backend server
-pnpm dev:presi:app               # Start web + backend together
-pnpm presi:db:push               # Push schema to database
-pnpm presi:db:studio             # Open Drizzle Studio
-pnpm presi:db:seed               # Seed database with sample data
-```
-
-### Web App (apps/presi/apps/web)
-
-```bash
-pnpm dev                         # Start dev server (port 5178)
-pnpm build                       # Build for production
-pnpm preview                     # Preview production build
-pnpm check                       # Run svelte-check
-```
-
-### Backend (apps/presi/apps/backend)
-
-```bash
-pnpm dev                         # Start with hot reload
-pnpm build                       # Build for production
-pnpm start:prod                  # Start production server
-pnpm db:push                     # Push schema to database
-pnpm db:studio                   # Open Drizzle Studio
-pnpm db:seed                     # Seed database
-```
-
-## Technology Stack
-
-- **Web**: SvelteKit 2.x, Svelte 5 (runes mode), Tailwind CSS
-- **Backend**: NestJS 10, Drizzle ORM, PostgreSQL
-- **Types**: TypeScript 5.x
-
-## Architecture
-
-### Core Features
-
-- Create and manage presentation decks
-- Add and edit slides with various content types
-- Apply themes to presentations
-- Share decks via share codes
-- Present slides in full-screen mode
-
-### Backend API Endpoints
-
-| Endpoint                    | Method | Auth | Description              |
-| --------------------------- | ------ | ---- | ------------------------ |
-| `/api/health`               | GET    | No   | Health check             |
-| `/api/decks`                | GET    | Yes  | Get user's decks         |
-| `/api/decks`                | POST   | Yes  | Create new deck          |
-| `/api/decks/:id`            | GET    | Yes  | Get deck details         |
-| `/api/decks/:id`            | PUT    | Yes  | Update deck              |
-| `/api/decks/:id`            | DELETE | Yes  | Delete deck              |
-| `/api/decks/:id/slides`     | GET    | Yes  | Get slides for deck      |
-| `/api/decks/:id/slides`     | POST   | Yes  | Add slide to deck        |
-| `/api/slides/:id`           | PUT    | Yes  | Update slide             |
-| `/api/slides/:id`           | DELETE | Yes  | Delete slide             |
-| `/api/slides/reorder`       | PUT    | Yes  | Reorder slides           |
-| `/api/share/:code`          | GET    | No   | Get shared deck (public) |
-| `/api/share/deck/:id`       | POST   | Yes  | Create share link        |
-| `/api/share/deck/:id/links` | GET    | Yes  | Get share links for deck |
-| `/api/share/:shareId`       | DELETE | Yes  | Delete share link        |
-
-### Data Models
-
-**Deck** - Presentation deck
-
-- `id` (string) - Unique identifier
-- `userId` (string) - Owner user ID
-- `title` (string) - Deck title
-- `description` (string?) - Optional description
-- `themeId` (string?) - Theme reference
-- `isPublic` (boolean) - Visibility flag
-- `createdAt` / `updatedAt` (timestamps)
-
-**Slide** - Individual slide in a deck
-
-- `id` (string) - Unique identifier
-- `deckId` (string) - Parent deck reference
-- `order` (number) - Position in deck
-- `content` (SlideContent) - Slide content
-- `createdAt` (timestamp)
-
-**SlideContent** - Content structure
-
-- `type`: 'title' | 'content' | 'image' | 'split'
-- `title`, `subtitle`, `body`, `imageUrl`, `bulletPoints`
-
-**Theme** - Visual theme
-
-- `id`, `name`, `colors`, `fonts`, `isDefault`
-
-**SharedDeck** - Share link for deck
-
-- `id` (string) - Unique identifier
-- `deckId` (string) - Reference to deck
-- `shareCode` (string) - Unique share code (12 chars)
-- `expiresAt` (timestamp?) - Optional expiration
-- `createdAt` (timestamp)
-
-### Environment Variables
-
-#### Backend (.env)
-
-```
-NODE_ENV=development
-PORT=3008
-DATABASE_URL=postgresql://mana:devpassword@localhost:5432/presi
-MANA_AUTH_URL=http://localhost:3001
-CORS_ORIGINS=http://localhost:5173,http://localhost:8081
-```
-
-#### Web (.env)
-
-```
-PUBLIC_BACKEND_URL=http://localhost:3008
-PUBLIC_MANA_AUTH_URL=http://localhost:3001
-```
-
-## Shared Package
-
-### @presi/shared
-
-Located at `packages/shared/`
-
-**Types:**
-
-- `Deck`, `Slide`, `SlideContent`
-- `Theme`, `ThemeColors`, `ThemeFonts`
-- `SharedDeck` (for sharing feature)
-
-**DTOs:**
-
-- `CreateDeckDto`, `UpdateDeckDto`
-- `CreateSlideDto`, `UpdateSlideDto`
-- `ReorderSlidesDto`
-
-## Code Style Guidelines
-
-- **TypeScript**: Strict typing with interfaces
-- **Web**: Svelte 5 runes mode (`$state`, `$derived`, `$effect`)
-- **Backend**: NestJS modules with controllers and services
-- **Styling**: Tailwind CSS
-- **Formatting**: Prettier with project config
-
-## Web App Features
-
-The SvelteKit web app provides the main user interface:
-
-- **Authentication**: Login/Register/Forgot Password with Mana Auth
-- **Deck Management**: Create, edit, delete presentation decks
-- **Slide Editor**: Create slides with title, body, bullet points, images
-- **Presentation Mode**: Fullscreen presentation with keyboard navigation
-  - Arrow keys / A/D for navigation
-  - F for fullscreen toggle
-  - ESC to exit
-  - Timer with start/pause
-  - Speaker notes toggle
-- **Sharing**: Create share links for decks, public view without auth
-- **Profile**: View user info and deck statistics
-- **Settings**: Theme switching (light/dark/system), account info
-
-### Web App Structure
-
-```
-src/
-├── lib/
-│   ├── api/client.ts        # API client with auth
-│   └── stores/
-│       ├── auth.svelte.ts   # Auth state (Svelte 5 runes)
-│       └── decks.svelte.ts  # Decks/slides state
-├── routes/
-│   ├── +layout.svelte       # App layout with header
-│   ├── +page.svelte         # Deck list (home)
-│   ├── login/               # Login page
-│   ├── register/            # Register page
-│   ├── forgot-password/     # Password reset page
-│   ├── deck/[id]/           # Deck editor with slides
-│   ├── present/[id]/        # Presentation mode
-│   ├── shared/[code]/       # Public shared deck view
-│   ├── profile/             # User profile page
-│   └── settings/            # Settings page
-└── app.css                  # Global styles
-```
-
-## Important Notes
-
-1. **Authentication**: Uses Mana Auth (JWT in Authorization header)
-2. **Database**: PostgreSQL with Drizzle ORM
-3. **Ports**: Backend=3008, Web=5178
-4. **Landing**: Deployed on Cloudflare Pages
+The previous "Presi Project Guide" referenced a NestJS backend that was
+fully replaced by the consolidated Hono routes in apps/api during the
+NestJS → Hono sweep. Deleted in the audit cleanup of 2026-04-09.
+Pre-consolidation reference is in git history.
diff --git a/apps/questions/package.json b/apps/questions/package.json
index 71bffce78..52d6adb12 100644
--- a/apps/questions/package.json
+++ b/apps/questions/package.json
@@ -2,8 +2,5 @@
 	"name": "questions",
 	"version": "0.1.0",
 	"private": true,
-	"description": "Questions app - Collect questions and research answers",
-	"scripts": {
-		"dev": "turbo run dev"
-	}
+	"description": "Questions app - Collect questions and research answers"
 }
diff --git a/apps/storage/CLAUDE.md b/apps/storage/CLAUDE.md
index 1fcc71ce1..d03b3ed0b 100644
--- a/apps/storage/CLAUDE.md
+++ b/apps/storage/CLAUDE.md
@@ -1,294 +1,25 @@
-# Storage Project Guide
+# Storage — consolidated into the unified Mana app
 
-## Project Structure
+This product was migrated into the unified Mana monorepo. The legacy
+per-product `apps/storage/apps/backend/` and `apps/storage/apps/web/`
+directories have been removed. Active code now lives in:
 
-```
-apps/storage/
-├── apps/
-│   ├── backend/      # Hono/Bun compute server (@storage/server) - Port 3016
-│   ├── landing/      # Astro marketing landing page (@storage/landing)
-│   └── web/          # SvelteKit web application (@storage/web) - Port 5185
-├── packages/
-│   └── shared/       # Shared types, utils, configs (@storage/shared)
-└── package.json
-```
+- **Backend compute routes**: [`apps/api/src/modules/storage/routes.ts`](../api/src/modules/storage/routes.ts) (S3/MinIO upload, presigned URLs, download)
+- **Frontend module** (local-first): [`apps/mana/apps/web/src/lib/modules/storage/`](../mana/apps/web/src/lib/modules/storage/)
+- **Web route**: [`apps/mana/apps/web/src/routes/(app)/storage/`](../mana/apps/web/src/routes/(app)/storage/)
 
-## Commands
+For monorepo-wide patterns (auth, sync, encryption, services), see the
+[root `CLAUDE.md`](../../CLAUDE.md) and [`apps/mana/CLAUDE.md`](../mana/CLAUDE.md).
 
-### Root Level (from monorepo root)
+The previous "Storage Project Guide" describing a per-product NestJS-style
+backend with `FilesController`, `FoldersController`, share/version logic,
+etc. was deleted in the audit cleanup of 2026-04-09 — it had been
+inaccurate since the consolidation. The current consolidated implementation
+is much smaller (uses `mana-sync` for metadata CRUD). The audio-player
+visualizer logic referenced in the old guide lives directly in the
+storage module under `apps/mana/apps/web/src/lib/modules/storage/`.
+Pre-consolidation reference is in git history.
 
-```bash
-pnpm storage:dev                   # Run all storage apps
-pnpm dev:storage:web               # Start web app
-pnpm dev:storage:landing           # Start landing page
-pnpm dev:storage:backend           # Start backend server
-pnpm dev:storage:app               # Start web + backend together
-pnpm storage:db:push               # Push schema to database
-pnpm storage:db:studio             # Open Drizzle Studio
-pnpm storage:db:seed               # Seed database
-```
-
-### Backend (apps/storage/apps/backend)
-
-```bash
-pnpm dev                         # Start with hot reload
-pnpm build                       # Build for production
-pnpm start:prod                  # Start production server
-pnpm db:push                     # Push schema to database
-pnpm db:studio                   # Open Drizzle Studio
-```
-
-### Web App (apps/storage/apps/web)
-
-```bash
-pnpm dev                         # Start dev server
-pnpm build                       # Build for production
-pnpm preview                     # Preview production build
-```
-
-### Landing Page (apps/storage/apps/landing)
-
-```bash
-pnpm dev                         # Start dev server
-pnpm build                       # Build for production
-```
-
-## Technology Stack
-
-- **Web**: SvelteKit 2.x, Svelte 5 (runes mode), Tailwind CSS
-- **Landing**: Astro 5.x, Tailwind CSS
-- **Backend**: NestJS 11, Drizzle ORM, PostgreSQL
-- **Storage**: S3-compatible (MinIO)
-- **Types**: TypeScript 5.x
-
-## Architecture
-
-### Backend API Endpoints
-
-#### Files
-
-| Endpoint                          | Method | Description                |
-| --------------------------------- | ------ | -------------------------- |
-| `/api/v1/health`                  | GET    | Health check               |
-| `/api/v1/files`                   | GET    | List files (with folderId) |
-| `/api/v1/files/:id`               | GET    | Get file details           |
-| `/api/v1/files/upload`            | POST   | Upload file (multipart)    |
-| `/api/v1/files/:id/download`      | GET    | Download file              |
-| `/api/v1/files/:id`               | PATCH  | Update file (rename)       |
-| `/api/v1/files/:id/move`          | PATCH  | Move file to folder        |
-| `/api/v1/files/:id`               | DELETE | Soft delete file           |
-| `/api/v1/files/:id/favorite`      | POST   | Toggle favorite            |
-| `/api/v1/files/:id/versions`      | GET    | List file versions         |
-| `/api/v1/files/:id/versions`      | POST   | Upload new version         |
-| `/api/v1/files/:id/tags`          | POST   | Update file tags           |
-
-#### Folders
-
-| Endpoint                          | Method | Description                |
-| --------------------------------- | ------ | -------------------------- |
-| `/api/v1/folders`                 | GET    | List root folders          |
-| `/api/v1/folders/:id`             | GET    | Get folder with contents   |
-| `/api/v1/folders/:id/tree`        | GET    | Get folder tree (sidebar)  |
-| `/api/v1/folders`                 | POST   | Create folder              |
-| `/api/v1/folders/:id`             | PATCH  | Update folder              |
-| `/api/v1/folders/:id/move`        | PATCH  | Move folder                |
-| `/api/v1/folders/:id`             | DELETE | Soft delete folder         |
-| `/api/v1/folders/:id/favorite`    | POST   | Toggle favorite            |
-
-#### Shares
-
-| Endpoint                          | Method | Description                |
-| --------------------------------- | ------ | -------------------------- |
-| `/api/v1/shares`                  | GET    | List user's shares         |
-| `/api/v1/shares`                  | POST   | Create share link          |
-| `/api/v1/shares/:id`              | PATCH  | Update share settings      |
-| `/api/v1/shares/:id`              | DELETE | Revoke share               |
-| `/api/v1/public/shares/:token`    | GET    | Access shared item (public)|
-| `/api/v1/public/shares/:token/download` | GET | Download shared file   |
-
-#### Tags
-
-| Endpoint                          | Method | Description                |
-| --------------------------------- | ------ | -------------------------- |
-| `/api/v1/tags`                    | GET    | List user's tags           |
-| `/api/v1/tags`                    | POST   | Create tag                 |
-| `/api/v1/tags/:id`                | PATCH  | Update tag                 |
-| `/api/v1/tags/:id`                | DELETE | Delete tag                 |
-
-#### Trash
-
-| Endpoint                          | Method | Description                |
-| --------------------------------- | ------ | -------------------------- |
-| `/api/v1/trash`                   | GET    | List trash items           |
-| `/api/v1/trash/:id/restore`       | POST   | Restore item               |
-| `/api/v1/trash/:id`               | DELETE | Permanently delete         |
-| `/api/v1/trash`                   | DELETE | Empty trash                |
-
-#### Search & Favorites
-
-| Endpoint                          | Method | Description                |
-| --------------------------------- | ------ | -------------------------- |
-| `/api/v1/search?q=...`            | GET    | Search files & folders     |
-| `/api/v1/favorites`               | GET    | List favorites             |
-
-### Database Schema
-
-**files** - File metadata
-
-- `id` (UUID) - Primary key
-- `user_id` (VARCHAR) - User reference
-- `name` (VARCHAR) - Display name
-- `original_name` (VARCHAR) - Original filename
-- `mime_type` (VARCHAR) - MIME type
-- `size` (BIGINT) - File size in bytes
-- `storage_path` (VARCHAR) - Full S3 path
-- `storage_key` (VARCHAR) - S3 object key (unique)
-- `parent_folder_id` (UUID) - Parent folder reference
-- `current_version` (INTEGER) - Current version number
-- `is_favorite` (BOOLEAN) - Favorite flag
-- `is_deleted` (BOOLEAN) - Soft delete flag
-- `deleted_at` (TIMESTAMP) - Deletion timestamp
-- `created_at`, `updated_at` (TIMESTAMP)
-
-**folders** - Folder hierarchy
-
-- `id` (UUID) - Primary key
-- `user_id` (VARCHAR) - User reference
-- `name` (VARCHAR) - Folder name
-- `description` (TEXT) - Optional description
-- `parent_folder_id` (UUID) - Self-reference for hierarchy
-- `path` (TEXT) - Materialized path (e.g., /root/subfolder)
-- `depth` (INTEGER) - Depth in hierarchy
-- `is_favorite` (BOOLEAN) - Favorite flag
-- `is_deleted` (BOOLEAN) - Soft delete flag
-- `deleted_at` (TIMESTAMP) - Deletion timestamp
-- `created_at`, `updated_at` (TIMESTAMP)
-
-**file_versions** - Version history
-
-- `id` (UUID) - Primary key
-- `file_id` (UUID) - File reference
-- `version_number` (INTEGER) - Version number
-- `storage_path` (VARCHAR) - S3 path for this version
-- `storage_key` (VARCHAR) - S3 key for this version
-- `size` (BIGINT) - Version size
-- `comment` (TEXT) - Version comment
-- `created_by` (VARCHAR) - User who created version
-- `created_at` (TIMESTAMP)
-
-**shares** - Sharing links
-
-- `id` (UUID) - Primary key
-- `user_id` (VARCHAR) - Owner reference
-- `file_id` (UUID) - Shared file (nullable)
-- `folder_id` (UUID) - Shared folder (nullable)
-- `share_type` (VARCHAR) - 'file' or 'folder'
-- `share_token` (VARCHAR) - Unique public token
-- `access_level` (VARCHAR) - 'view', 'edit', 'download'
-- `password` (VARCHAR) - Optional password hash
-- `max_downloads` (INTEGER) - Download limit
-- `download_count` (INTEGER) - Current downloads
-- `expires_at` (TIMESTAMP) - Expiration date
-- `created_at` (TIMESTAMP)
-
-**tags** - User tags
-
-- `id` (UUID) - Primary key
-- `user_id` (VARCHAR) - User reference
-- `name` (VARCHAR) - Tag name
-- `color` (VARCHAR) - Tag color
-- `created_at` (TIMESTAMP)
-
-**file_tags** - Many-to-many relation
-
-- `file_id` (UUID) - File reference
-- `tag_id` (UUID) - Tag reference
-
-### Environment Variables
-
-#### Backend (.env)
-
-```
-NODE_ENV=development
-PORT=3016
-DATABASE_URL=postgresql://mana:devpassword@localhost:5432/storage
-MANA_AUTH_URL=http://localhost:3001
-CORS_ORIGINS=http://localhost:5173,http://localhost:5185,http://localhost:8081
-S3_ENDPOINT=http://localhost:9000
-S3_REGION=us-east-1
-S3_ACCESS_KEY=minioadmin
-S3_SECRET_KEY=minioadmin
-STORAGE_S3_PUBLIC_URL=http://localhost:9000/storage-storage
-MAX_FILE_SIZE=104857600
-MAX_FILES_PER_UPLOAD=10
-```
-
-#### Web (.env)
-
-```
-PUBLIC_BACKEND_URL=http://localhost:3016
-PUBLIC_MANA_AUTH_URL=http://localhost:3001
-```
-
-## Shared Packages
-
-### @storage/shared
-
-- Types: `File`, `Folder`, `FileVersion`, `Share`, `Tag`
-- Utils: File type detection, size formatting, path utilities
-
-## File Preview System
-
-The FilePreviewModal supports rich inline previews for various file types:
-
-| File Type | MIME / Extension | Preview |
-|-----------|-----------------|---------|
-| **Images** | `image/*` | Native `<img>` via download URL |
-| **Audio** | `audio/*` | Play button → global MiniPlayer/FullPlayer with frequency visualizer, queue from folder |
-| **Video** | `video/*` | Native `<video>` player with controls via presigned S3 URL |
-| **PDF** | `application/pdf` | Embedded browser PDF viewer via `<iframe>` |
-| **Text/Code** | `text/*`, `.json`, `.js`, `.ts`, `.xml`, `.yaml` | Fetched content in monospace code view (max 50KB) |
-| **Markdown** | `.md` | Rendered HTML with headings, lists, code blocks, links |
-| **Other** | everything else | File type icon only |
-
-### Audio Player Architecture
-
-```
-audioPlayerStore (Svelte 5 runes)
-    ↓
-HTMLAudioElement → Presigned S3 URL
-    ↓
-Web Audio API (AnalyserNode)
-    ↓
-FrequencyBars (Canvas visualizer)
-```
-
-**Key files:**
-
-| File | Purpose |
-|------|---------|
-| `src/lib/stores/audio-player.svelte.ts` | Player state, queue, play/pause/seek/volume |
-| `src/lib/audio/analyzer.ts` | Web Audio API singleton for frequency data |
-| `src/lib/components/audio/FrequencyBars.svelte` | Canvas frequency bar visualizer |
-| `src/lib/components/audio/MiniPlayer.svelte` | Fixed bottom player bar with visualizer |
-| `src/lib/components/audio/FullPlayer.svelte` | Fullscreen player with mirrored visualizer background |
-
-**Features:** Queue from audio files in folder, Media Session API (OS controls), presigned S3 URLs, keyboard shortcuts (Space, Escape, Arrow keys in FullPlayer).
-
-## Code Style Guidelines
-
-- **TypeScript**: Strict typing with interfaces
-- **Web**: Svelte 5 runes mode (`$state`, `$derived`, `$effect`)
-- **Styling**: Tailwind CSS
-- **Formatting**: Prettier with project config
-
-## Important Notes
-
-1. **Authentication**: Uses Mana Auth (JWT in Authorization header)
-2. **Database**: PostgreSQL with Drizzle ORM
-3. **Port**: Backend runs on port 3016, Web on port 5185 by default
-4. **Storage**: Uses MinIO/S3 for file storage via @mana/shared-storage
-5. **Bucket**: `storage-storage` bucket for all files
-6. **Soft Delete**: Files/folders are soft-deleted first (trash), then permanently deleted
-7. **Versioning**: Files support version history, each version stored separately in S3
-8. **Sharing**: Public links with optional password, download limits, and expiration
+> **Note:** The orphaned `apps/storage/packages/shared/` package and the
+> `dev: turbo run dev` recursive script in `apps/storage/package.json`
+> were addressed in audit items #2 and #18/#29.
diff --git a/apps/storage/package.json b/apps/storage/package.json
index e31a2b35a..1c40d4a21 100644
--- a/apps/storage/package.json
+++ b/apps/storage/package.json
@@ -2,8 +2,5 @@
 	"name": "storage",
 	"version": "0.2.0",
 	"private": true,
-	"description": "Cloud storage application (like Google Drive/Dropbox)",
-	"scripts": {
-		"dev": "turbo run dev"
-	}
+	"description": "Cloud storage application (like Google Drive/Dropbox)"
 }
diff --git a/apps/todo/CLAUDE.md b/apps/todo/CLAUDE.md
index 3a34d402d..740bcf1f1 100644
--- a/apps/todo/CLAUDE.md
+++ b/apps/todo/CLAUDE.md
@@ -1,330 +1,20 @@
-# Todo Project Guide
-
-## Overview
-
-**Todo** is a full-featured task management application for the Mana ecosystem. It supports projects, tasks with subtasks, labels, recurring tasks, reminders, and calendar integration.
-
-| App | Port | URL |
-|-----|------|-----|
-| Backend | 3018 | http://localhost:3018 |
-| Web App | 5188 | http://localhost:5188 |
-| Landing Page | 4323 | http://localhost:4323 |
-
-## Project Structure
-
-```
-apps/todo/
-├── apps/
-│   ├── backend/      # Hono/Bun compute server (@todo/server)
-│   ├── web/          # SvelteKit web application (@todo/web)
-│   └── landing/      # Astro marketing landing page (@todo/landing)
-├── packages/
-│   └── shared/       # Shared types, utils, constants (@todo/shared)
-├── package.json
-└── CLAUDE.md
-```
-
-## Commands
-
-### Root Level (from monorepo root)
-
-```bash
-# All apps
-pnpm todo:dev                 # Run all todo apps
-
-# Individual apps
-pnpm dev:todo:backend         # Start backend server (port 3018)
-pnpm dev:todo:web             # Start web app (port 5188)
-pnpm dev:todo:landing         # Start landing page (port 4323)
-pnpm dev:todo:app             # Start web + backend together
-
-# Database
-pnpm todo:db:push             # Push schema to database
-pnpm todo:db:studio           # Open Drizzle Studio
-pnpm todo:db:seed             # Seed initial data
-```
-
-### Backend (apps/todo/apps/backend)
-
-```bash
-pnpm dev                         # Start with hot reload
-pnpm build                       # Build for production
-pnpm start:prod                  # Start production server
-pnpm db:push                     # Push schema to database
-pnpm db:studio                   # Open Drizzle Studio
-pnpm db:seed                     # Seed initial data
-```
-
-### Web App (apps/todo/apps/web)
-
-```bash
-pnpm dev                         # Start dev server
-pnpm build                       # Build for production
-pnpm preview                     # Preview production build
-```
-
-### Landing Page (apps/todo/apps/landing)
-
-```bash
-pnpm dev                         # Start dev server (port 4323)
-pnpm build                       # Build for production
-pnpm preview                     # Preview build
-```
-
-## Technology Stack
-
-| Layer | Technology |
-|-------|------------|
-| **Backend** | Hono + Bun, Drizzle ORM, PostgreSQL |
-| **Web** | SvelteKit 2.x, Svelte 5 (runes mode), Tailwind CSS 4 |
-| **Landing** | Astro 5.x, Tailwind CSS |
-| **Auth** | Mana Auth (JWT) |
-| **i18n** | svelte-i18n (DE, EN) |
-| **Dates** | date-fns |
-
-## Core Features
-
-1. **Projects** - Organize tasks into color-coded projects
-2. **Tasks** - Full CRUD with priority, due dates, and status
-3. **Subtasks** - Checklist items within tasks
-4. **Labels** - Tag tasks with colored labels
-5. **Recurring Tasks** - Daily, weekly, monthly (RFC 5545 RRULE)
-6. **Reminders** - Push and email notifications
-7. **Calendar Integration** - Sync tasks with Calendar app
-8. **Quick Add** - Natural language task creation
-
-## Views
-
-| View | Route | Description |
-|------|-------|-------------|
-| **Inbox** | `/` (default) | Tasks without a project |
-| **Today** | `/today` | Due today + overdue |
-| **Upcoming** | `/upcoming` | Next 7 days, grouped by date |
-| **Project** | `/project/[id]` | Tasks in specific project |
-| **Label** | `/label/[id]` | Tasks with specific label |
-| **Completed** | `/completed` | Completed tasks archive |
-| **Search** | `/search` | Full-text search |
-
-## API Endpoints
-
-### Projects
-
-| Endpoint | Method | Description |
-|----------|--------|-------------|
-| `/api/v1/projects` | GET | List user's projects |
-| `/api/v1/projects` | POST | Create project |
-| `/api/v1/projects/:id` | GET | Get project details |
-| `/api/v1/projects/:id` | PUT | Update project |
-| `/api/v1/projects/:id` | DELETE | Delete project |
-| `/api/v1/projects/:id/archive` | POST | Archive project |
-| `/api/v1/projects/reorder` | PUT | Reorder projects |
-
-### Tasks
-
-| Endpoint | Method | Description |
-|----------|--------|-------------|
-| `/api/v1/tasks` | GET | Query tasks (filters) |
-| `/api/v1/tasks` | POST | Create task |
-| `/api/v1/tasks/:id` | GET | Get task details |
-| `/api/v1/tasks/:id` | PUT | Update task |
-| `/api/v1/tasks/:id` | DELETE | Delete task |
-| `/api/v1/tasks/:id/complete` | POST | Mark complete |
-| `/api/v1/tasks/:id/uncomplete` | POST | Mark incomplete |
-| `/api/v1/tasks/:id/move` | POST | Move to project |
-| `/api/v1/tasks/:id/labels` | PUT | Update labels |
-| `/api/v1/tasks/inbox` | GET | Inbox tasks |
-| `/api/v1/tasks/today` | GET | Today's tasks |
-| `/api/v1/tasks/upcoming` | GET | Upcoming tasks |
-| `/api/v1/tasks/reorder` | PUT | Reorder tasks |
-
-### Labels
-
-| Endpoint | Method | Description |
-|----------|--------|-------------|
-| `/api/v1/labels` | GET | List labels |
-| `/api/v1/labels` | POST | Create label |
-| `/api/v1/labels/:id` | PUT | Update label |
-| `/api/v1/labels/:id` | DELETE | Delete label |
-
-### Reminders
-
-| Endpoint | Method | Description |
-|----------|--------|-------------|
-| `/api/v1/tasks/:taskId/reminders` | GET | List reminders |
-| `/api/v1/tasks/:taskId/reminders` | POST | Add reminder |
-| `/api/v1/reminders/:id` | DELETE | Delete reminder |
-
-## Database Schema
-
-> **Note**: `user_id` columns use TEXT type (not UUID) because Mana Auth generates non-UUID user IDs.
-
-### projects
-- `id` (UUID) - Primary key
-- `user_id` (TEXT) - Owner (Better Auth format)
-- `name` (VARCHAR) - Project name
-- `color` (VARCHAR) - Hex color
-- `icon` (VARCHAR) - Icon name
-- `order` (INTEGER) - Sort order
-- `is_archived` (BOOLEAN) - Archive flag
-- `is_default` (BOOLEAN) - Inbox project
-
-### tasks
-- `id` (UUID) - Primary key
-- `project_id` (UUID) - FK to projects (nullable = Inbox)
-- `user_id` (TEXT) - Owner (Better Auth format)
-- `title` (VARCHAR) - Task title
-- `description` (TEXT) - Description
-- `due_date` (TIMESTAMP) - Due date
-- `priority` (VARCHAR) - low/medium/high/urgent
-- `is_completed` (BOOLEAN) - Completion flag
-- `order` (INTEGER) - Sort order
-- `recurrence_rule` (VARCHAR) - RFC 5545 RRULE
-- `subtasks` (JSONB) - Subtask array
-- `metadata` (JSONB) - Extra data
-
-### labels
-- `id` (UUID) - Primary key
-- `user_id` (TEXT) - Owner (Better Auth format)
-- `name` (VARCHAR) - Label name
-- `color` (VARCHAR) - Hex color
-
-### task_labels
-- `task_id` (UUID) - FK to tasks
-- `label_id` (UUID) - FK to labels
-
-### reminders
-- `id` (UUID) - Primary key
-- `task_id` (UUID) - FK to tasks
-- `user_id` (TEXT) - Owner (Better Auth format)
-- `minutes_before` (INTEGER) - Offset
-- `type` (VARCHAR) - push/email/both
-- `status` (VARCHAR) - pending/sent/failed
-
-## Environment Variables
-
-### Backend (.env)
-
-```env
-NODE_ENV=development
-PORT=3018
-DATABASE_URL=postgresql://mana:devpassword@localhost:5432/todo
-MANA_AUTH_URL=http://localhost:3001
-CORS_ORIGINS=http://localhost:5173,http://localhost:5186,http://localhost:8081
-```
-
-### Web (.env)
-
-```env
-PUBLIC_BACKEND_URL=http://localhost:3018
-PUBLIC_MANA_AUTH_URL=http://localhost:3001
-```
-
-## Quick Add Syntax
-
-Natural language task creation:
-
-```
-"Meeting morgen um 14 Uhr !hoch @Arbeit #wichtig"
-```
-
-Recognized patterns:
-- **Date**: heute, morgen, nächsten Montag, 15.12.
-- **Time**: um 14 Uhr, 14:00
-- **Priority**: !hoch, !niedrig, !dringend, !!!
-- **Project**: @Projektname
-- **Labels**: #label1 #label2
-- **Recurrence**: jeden Tag, wöchentlich, monatlich
-- **Duration**: 30min, 2h, 1.5 Stunden (maps to `estimatedDuration`)
-
-### Multi-Task Input
-
-Split multiple tasks with keywords (`danach`, `dann`, `und dann`, `anschließend`, `außerdem`) or semicolons:
-
-```
-"Morgen um 10 Zahnarzt 1h, danach Einkaufen"
-→ Task 1: Zahnarzt (morgen 10:00, 1h)
-→ Task 2: Einkaufen (morgen 11:00, auto-offset)
-
-"Meeting 14 Uhr 1h @Arbeit; Report schreiben; Mails"
-→ 3 tasks, all inherit date + project from first task
-```
-
-Context inheritance: subsequent tasks inherit date, time, and project from the first task. If the first task has a duration, the next task's time is offset accordingly.
-
-### Smart Duration (Auto-Estimation)
-
-Duration is **automatically applied** to new tasks when no explicit duration is typed. The system uses history-based estimation (weighted by project, labels, title similarity, priority) with a configurable default as fallback. Controllable via Settings > Task-Verhalten:
-
-- **Smarte Dauer** toggle (`smartDurationEnabled`, default: on)
-- **Standard-Dauer** fallback (`defaultTaskDuration`, default: 30min)
-
-Priority: explicit duration in text > history estimate > default fallback > none (if disabled).
-
-## Code Style Guidelines
-
-- **TypeScript**: Strict typing with interfaces
-- **Web**: Svelte 5 runes mode (`$state`, `$derived`, `$effect`)
-- **Styling**: Tailwind CSS with CSS variables
-- **Formatting**: Prettier with project config
-- **i18n**: All UI text in locale files
-
-## Production Readiness
-
-**Status: Production-Ready (2026-03-24)**
-
-### Checklist
-
-| Category | Status | Details |
-|----------|--------|---------|
-| **Error Handling** | ✅ | Global `+error.svelte` with i18n (5 languages), error tracking via GlitchTip |
-| **Offline Support** | ✅ | Offline page with shared `OfflinePage` component |
-| **PWA** | ✅ | Service worker, manifest, icons, shortcuts (New task, Kanban, Settings) |
-| **Security Headers** | ✅ | CSP, X-Frame-Options via `setSecurityHeaders()` |
-| **Loading States** | ✅ | Skeleton loaders: TaskList, TaskItem, KanbanBoard, KanbanColumn, Statistics |
-| **i18n** | ✅ | 5 languages (DE/EN/FR/ES/IT) via svelte-i18n |
-| **Meta/SEO** | ✅ | OG tags, meta description in root layout |
-| **Accessibility** | ✅ | Focus trapping in all modals, ARIA roles, keyboard shortcuts |
-| **Rate Limiting** | ✅ | ThrottlerGuard global (100 req/min) |
-| **API Validation** | ✅ | DTOs with class-validator, RRULE DoS protection (max 5000 occurrences) |
-| **Auth** | ✅ | JWT via mana-auth, client-side redirect in `onMount` |
-| **Toast System** | ✅ | Toast notifications via shared `toastStore` |
-| **Docker** | ✅ | Multi-stage build (web + backend), health checks, Traefik labels |
-| **Tests** | ✅ | Unit tests (7 backend, 3 web), E2E tests (3 suites: auth, projects, tasks) |
-| **Error Tracking** | ✅ | GlitchTip integration (client + server) |
-| **Metrics** | ✅ | Prometheus via MetricsModule |
-| **Context Menu** | ✅ | Shared ContextMenu on TaskList (priority, project, complete, delete) |
-| **Auto-Save** | ✅ | 500ms debounce, no save/cancel buttons needed |
-| **Drag & Drop** | ✅ | Task reordering in list + kanban views |
-
-### Test Suites
-
-```bash
-# Unit tests
-pnpm --filter @todo/server test
-pnpm --filter @todo/web test
-
-# E2E tests
-pnpm --filter @todo/web test:e2e
-```
-
-| Type | Suite | Coverage |
-|------|-------|----------|
-| Unit (Backend) | `task.service.spec.ts` | Task CRUD, recurrence |
-| Unit (Backend) | `project.service.spec.ts` | Project management |
-| Unit (Backend) | `kanban.service.spec.ts` | Kanban operations |
-| Unit (Backend) | `reminder.service.spec.ts` | Reminders |
-| Unit (Backend) | `label.service.spec.ts` | Labels |
-| Unit (Web) | `task-parser.test.ts` | Natural language parsing |
-| Unit (Web) | `task-filters.test.ts` | Filter logic |
-| Unit (Web) | `view.test.ts` | View store state |
-| E2E | `auth.spec.ts` | Login, redirect |
-| E2E | `projects.spec.ts` | Project CRUD |
-| E2E | `tasks.spec.ts` | Task CRUD |
-
-## Important Notes
-
-1. **Authentication**: Uses Mana Auth (JWT in Authorization header)
-2. **Database**: PostgreSQL with Drizzle ORM (port 5432)
-3. **Ports**: Backend=3018, Web=5188, Landing=4323
-4. **Recurrence**: Uses RFC 5545 RRULE format
-5. **Calendar**: Tasks can sync bidirectionally with Calendar app
+# Todo — consolidated into the unified Mana app
+
+This product was migrated into the unified Mana monorepo. The legacy
+per-product `apps/todo/apps/backend/` and `apps/todo/apps/web/` directories
+have been removed. Active code now lives in:
+
+- **Backend compute routes**: [`apps/api/src/modules/todo/routes.ts`](../api/src/modules/todo/routes.ts)
+- **Frontend module** (local-first): [`apps/mana/apps/web/src/lib/modules/todo/`](../mana/apps/web/src/lib/modules/todo/)
+- **Web route**: [`apps/mana/apps/web/src/routes/(app)/todo/`](../mana/apps/web/src/routes/(app)/todo/)
+- **Landing page** (still standalone): [`apps/todo/apps/landing/`](apps/landing/)
+
+For monorepo-wide patterns (auth, sync, encryption, services), see the
+[root `CLAUDE.md`](../../CLAUDE.md) and [`apps/mana/CLAUDE.md`](../mana/CLAUDE.md).
+
+The previous standalone "Todo Project Guide" describing a per-product
+backend with its own DB and reminder worker was deleted in the audit
+cleanup of 2026-04-09 — it had been inaccurate since the consolidation.
+The reminder worker logic referenced there was migrated to apps/api or
+the relevant background-job home; check git history if you need the
+original reference.
diff --git a/apps/traces/CLAUDE.md b/apps/traces/CLAUDE.md
index 64b6a7493..5b025f9f9 100644
--- a/apps/traces/CLAUDE.md
+++ b/apps/traces/CLAUDE.md
@@ -1,76 +1,18 @@
-# CLAUDE.md - Traces
+# Traces — consolidated into the unified Mana app
 
-GPS tracking app with AI city guides. Location tracking runs locally via AsyncStorage, with optional backend sync.
+This product was migrated into the unified Mana monorepo. The legacy
+per-product `apps/traces/apps/server/` directory has been removed.
+Active code now lives in:
 
-## Project Structure
+- **Backend compute routes**: [`apps/api/src/modules/traces/routes.ts`](../api/src/modules/traces/routes.ts) (location sync, AI city-guide pipeline, GPS-to-city detection)
+- **Frontend module** (local-first): [`apps/mana/apps/web/src/lib/modules/traces/`](../mana/apps/web/src/lib/modules/traces/)
+- **Web route**: [`apps/mana/apps/web/src/routes/(app)/traces/`](../mana/apps/web/src/routes/(app)/traces/)
+- **Mobile app**: [`apps/traces/apps/mobile/`](apps/mobile/) (GPS tracking remains a native concern)
 
-```
-apps/traces/
-├── package.json              # Orchestrator (name: traces)
-├── apps/
-│   ├── backend/              # @traces/server (NestJS, Port 3026)
-│   │   └── src/
-│   │       ├── main.ts
-│   │       ├── app.module.ts
-│   │       ├── db/           # Drizzle schema + connection
-│   │       ├── location/     # GPS sync endpoint
-│   │       ├── city/         # City CRUD + visit stats
-│   │       ├── place/        # Saved places CRUD
-│   │       ├── poi/          # Points of Interest
-│   │       └── guide/        # AI city guide pipeline
-│   └── mobile/               # @traces/mobile (Expo SDK 54)
-│       ├── app/              # Expo Router screens
-│       ├── components/       # UI components
-│       └── utils/            # Services (location, sync, api)
-└── packages/
-    └── traces-types/         # @traces/types (shared interfaces)
-```
+For monorepo-wide patterns (auth, sync, encryption, services), see the
+[root `CLAUDE.md`](../../CLAUDE.md) and [`apps/mana/CLAUDE.md`](../mana/CLAUDE.md).
 
-## Commands
-
-```bash
-# Development
-pnpm dev:traces:mobile        # Start Expo app
-pnpm dev:traces:server       # Start NestJS backend
-pnpm dev:traces:full          # Start auth + backend + mobile
-
-# Database
-pnpm traces:db:push           # Push Drizzle schema
-pnpm traces:db:studio         # Open Drizzle Studio
-```
-
-## Architecture
-
-- **Mobile**: Offline-first. All GPS data in AsyncStorage. Sync is additive.
-- **Backend**: NestJS + Drizzle ORM + PostgreSQL. Auth via ManaModule.
-- **AI Guides**: Uses mana-search for POI discovery, mana-llm for narratives.
-- **Credits**: 5 base + 2 per POI consumed via CreditClientService.
-
-## API Endpoints
-
-| Endpoint | Method | Description |
-|----------|--------|-------------|
-| `/api/v1/locations/sync` | POST | Batch sync from mobile |
-| `/api/v1/locations` | GET | Query locations |
-| `/api/v1/cities` | GET | User's visited cities |
-| `/api/v1/cities/:id` | GET | City detail + stats |
-| `/api/v1/places` | GET/POST | List/create places |
-| `/api/v1/places/:id` | PUT/DELETE | Update/delete place |
-| `/api/v1/pois` | GET | Nearby POIs |
-| `/api/v1/pois/:id` | GET | POI detail |
-| `/api/v1/guides/generate` | POST | Generate AI guide |
-| `/api/v1/guides` | GET | User's guides |
-| `/api/v1/guides/:id` | GET/DELETE | Guide detail/delete |
-
-## Environment Variables
-
-Backend: `PORT=3026`, `DATABASE_URL`, `MANA_AUTH_URL`, `MANA_LLM_URL`, `MANA_SEARCH_URL`
-Mobile: `EXPO_PUBLIC_TRACES_BACKEND_URL`, `EXPO_PUBLIC_MANA_AUTH_URL`
-
-## Mobile Navigation (5 tabs)
-
-1. **Tracking** - Live GPS tracking + map
-2. **Orte** - Saved places, cities, countries
-3. **Karte** - Full-screen map view
-4. **Städte** - Visited cities with stats
-5. **Führungen** - AI-generated city guides
+The previous standalone "Traces" guide was deleted in the audit cleanup
+of 2026-04-09 — it had been inaccurate since the consolidation. The
+mobile-side AsyncStorage GPS pipeline still lives under `apps/traces/apps/mobile/`.
+Pre-consolidation backend reference is in git history.
diff --git a/apps/uload/package.json b/apps/uload/package.json
index a59b400a1..7605e89f1 100644
--- a/apps/uload/package.json
+++ b/apps/uload/package.json
@@ -1,8 +1,5 @@
 {
 	"name": "@mana/uload",
 	"version": "0.0.1",
-	"private": true,
-	"scripts": {
-		"dev": "turbo run dev"
-	}
+	"private": true
 }
diff --git a/docker-compose.macmini.yml b/docker-compose.macmini.yml
index ed2ae3d0f..ba11fb23c 100644
--- a/docker-compose.macmini.yml
+++ b/docker-compose.macmini.yml
@@ -275,7 +275,12 @@ services:
       MANA_AUTH_KEK: ${MANA_AUTH_KEK}
       MANA_NOTIFY_URL: http://mana-notify:3013
       MAX_DAILY_SIGNUPS: ${MAX_DAILY_SIGNUPS:-0}
-      CORS_ORIGINS: https://mana.how,https://calendar.mana.how,https://chat.mana.how,https://clock.mana.how,https://contacts.mana.how,https://context.mana.how,https://docs.mana.how,https://inventar.mana.how,https://cards.mana.how,https://music.mana.how,https://nutriphi.mana.how,https://photos.mana.how,https://picture.mana.how,https://planta.mana.how,https://playground.mana.how,https://presi.mana.how,https://questions.mana.how,https://skilltree.mana.how,https://storage.mana.how,https://times.mana.how,https://todo.mana.how,https://traces.mana.how,https://zitare.mana.how
+      # Must be a superset of TRUSTED_ORIGINS in
+      # services/mana-auth/src/auth/better-auth.config.ts.
+      # Enforced by services/mana-auth/src/auth/sso-config.spec.ts.
+      # All productivity modules now live under mana.how (path-based) —
+      # no per-module subdomain entries required here.
+      CORS_ORIGINS: https://mana.how,https://auth.mana.how,https://arcade.mana.how,https://whopxl.mana.how
     ports:
       - "3001:3001"
     healthcheck:
diff --git a/games/arcade/package.json b/games/arcade/package.json
index f105f8ea6..a90884021 100644
--- a/games/arcade/package.json
+++ b/games/arcade/package.json
@@ -2,8 +2,5 @@
 	"name": "arcade",
 	"version": "1.0.0",
 	"private": true,
-	"description": "AI-powered browser games platform",
-	"scripts": {
-		"dev": "turbo run dev"
-	}
+	"description": "AI-powered browser games platform"
 }
diff --git a/packages/shared-hono/src/error.ts b/packages/shared-hono/src/error.ts
index f0950fe96..8de897197 100644
--- a/packages/shared-hono/src/error.ts
+++ b/packages/shared-hono/src/error.ts
@@ -4,8 +4,9 @@
  * Catches unhandled errors and returns consistent JSON responses.
  */
 
-import type { Context } from 'hono';
+import type { Context, ErrorHandler } from 'hono';
 import { HTTPException } from 'hono/http-exception';
+import { logger } from '@mana/shared-logger';
 
 /**
  * Global error handler — register with `app.onError(errorHandler)`.
@@ -28,7 +29,12 @@ export function errorHandler(err: Error, c: Context) {
 		);
 	}
 
-	console.error('[error]', err);
+	logger.error('unhandled', {
+		path: c.req.path,
+		method: c.req.method,
+		message: err.message,
+		stack: err.stack,
+	});
 
 	return c.json(
 		{
@@ -45,3 +51,53 @@ export function errorHandler(err: Error, c: Context) {
 export function notFoundHandler(c: Context) {
 	return c.json({ error: 'Not found', status: 404 }, 404);
 }
+
+/**
+ * Service-style error handler — returns the legacy `{ statusCode, message }`
+ * envelope used by `services/mana-{credits,user,analytics,subscriptions,
+ * auth,events}`. Distinct from the `{ error, status }` shape returned by
+ * `errorHandler` above (used by `apps/api`).
+ *
+ * Replaces 5 byte-identical copies of `src/middleware/error-handler.ts`
+ * across services. Wire-compatible with their existing clients —
+ * including the `details` field that gets populated from
+ * `HTTPException.cause`.
+ *
+ * Usage:
+ * ```ts
+ * import { serviceErrorHandler } from '@mana/shared-hono';
+ * const app = new Hono();
+ * app.onError(serviceErrorHandler);
+ * ```
+ *
+ * Logs unhandled errors via `@mana/shared-logger` so structured JSON
+ * lines land in the production log sink instead of `console.error`.
+ */
+export const serviceErrorHandler: ErrorHandler = (err, c) => {
+	if (err instanceof HTTPException) {
+		const cause = err.cause as Record<string, unknown> | undefined;
+		return c.json(
+			{
+				statusCode: err.status,
+				message: err.message,
+				...(cause ? { details: cause } : {}),
+			},
+			err.status
+		);
+	}
+
+	logger.error('unhandled', {
+		path: c.req.path,
+		method: c.req.method,
+		message: err.message,
+		stack: err.stack,
+	});
+
+	return c.json(
+		{
+			statusCode: 500,
+			message: 'Internal server error',
+		},
+		500
+	);
+};
diff --git a/packages/shared-hono/src/index.ts b/packages/shared-hono/src/index.ts
index 07b9a53b2..fda2d4558 100644
--- a/packages/shared-hono/src/index.ts
+++ b/packages/shared-hono/src/index.ts
@@ -37,9 +37,10 @@ export { createDb } from './db';
 export type { DbOptions } from './db';
 export { healthRoute } from './health';
 export { adminRoutes } from './admin';
-export { errorHandler, notFoundHandler } from './error';
+export { errorHandler, notFoundHandler, serviceErrorHandler } from './error';
 export { getBalance, validateCredits, consumeCredits, refundCredits } from './credits';
 export type { CreditBalance, CreditValidationResult } from './credits';
 export { rateLimitMiddleware } from './rate-limit';
 export { requestLogger, initLogger } from './logger';
+export { logger } from '@mana/shared-logger';
 export type { CurrentUserData, AuthVariables } from './types';
diff --git a/packages/shared-tailwind/package.json b/packages/shared-tailwind/package.json
index 9205b2311..ef45ddb1c 100644
--- a/packages/shared-tailwind/package.json
+++ b/packages/shared-tailwind/package.json
@@ -3,15 +3,8 @@
 	"version": "1.0.0",
 	"private": true,
 	"type": "module",
-	"main": "./src/index.js",
 	"exports": {
-		".": "./src/index.js",
-		"./preset": "./src/preset.js",
-		"./colors": "./src/colors.js",
-		"./theme.css": "./src/theme-variables.css",
-		"./themes.css": "./src/themes.css",
-		"./components.css": "./src/components.css",
-		"./v4": "./src/tailwind-v4.css"
+		"./themes.css": "./src/themes.css"
 	},
 	"scripts": {
 		"lint": "eslint ."
diff --git a/packages/shared-tailwind/src/colors.js b/packages/shared-tailwind/src/colors.js
deleted file mode 100644
index 6e56dc54d..000000000
--- a/packages/shared-tailwind/src/colors.js
+++ /dev/null
@@ -1,243 +0,0 @@
-/**
- * Shared color palette for all Mana apps
- *
- * Theme structure:
- * - Each theme has light and dark variants
- * - Semantic color tokens for consistent UI
- */
-
-export const colors = {
-	// Brand color used across subscription/pricing
-	mana: '#4287f5',
-
-	// App-specific primary colors
-	brand: {
-		memoro: '#f8d62b', // Gold
-		mana: '#6366f1', // Indigo
-		cards: '#6366f1', // Indigo
-		storyteller: '#6366f1', // Indigo
-	},
-
-	// Primary color scale (for general use)
-	primary: {
-		50: '#eff6ff',
-		100: '#dbeafe',
-		200: '#bfdbfe',
-		300: '#93c5fd',
-		400: '#60a5fa',
-		500: '#3b82f6',
-		600: '#2563eb',
-		700: '#1d4ed8',
-		800: '#1e40af',
-		900: '#1e3a8a',
-		950: '#172554',
-	},
-
-	// Lume Theme - Modern Gold & Dark
-	lume: {
-		light: {
-			primary: '#f8d62b',
-			primaryButton: '#f8d62b',
-			primaryButtonText: '#000000',
-			secondary: '#D4B200',
-			secondaryButton: '#FFE9A3',
-			contentBackground: '#ffffff',
-			contentBackgroundHover: '#f5f5f5',
-			contentPageBackground: '#ffffff',
-			menuBackground: '#dddddd',
-			menuBackgroundHover: '#cccccc',
-			pageBackground: '#dddddd',
-			text: '#2c2c2c',
-			textSecondary: '#666666',
-			borderLight: '#f2f2f2',
-			border: '#e6e6e6',
-			borderStrong: '#cccccc',
-			error: '#e74c3c',
-			success: '#27ae60',
-			warning: '#f39c12',
-		},
-		dark: {
-			primary: '#f8d62b',
-			primaryButton: '#7C6B16',
-			primaryButtonText: '#ffffff',
-			secondary: '#D4B200',
-			secondaryButton: '#1E1E1E',
-			contentBackground: '#1E1E1E',
-			contentBackgroundHover: '#333333',
-			contentPageBackground: '#121212',
-			menuBackground: '#101010',
-			menuBackgroundHover: '#333333',
-			pageBackground: '#101010',
-			text: '#ffffff',
-			textSecondary: '#a0a0a0',
-			borderLight: '#333333',
-			border: '#424242',
-			borderStrong: '#616161',
-			error: '#e74c3c',
-			success: '#2ecc71',
-			warning: '#f1c40f',
-		},
-	},
-
-	// Nature Theme - Soothing Green
-	nature: {
-		light: {
-			primary: '#4CAF50',
-			primaryButton: '#A08500',
-			primaryButtonText: '#ffffff',
-			secondary: '#81C784',
-			secondaryButton: '#F1F8E9',
-			contentBackground: '#F1F8E9',
-			contentBackgroundHover: '#E8F5E9',
-			contentPageBackground: '#ffffff',
-			menuBackground: '#E8F5E9',
-			menuBackgroundHover: '#C8E6C9',
-			pageBackground: '#FBFDF8',
-			text: '#1B5E20',
-			textSecondary: '#388E3C',
-			borderLight: '#E8F5E9',
-			border: '#C8E6C9',
-			borderStrong: '#A5D6A7',
-			error: '#E57373',
-			success: '#66BB6A',
-			warning: '#FFB74D',
-		},
-		dark: {
-			primary: '#4CAF50',
-			primaryButton: '#FF9500',
-			primaryButtonText: '#000000',
-			secondary: '#81C784',
-			secondaryButton: '#1E1E1E',
-			contentBackground: '#1E1E1E',
-			contentBackgroundHover: '#2E7D32',
-			contentPageBackground: '#121212',
-			menuBackground: '#252525',
-			menuBackgroundHover: '#2E7D32',
-			pageBackground: '#121212',
-			text: '#FFFFFF',
-			textSecondary: '#A5D6A7',
-			borderLight: '#1B5E20',
-			border: '#2E7D32',
-			borderStrong: '#388E3C',
-			error: '#CF6679',
-			success: '#81C784',
-			warning: '#FFD54F',
-		},
-	},
-
-	// Stone Theme - Elegant Slate
-	stone: {
-		light: {
-			primary: '#607D8B',
-			primaryButton: '#FF9500',
-			primaryButtonText: '#000000',
-			secondary: '#90A4AE',
-			secondaryButton: '#ECEFF1',
-			contentBackground: '#ECEFF1',
-			contentBackgroundHover: '#E0E6EA',
-			contentPageBackground: '#ffffff',
-			menuBackground: '#E0E6EA',
-			menuBackgroundHover: '#CFD8DC',
-			pageBackground: '#F5F7F9',
-			text: '#263238',
-			textSecondary: '#546E7A',
-			borderLight: '#ECEFF1',
-			border: '#CFD8DC',
-			borderStrong: '#B0BEC5',
-			error: '#EF5350',
-			success: '#66BB6A',
-			warning: '#FFA726',
-		},
-		dark: {
-			primary: '#78909C',
-			primaryButton: '#FF9500',
-			primaryButtonText: '#000000',
-			secondary: '#90A4AE',
-			secondaryButton: '#1E1E1E',
-			contentBackground: '#1E1E1E',
-			contentBackgroundHover: '#37474F',
-			contentPageBackground: '#121212',
-			menuBackground: '#252525',
-			menuBackgroundHover: '#37474F',
-			pageBackground: '#121212',
-			text: '#FFFFFF',
-			textSecondary: '#B0BEC5',
-			borderLight: '#37474F',
-			border: '#455A64',
-			borderStrong: '#546E7A',
-			error: '#CF6679',
-			success: '#81C784',
-			warning: '#FFD54F',
-		},
-	},
-
-	// Ocean Theme - Tranquil Blue
-	ocean: {
-		light: {
-			primary: '#039BE5',
-			primaryButton: '#FF9500',
-			primaryButtonText: '#000000',
-			secondary: '#4FC3F7',
-			secondaryButton: '#E1F5FE',
-			contentBackground: '#E1F5FE',
-			contentBackgroundHover: '#B3E5FC',
-			contentPageBackground: '#ffffff',
-			menuBackground: '#E1F5FE',
-			menuBackgroundHover: '#B3E5FC',
-			pageBackground: '#F5FCFF',
-			text: '#01579B',
-			textSecondary: '#0277BD',
-			borderLight: '#E1F5FE',
-			border: '#B3E5FC',
-			borderStrong: '#81D4FA',
-			error: '#EF5350',
-			success: '#66BB6A',
-			warning: '#FFA726',
-		},
-		dark: {
-			primary: '#039BE5',
-			primaryButton: '#FF9500',
-			primaryButtonText: '#000000',
-			secondary: '#4FC3F7',
-			secondaryButton: '#1E1E1E',
-			contentBackground: '#1E1E1E',
-			contentBackgroundHover: '#0277BD',
-			contentPageBackground: '#121212',
-			menuBackground: '#252525',
-			menuBackgroundHover: '#0277BD',
-			pageBackground: '#121212',
-			text: '#FFFFFF',
-			textSecondary: '#81D4FA',
-			borderLight: '#01579B',
-			border: '#0277BD',
-			borderStrong: '#0288D1',
-			error: '#CF6679',
-			success: '#81C784',
-			warning: '#FFD54F',
-		},
-	},
-};
-
-// Flat theme colors for direct use in Tailwind configs
-export const themeColors = {
-	mana: colors.mana,
-	primary: colors.primary,
-	lume: {
-		...colors.lume.light,
-		dark: colors.lume.dark,
-	},
-	nature: {
-		...colors.nature.light,
-		dark: colors.nature.dark,
-	},
-	stone: {
-		...colors.stone.light,
-		dark: colors.stone.dark,
-	},
-	ocean: {
-		...colors.ocean.light,
-		dark: colors.ocean.dark,
-	},
-};
-
-export default colors;
diff --git a/packages/shared-tailwind/src/components.css b/packages/shared-tailwind/src/components.css
deleted file mode 100644
index 6a8da0f98..000000000
--- a/packages/shared-tailwind/src/components.css
+++ /dev/null
@@ -1,236 +0,0 @@
-/* Shared Component Styles for Mana Apps
- * Import this in your app.css: @import '@mana/shared-tailwind/components.css';
- *
- * Requires theme-variables.css to be imported first for CSS variable support
- */
-
-body {
-  margin: 0;
-  font-family: var(--font-body);
-}
-
-html {
-  margin: 0;
-  padding: 0;
-}
-
-@layer base {
-  h1 {
-    @apply text-3xl font-bold;
-    color: var(--color-text);
-  }
-  h2 {
-    @apply text-2xl font-semibold;
-    color: var(--color-text);
-  }
-  h3 {
-    @apply text-xl font-semibold;
-    color: var(--color-text);
-  }
-}
-
-@layer components {
-  .btn-primary {
-    @apply rounded-lg px-4 py-2 font-semibold transition-colors;
-    background-color: var(--color-primary-button);
-    color: var(--color-primary-button-text);
-  }
-
-  .btn-primary:hover {
-    opacity: 0.9;
-  }
-
-  .btn-secondary {
-    @apply rounded-lg px-4 py-2 font-semibold transition-colors;
-    background-color: var(--color-secondary-button);
-    color: var(--color-text);
-    border: 1px solid var(--color-border);
-  }
-
-  .btn-secondary:hover {
-    background-color: var(--color-content-bg-hover);
-  }
-
-  .btn-danger {
-    @apply rounded-lg px-4 py-2 font-semibold transition-colors;
-    background-color: var(--color-error);
-    color: #ffffff;
-  }
-
-  .btn-danger:hover {
-    opacity: 0.9;
-  }
-
-  .input-field {
-    @apply w-full rounded-lg px-4 py-2 transition-colors;
-    background-color: var(--color-content-bg);
-    color: var(--color-text);
-    border: 1px solid var(--color-border);
-  }
-
-  .input-field:focus {
-    outline: none;
-    border-color: var(--color-primary);
-    box-shadow: 0 0 0 3px color-mix(in srgb, var(--color-primary) 20%, transparent);
-  }
-
-  .card {
-    @apply rounded-lg p-6 shadow-sm;
-    background-color: var(--color-content-bg);
-    color: var(--color-text);
-  }
-
-  /* Header & Navigation */
-  .header-style {
-    background-color: var(--color-menu-bg);
-    border-bottom: 1px solid var(--color-border);
-  }
-
-  .logo-text {
-    @apply text-2xl font-bold;
-    color: var(--color-primary);
-  }
-
-  .nav-link {
-    @apply transition-colors;
-    color: var(--color-text);
-  }
-
-  .nav-link:hover {
-    color: var(--color-primary);
-  }
-
-  .user-email {
-    @apply text-sm;
-    color: var(--color-text);
-    opacity: 0.7;
-  }
-
-  /* Main Content Area */
-  .main-content {
-    background-color: var(--color-page-bg);
-  }
-
-  /* Selected/Active State */
-  .bg-selected {
-    background-color: color-mix(in srgb, var(--color-primary) 10%, transparent);
-  }
-
-  /* Status Badge Colors */
-  .status-completed {
-    background-color: rgba(76, 175, 80, 0.15);
-    color: #4caf50;
-  }
-
-  .status-processing {
-    background-color: color-mix(in srgb, var(--color-primary) 15%, transparent);
-    color: var(--color-primary);
-  }
-
-  .status-failed {
-    background-color: color-mix(in srgb, var(--color-error) 15%, transparent);
-    color: var(--color-error);
-  }
-
-  .status-default {
-    background-color: color-mix(in srgb, var(--color-text) 10%, transparent);
-    color: var(--color-text);
-  }
-
-  /* Info/Alert Boxes */
-  .info-box {
-    background-color: color-mix(in srgb, var(--color-primary) 10%, transparent);
-    border: 1px solid color-mix(in srgb, var(--color-primary) 30%, transparent);
-  }
-
-  /* Loading Spinner */
-  .spinner-border {
-    border-color: var(--color-primary);
-  }
-
-  /* Focus Ring */
-  .focus\:ring-primary:focus {
-    --tw-ring-color: var(--color-primary);
-  }
-
-  .focus\:ring-2:focus {
-    box-shadow: 0 0 0 2px var(--tw-ring-color, var(--color-primary));
-  }
-}
-
-@layer utilities {
-  /* Theme Color Utilities - in utilities layer for @apply support */
-  .bg-content {
-    background-color: var(--color-content-bg);
-  }
-
-  .bg-content-hover {
-    background-color: var(--color-content-bg-hover);
-  }
-
-  .hover\:bg-content-hover:hover {
-    background-color: var(--color-content-bg-hover);
-  }
-
-  .bg-menu {
-    background-color: var(--color-menu-bg);
-  }
-
-  .bg-menu-hover {
-    background-color: var(--color-menu-bg-hover);
-  }
-
-  .hover\:bg-menu-hover:hover {
-    background-color: var(--color-menu-bg-hover);
-  }
-
-  .bg-panel {
-    background-color: var(--color-panel-bg);
-  }
-
-  .bg-page {
-    background-color: var(--color-page-bg);
-  }
-
-  .border-theme {
-    border-color: var(--color-border);
-  }
-
-  .border-theme-light {
-    border-color: var(--color-border-light);
-  }
-
-  .text-theme {
-    color: var(--color-text);
-  }
-
-  .text-theme-secondary {
-    color: var(--color-text);
-    opacity: 0.6;
-  }
-
-  .text-theme-muted {
-    color: var(--color-text);
-    opacity: 0.4;
-  }
-
-  .text-primary {
-    color: var(--color-primary);
-  }
-
-  .bg-primary {
-    background-color: var(--color-primary);
-  }
-
-  .bg-primary-button {
-    background-color: var(--color-primary-button);
-  }
-
-  .text-primary-button-text {
-    color: var(--color-primary-button-text);
-  }
-
-  .bg-secondary-button {
-    background-color: var(--color-secondary-button);
-  }
-}
diff --git a/packages/shared-tailwind/src/index.js b/packages/shared-tailwind/src/index.js
deleted file mode 100644
index 34e6271ca..000000000
--- a/packages/shared-tailwind/src/index.js
+++ /dev/null
@@ -1,15 +0,0 @@
-/**
- * @mana/shared-tailwind
- *
- * Shared Tailwind CSS configuration for all Mana apps.
- *
- * Exports:
- * - preset: Tailwind preset with colors, themes, and design tokens
- * - colors: Color palette definitions
- *
- * Also available:
- * - @mana/shared-tailwind/themes.css: CSS custom properties for runtime theming
- */
-
-export { default as preset } from './preset.js';
-export { colors, default as defaultColors } from './colors.js';
diff --git a/packages/shared-tailwind/src/preset.js b/packages/shared-tailwind/src/preset.js
deleted file mode 100644
index 7856d029b..000000000
--- a/packages/shared-tailwind/src/preset.js
+++ /dev/null
@@ -1,181 +0,0 @@
-/**
- * Shared Tailwind CSS preset for all Mana apps
- *
- * This preset uses HSL-based CSS variables for theming.
- * Colors are defined as HSL values (e.g., "47 95% 58%") and
- * wrapped with hsl() in the Tailwind config for flexibility.
- *
- * Usage in tailwind.config.js:
- * ```
- * import preset from '@mana/shared-tailwind/preset';
- *
- * export default {
- *   presets: [preset],
- *   content: ['./src/**\/*.{html,js,svelte,ts}'],
- *   // app-specific overrides...
- * }
- * ```
- */
-
-/** @type {import('tailwindcss').Config} */
-const preset = {
-	darkMode: 'class',
-	theme: {
-		extend: {
-			colors: {
-				// Brand color (consistent across all apps)
-				mana: '#4287f5',
-
-				// ===== HSL-Based Semantic Colors =====
-				// These use CSS variables set by @mana/shared-theme
-				// Format: hsl(var(--color-name)) where --color-name is "H S% L%"
-
-				// Page background
-				background: 'hsl(var(--color-background))',
-
-				// Main text color
-				foreground: 'hsl(var(--color-foreground))',
-
-				// Primary brand color (customizable per app)
-				primary: {
-					DEFAULT: 'hsl(var(--color-primary))',
-					foreground: 'hsl(var(--color-primary-foreground))',
-				},
-
-				// Secondary accent
-				secondary: {
-					DEFAULT: 'hsl(var(--color-secondary))',
-					foreground: 'hsl(var(--color-secondary-foreground))',
-				},
-
-				// Card/content surfaces
-				surface: {
-					DEFAULT: 'hsl(var(--color-surface))',
-					hover: 'hsl(var(--color-surface-hover))',
-					elevated: 'hsl(var(--color-surface-elevated))',
-				},
-
-				// Muted/disabled elements
-				muted: {
-					DEFAULT: 'hsl(var(--color-muted))',
-					foreground: 'hsl(var(--color-muted-foreground))',
-				},
-
-				// Borders
-				border: {
-					DEFAULT: 'hsl(var(--color-border))',
-					strong: 'hsl(var(--color-border-strong))',
-				},
-
-				// Semantic/feedback colors
-				error: 'hsl(var(--color-error))',
-				success: 'hsl(var(--color-success))',
-				warning: 'hsl(var(--color-warning))',
-
-				// Form elements
-				input: 'hsl(var(--color-input))',
-				ring: 'hsl(var(--color-ring))',
-
-				// ===== Legacy aliases (for backwards compatibility) =====
-				content: {
-					DEFAULT: 'hsl(var(--color-surface))',
-					hover: 'hsl(var(--color-surface-hover))',
-					page: 'hsl(var(--color-background))',
-				},
-				menu: {
-					DEFAULT: 'hsl(var(--color-muted))',
-					hover: 'hsl(var(--color-surface-hover))',
-				},
-				theme: {
-					DEFAULT: 'hsl(var(--color-foreground))',
-					secondary: 'hsl(var(--color-muted-foreground))',
-				},
-				'primary-btn': {
-					DEFAULT: 'hsl(var(--color-primary))',
-					text: 'hsl(var(--color-primary-foreground))',
-				},
-			},
-
-			// Border radius tokens (CSS variable support)
-			borderRadius: {
-				none: '0',
-				sm: 'var(--radius-sm, 0.25rem)',
-				DEFAULT: 'var(--radius, 0.375rem)',
-				md: 'var(--radius-md, 0.5rem)',
-				lg: 'var(--radius-lg, 0.75rem)',
-				xl: 'var(--radius-xl, 1rem)',
-				'2xl': 'var(--radius-2xl, 1.5rem)',
-				'3xl': 'var(--radius-3xl, 2rem)',
-				full: '9999px',
-			},
-
-			// Box shadow tokens
-			boxShadow: {
-				sm: '0 1px 2px 0 rgb(0 0 0 / 0.05)',
-				DEFAULT: '0 1px 3px 0 rgb(0 0 0 / 0.1), 0 1px 2px -1px rgb(0 0 0 / 0.1)',
-				md: '0 4px 6px -1px rgb(0 0 0 / 0.1), 0 2px 4px -2px rgb(0 0 0 / 0.1)',
-				lg: '0 10px 15px -3px rgb(0 0 0 / 0.1), 0 4px 6px -4px rgb(0 0 0 / 0.1)',
-				xl: '0 20px 25px -5px rgb(0 0 0 / 0.1), 0 8px 10px -6px rgb(0 0 0 / 0.1)',
-				'2xl': '0 25px 50px -12px rgb(0 0 0 / 0.25)',
-				inner: 'inset 0 2px 4px 0 rgb(0 0 0 / 0.05)',
-				none: 'none',
-			},
-
-			// Font family
-			fontFamily: {
-				sans: [
-					'Inter',
-					'system-ui',
-					'-apple-system',
-					'BlinkMacSystemFont',
-					'Segoe UI',
-					'Roboto',
-					'Helvetica Neue',
-					'Arial',
-					'sans-serif',
-				],
-				mono: ['JetBrains Mono', 'Fira Code', 'Menlo', 'Monaco', 'Consolas', 'monospace'],
-			},
-
-			// Animation
-			animation: {
-				'spin-slow': 'spin 3s linear infinite',
-				'pulse-slow': 'pulse 3s cubic-bezier(0.4, 0, 0.6, 1) infinite',
-				'bounce-slow': 'bounce 2s infinite',
-				'fade-in': 'fadeIn 0.2s ease-out',
-				'fade-out': 'fadeOut 0.2s ease-in',
-				'slide-in': 'slideIn 0.2s ease-out',
-				'slide-out': 'slideOut 0.2s ease-in',
-			},
-
-			keyframes: {
-				fadeIn: {
-					'0%': { opacity: '0' },
-					'100%': { opacity: '1' },
-				},
-				fadeOut: {
-					'0%': { opacity: '1' },
-					'100%': { opacity: '0' },
-				},
-				slideIn: {
-					'0%': { transform: 'translateY(-10px)', opacity: '0' },
-					'100%': { transform: 'translateY(0)', opacity: '1' },
-				},
-				slideOut: {
-					'0%': { transform: 'translateY(0)', opacity: '1' },
-					'100%': { transform: 'translateY(-10px)', opacity: '0' },
-				},
-			},
-
-			// Transition
-			transitionDuration: {
-				250: '250ms',
-				350: '350ms',
-				400: '400ms',
-			},
-		},
-	},
-	plugins: [],
-};
-
-export default preset;
diff --git a/packages/shared-tailwind/src/tailwind-v4.css b/packages/shared-tailwind/src/tailwind-v4.css
deleted file mode 100644
index 23d521993..000000000
--- a/packages/shared-tailwind/src/tailwind-v4.css
+++ /dev/null
@@ -1,117 +0,0 @@
-/**
- * Tailwind CSS v4 Configuration
- *
- * This file provides the CSS-first configuration for Tailwind v4.
- * Import this file in your app.css instead of using tailwind.config.js
- *
- * Usage:
- * @import "tailwindcss";
- * @import "@mana/shared-tailwind/v4";
- */
-
-/* ===== Theme Configuration ===== */
-@theme {
-  /* Brand color */
-  --color-mana: #4287f5;
-
-  /* Semantic colors using CSS variables */
-  --color-background: hsl(var(--color-background));
-  --color-foreground: hsl(var(--color-foreground));
-
-  --color-primary: hsl(var(--color-primary));
-  --color-primary-foreground: hsl(var(--color-primary-foreground));
-
-  --color-secondary: hsl(var(--color-secondary));
-  --color-secondary-foreground: hsl(var(--color-secondary-foreground));
-
-  --color-surface: hsl(var(--color-surface));
-  --color-surface-hover: hsl(var(--color-surface-hover));
-  --color-surface-elevated: hsl(var(--color-surface-elevated));
-
-  --color-muted: hsl(var(--color-muted));
-  --color-muted-foreground: hsl(var(--color-muted-foreground));
-
-  --color-border: hsl(var(--color-border));
-  --color-border-strong: hsl(var(--color-border-strong));
-
-  --color-error: hsl(var(--color-error));
-  --color-success: hsl(var(--color-success));
-  --color-warning: hsl(var(--color-warning));
-
-  --color-input: hsl(var(--color-input));
-  --color-ring: hsl(var(--color-ring));
-
-  /* Legacy aliases */
-  --color-content: hsl(var(--color-surface));
-  --color-content-hover: hsl(var(--color-surface-hover));
-  --color-content-page: hsl(var(--color-background));
-
-  --color-menu: hsl(var(--color-muted));
-  --color-menu-hover: hsl(var(--color-surface-hover));
-
-  --color-theme: hsl(var(--color-foreground));
-  --color-theme-secondary: hsl(var(--color-muted-foreground));
-
-  --color-primary-btn: hsl(var(--color-primary));
-  --color-primary-btn-text: hsl(var(--color-primary-foreground));
-
-  /* Border radius */
-  --radius-none: 0;
-  --radius-sm: var(--radius-sm, 0.25rem);
-  --radius-DEFAULT: var(--radius, 0.375rem);
-  --radius-md: var(--radius-md, 0.5rem);
-  --radius-lg: var(--radius-lg, 0.75rem);
-  --radius-xl: var(--radius-xl, 1rem);
-  --radius-2xl: var(--radius-2xl, 1.5rem);
-  --radius-3xl: var(--radius-3xl, 2rem);
-  --radius-full: 9999px;
-
-  /* Box shadows */
-  --shadow-sm: 0 1px 2px 0 rgb(0 0 0 / 0.05);
-  --shadow-DEFAULT: 0 1px 3px 0 rgb(0 0 0 / 0.1), 0 1px 2px -1px rgb(0 0 0 / 0.1);
-  --shadow-md: 0 4px 6px -1px rgb(0 0 0 / 0.1), 0 2px 4px -2px rgb(0 0 0 / 0.1);
-  --shadow-lg: 0 10px 15px -3px rgb(0 0 0 / 0.1), 0 4px 6px -4px rgb(0 0 0 / 0.1);
-  --shadow-xl: 0 20px 25px -5px rgb(0 0 0 / 0.1), 0 8px 10px -6px rgb(0 0 0 / 0.1);
-  --shadow-2xl: 0 25px 50px -12px rgb(0 0 0 / 0.25);
-  --shadow-inner: inset 0 2px 4px 0 rgb(0 0 0 / 0.05);
-  --shadow-none: none;
-
-  /* Font families */
-  --font-sans: 'Inter', system-ui, -apple-system, BlinkMacSystemFont, 'Segoe UI', Roboto, 'Helvetica Neue', Arial, sans-serif;
-  --font-mono: 'JetBrains Mono', 'Fira Code', Menlo, Monaco, Consolas, monospace;
-
-  /* Transition durations */
-  --duration-250: 250ms;
-  --duration-350: 350ms;
-  --duration-400: 400ms;
-
-  /* Animations */
-  --animate-spin-slow: spin 3s linear infinite;
-  --animate-pulse-slow: pulse 3s cubic-bezier(0.4, 0, 0.6, 1) infinite;
-  --animate-bounce-slow: bounce 2s infinite;
-  --animate-fade-in: fadeIn 0.2s ease-out;
-  --animate-fade-out: fadeOut 0.2s ease-in;
-  --animate-slide-in: slideIn 0.2s ease-out;
-  --animate-slide-out: slideOut 0.2s ease-in;
-}
-
-/* ===== Keyframes ===== */
-@keyframes fadeIn {
-  0% { opacity: 0; }
-  100% { opacity: 1; }
-}
-
-@keyframes fadeOut {
-  0% { opacity: 1; }
-  100% { opacity: 0; }
-}
-
-@keyframes slideIn {
-  0% { transform: translateY(-10px); opacity: 0; }
-  100% { transform: translateY(0); opacity: 1; }
-}
-
-@keyframes slideOut {
-  0% { transform: translateY(0); opacity: 1; }
-  100% { transform: translateY(-10px); opacity: 0; }
-}
diff --git a/packages/shared-tailwind/src/theme-variables.css b/packages/shared-tailwind/src/theme-variables.css
deleted file mode 100644
index d859e6690..000000000
--- a/packages/shared-tailwind/src/theme-variables.css
+++ /dev/null
@@ -1,183 +0,0 @@
-/* Shared Theme CSS Variables for Mana Apps
- * Import this in your app.css: @import '@mana/shared-tailwind/theme.css';
- *
- * Features:
- * - 4 Theme Variants: Lume (default), Nature, Stone, Ocean
- * - Light and Dark mode for each theme
- * - Uses data-theme attribute for variant switching
- * - Uses .dark class for dark mode
- */
-
-:root {
-  --font-body: system-ui, -apple-system, BlinkMacSystemFont, 'Segoe UI', Roboto, Oxygen, Ubuntu,
-    Cantarell, 'Open Sans', 'Helvetica Neue', sans-serif;
-  --font-mono: 'Fira Mono', monospace;
-}
-
-/* Default Theme: Lume Light */
-:root {
-  --color-primary: #f8d62b;
-  --color-primary-button: #f8d62b;
-  --color-primary-button-text: #000000;
-  --color-secondary: #d4b200;
-  --color-secondary-button: #ffe9a3;
-  --color-content-bg: #ffffff;
-  --color-content-bg-hover: #f5f5f5;
-  --color-content-page-bg: #ffffff;
-  --color-menu-bg: #dddddd;
-  --color-menu-bg-hover: #cccccc;
-  --color-panel-bg: #e8e8e8;
-  --color-page-bg: #dddddd;
-  --color-text: #2c2c2c;
-  --color-border-light: #f2f2f2;
-  --color-border: #999999;
-  --color-border-strong: #cccccc;
-  --color-error: #e74c3c;
-}
-
-/* Lume Dark */
-:root.dark {
-  --color-primary: #f8d62b;
-  --color-primary-button: #7c6b16;
-  --color-primary-button-text: #ffffff;
-  --color-secondary: #d4b200;
-  --color-secondary-button: #1e1e1e;
-  --color-content-bg: #1e1e1e;
-  --color-content-bg-hover: #333333;
-  --color-content-page-bg: #121212;
-  --color-menu-bg: #101010;
-  --color-menu-bg-hover: #333333;
-  --color-panel-bg: #1a1a1a;
-  --color-page-bg: #101010;
-  --color-text: #ffffff;
-  --color-border-light: #333333;
-  --color-border: #424242;
-  --color-border-strong: #616161;
-  --color-error: #e74c3c;
-}
-
-/* Nature Light */
-:root[data-theme='nature'] {
-  --color-primary: #4caf50;
-  --color-primary-button: #a08500;
-  --color-primary-button-text: #ffffff;
-  --color-secondary: #81c784;
-  --color-secondary-button: #f1f8e9;
-  --color-content-bg: #f1f8e9;
-  --color-content-bg-hover: #e8f5e9;
-  --color-content-page-bg: #ffffff;
-  --color-menu-bg: #e8f5e9;
-  --color-menu-bg-hover: #c8e6c9;
-  --color-panel-bg: #eff8f0;
-  --color-page-bg: #fbfdf8;
-  --color-text: #1b5e20;
-  --color-border-light: #e8f5e9;
-  --color-border: #c8e6c9;
-  --color-border-strong: #a5d6a7;
-  --color-error: #e57373;
-}
-
-/* Nature Dark */
-:root[data-theme='nature'].dark {
-  --color-primary: #4caf50;
-  --color-primary-button: #ff9500;
-  --color-primary-button-text: #000000;
-  --color-secondary: #81c784;
-  --color-secondary-button: #1e1e1e;
-  --color-content-bg: #1e1e1e;
-  --color-content-bg-hover: #2e7d32;
-  --color-content-page-bg: #121212;
-  --color-menu-bg: #252525;
-  --color-menu-bg-hover: #2e7d32;
-  --color-panel-bg: #2a2a2a;
-  --color-page-bg: #121212;
-  --color-text: #ffffff;
-  --color-border-light: #1b5e20;
-  --color-border: #2e7d32;
-  --color-border-strong: #388e3c;
-  --color-error: #cf6679;
-}
-
-/* Stone Light */
-:root[data-theme='stone'] {
-  --color-primary: #607d8b;
-  --color-primary-button: #ff9500;
-  --color-primary-button-text: #000000;
-  --color-secondary: #90a4ae;
-  --color-secondary-button: #eceff1;
-  --color-content-bg: #eceff1;
-  --color-content-bg-hover: #e0e6ea;
-  --color-content-page-bg: #ffffff;
-  --color-menu-bg: #e0e6ea;
-  --color-menu-bg-hover: #cfd8dc;
-  --color-panel-bg: #e8edf0;
-  --color-page-bg: #f5f7f9;
-  --color-text: #263238;
-  --color-border-light: #eceff1;
-  --color-border: #cfd8dc;
-  --color-border-strong: #b0bec5;
-  --color-error: #ef5350;
-}
-
-/* Stone Dark */
-:root[data-theme='stone'].dark {
-  --color-primary: #78909c;
-  --color-primary-button: #ff9500;
-  --color-primary-button-text: #000000;
-  --color-secondary: #90a4ae;
-  --color-secondary-button: #1e1e1e;
-  --color-content-bg: #1e1e1e;
-  --color-content-bg-hover: #37474f;
-  --color-content-page-bg: #121212;
-  --color-menu-bg: #252525;
-  --color-menu-bg-hover: #37474f;
-  --color-panel-bg: #2a2a2a;
-  --color-page-bg: #121212;
-  --color-text: #ffffff;
-  --color-border-light: #37474f;
-  --color-border: #455a64;
-  --color-border-strong: #546e7a;
-  --color-error: #cf6679;
-}
-
-/* Ocean Light */
-:root[data-theme='ocean'] {
-  --color-primary: #039be5;
-  --color-primary-button: #ff9500;
-  --color-primary-button-text: #000000;
-  --color-secondary: #4fc3f7;
-  --color-secondary-button: #e1f5fe;
-  --color-content-bg: #e1f5fe;
-  --color-content-bg-hover: #b3e5fc;
-  --color-content-page-bg: #ffffff;
-  --color-menu-bg: #e1f5fe;
-  --color-menu-bg-hover: #b3e5fc;
-  --color-panel-bg: #ecf8fe;
-  --color-page-bg: #f5fcff;
-  --color-text: #01579b;
-  --color-border-light: #e1f5fe;
-  --color-border: #b3e5fc;
-  --color-border-strong: #81d4fa;
-  --color-error: #ef5350;
-}
-
-/* Ocean Dark */
-:root[data-theme='ocean'].dark {
-  --color-primary: #039be5;
-  --color-primary-button: #ff9500;
-  --color-primary-button-text: #000000;
-  --color-secondary: #4fc3f7;
-  --color-secondary-button: #1e1e1e;
-  --color-content-bg: #1e1e1e;
-  --color-content-bg-hover: #0277bd;
-  --color-content-page-bg: #121212;
-  --color-menu-bg: #252525;
-  --color-menu-bg-hover: #0277bd;
-  --color-panel-bg: #2a2a2a;
-  --color-page-bg: #121212;
-  --color-text: #ffffff;
-  --color-border-light: #01579b;
-  --color-border: #0277bd;
-  --color-border-strong: #0288d1;
-  --color-error: #cf6679;
-}
diff --git a/packages/shared-tailwind/src/themes.css b/packages/shared-tailwind/src/themes.css
index 5b6a7bc4e..065d80626 100644
--- a/packages/shared-tailwind/src/themes.css
+++ b/packages/shared-tailwind/src/themes.css
@@ -1,692 +1,580 @@
 /**
- * Shared Theme CSS Variables
+ * Shared Theme CSS Variables — shadcn / Tailwind v4 convention.
  *
- * This file defines CSS custom properties for all theme variants.
- * Variables are set by @mana/shared-theme's createThemeStore() at runtime,
- * but this file provides sensible defaults for static rendering.
+ * Design:
+ *   - Single source-of-truth layer: `--color-X` defined as raw HSL channels
+ *     (e.g. `0 0% 17%`, NOT `hsl(0 0% 17%)`) in :root, .dark, and variant
+ *     [data-theme="..."] blocks. The runtime store in @mana/shared-theme
+ *     writes the same names with the same format, so static and runtime
+ *     rendering stay consistent (no flash of unstyled content).
+ *
+ *   - `@theme inline` uses self-reference + `<alpha-value>` placeholder so
+ *     Tailwind v4 generates utility classes (`text-foreground`, `bg-card`,
+ *     etc.) AND opacity modifiers (`text-foreground/50`) work.
+ *
+ * Consumer conventions:
+ *
+ *   1. Markup (preferred when possible):
+ *      <p class="text-foreground">…</p>
+ *      <div class="bg-card border-border">…</div>
+ *      <span class="text-muted-foreground/60">…</span>
+ *
+ *   2. Scoped CSS (when utilities don't fit, e.g. complex selectors):
+ *      .my-text { color: hsl(var(--color-foreground)); }
+ *      .my-bg { background: hsl(var(--color-card) / 0.5); }
+ *
+ *   3. NEVER write raw `var(--color-X)` without wrapping with `hsl()`.
+ *      The variable holds raw channels, not a valid CSS color.
  *
  * Usage in app.css (Tailwind v4):
- * ```css
- * @import "tailwindcss";
- * @import "@mana/shared-tailwind/themes.css";
- * ```
- *
- * Tailwind v4 Integration:
- * - Base color values are defined in :root with --theme-* prefix
- * - @theme inline references these via var(--theme-*)
- * - This generates utility classes (bg-background, text-foreground, etc.)
- * - Theme variants override --theme-* values in [data-theme] selectors
+ *   @import "tailwindcss";
+ *   @import "@mana/shared-tailwind/themes.css";
  */
 
 /* ===== Tailwind v4 Theme Configuration ===== */
 @theme inline {
-  /*
-   * Theme Colors - Reference CSS variables that are defined in :root
-   * This tells Tailwind to generate utility classes that use these variables
-   */
-  --color-primary: var(--theme-primary);
-  --color-primary-foreground: var(--theme-primary-foreground);
-  --color-secondary: var(--theme-secondary);
-  --color-secondary-foreground: var(--theme-secondary-foreground);
-  --color-background: var(--theme-background);
-  --color-foreground: var(--theme-foreground);
-  --color-surface: var(--theme-surface);
-  --color-surface-hover: var(--theme-surface-hover);
-  --color-surface-elevated: var(--theme-surface-elevated);
+	/*
+	 * Self-referencing wrappers — `<alpha-value>` is a Tailwind v4 placeholder
+	 * that gets substituted to `1` for unmodified utilities and to `0.5`,
+	 * `0.25`, etc. for opacity modifiers (`text-foreground/50`).
+	 */
+	--color-primary: hsl(var(--color-primary) / <alpha-value>);
+	--color-primary-foreground: hsl(var(--color-primary-foreground) / <alpha-value>);
+	--color-secondary: hsl(var(--color-secondary) / <alpha-value>);
+	--color-secondary-foreground: hsl(var(--color-secondary-foreground) / <alpha-value>);
+	--color-background: hsl(var(--color-background) / <alpha-value>);
+	--color-foreground: hsl(var(--color-foreground) / <alpha-value>);
+	--color-surface: hsl(var(--color-surface) / <alpha-value>);
+	--color-surface-hover: hsl(var(--color-surface-hover) / <alpha-value>);
+	--color-surface-elevated: hsl(var(--color-surface-elevated) / <alpha-value>);
+	--color-surface-elevated-1: hsl(var(--color-surface-elevated-1) / <alpha-value>);
+	--color-surface-elevated-2: hsl(var(--color-surface-elevated-2) / <alpha-value>);
+	--color-surface-elevated-3: hsl(var(--color-surface-elevated-3) / <alpha-value>);
+	--color-muted: hsl(var(--color-muted) / <alpha-value>);
+	--color-muted-foreground: hsl(var(--color-muted-foreground) / <alpha-value>);
+	--color-border: hsl(var(--color-border) / <alpha-value>);
+	--color-border-strong: hsl(var(--color-border-strong) / <alpha-value>);
+	--color-error: hsl(var(--color-error) / <alpha-value>);
+	--color-success: hsl(var(--color-success) / <alpha-value>);
+	--color-warning: hsl(var(--color-warning) / <alpha-value>);
+	--color-input: hsl(var(--color-input) / <alpha-value>);
+	--color-ring: hsl(var(--color-ring) / <alpha-value>);
 
-  /* Elevation system - progressively lighter surfaces for overlays */
-  --color-surface-elevated-1: var(--theme-surface-elevated-1);
-  --color-surface-elevated-2: var(--theme-surface-elevated-2);
-  --color-surface-elevated-3: var(--theme-surface-elevated-3);
-  --color-muted: var(--theme-muted);
-  --color-muted-foreground: var(--theme-muted-foreground);
-  --color-border: var(--theme-border);
-  --color-border-strong: var(--theme-border-strong);
-  --color-error: var(--theme-error);
-  --color-success: var(--theme-success);
-  --color-warning: var(--theme-warning);
-  --color-input: var(--theme-input);
-  --color-ring: var(--theme-ring);
-
-  /* ShadCN-compatible color aliases */
-  --color-card: var(--theme-card);
-  --color-card-foreground: var(--theme-card-foreground);
-  --color-accent: var(--theme-accent);
-  --color-accent-foreground: var(--theme-accent-foreground);
-
-  /* Legacy aliases */
-  --color-content: var(--theme-content);
-  --color-content-hover: var(--theme-content-hover);
-  --color-content-page: var(--theme-content-page);
-  --color-menu: var(--theme-menu);
-  --color-menu-hover: var(--theme-menu-hover);
+	/* ShadCN-compatible aliases */
+	--color-card: hsl(var(--color-card) / <alpha-value>);
+	--color-card-foreground: hsl(var(--color-card-foreground) / <alpha-value>);
+	--color-accent: hsl(var(--color-accent) / <alpha-value>);
+	--color-accent-foreground: hsl(var(--color-accent-foreground) / <alpha-value>);
 }
 
 @theme {
-  /* Brand color */
-  --color-mana: #4287f5;
+	/* Brand color (literal, not theme-aware) */
+	--color-mana: #4287f5;
 
-  /* Border radius */
-  --radius-none: 0;
-  --radius-sm: 0.25rem;
-  --radius-DEFAULT: 0.375rem;
-  --radius-md: 0.5rem;
-  --radius-lg: 0.75rem;
-  --radius-xl: 1rem;
-  --radius-2xl: 1.5rem;
-  --radius-3xl: 2rem;
-  --radius-full: 9999px;
+	/* Border radius */
+	--radius-none: 0;
+	--radius-sm: 0.25rem;
+	--radius-DEFAULT: 0.375rem;
+	--radius-md: 0.5rem;
+	--radius-lg: 0.75rem;
+	--radius-xl: 1rem;
+	--radius-2xl: 1.5rem;
+	--radius-3xl: 2rem;
+	--radius-full: 9999px;
 
-  /* Box shadows */
-  --shadow-sm: 0 1px 2px 0 rgb(0 0 0 / 0.05);
-  --shadow-DEFAULT: 0 1px 3px 0 rgb(0 0 0 / 0.1), 0 1px 2px -1px rgb(0 0 0 / 0.1);
-  --shadow-md: 0 4px 6px -1px rgb(0 0 0 / 0.1), 0 2px 4px -2px rgb(0 0 0 / 0.1);
-  --shadow-lg: 0 10px 15px -3px rgb(0 0 0 / 0.1), 0 4px 6px -4px rgb(0 0 0 / 0.1);
-  --shadow-xl: 0 20px 25px -5px rgb(0 0 0 / 0.1), 0 8px 10px -6px rgb(0 0 0 / 0.1);
-  --shadow-2xl: 0 25px 50px -12px rgb(0 0 0 / 0.25);
-  --shadow-inner: inset 0 2px 4px 0 rgb(0 0 0 / 0.05);
-  --shadow-none: none;
+	/* Box shadows */
+	--shadow-sm: 0 1px 2px 0 rgb(0 0 0 / 0.05);
+	--shadow-DEFAULT: 0 1px 3px 0 rgb(0 0 0 / 0.1), 0 1px 2px -1px rgb(0 0 0 / 0.1);
+	--shadow-md: 0 4px 6px -1px rgb(0 0 0 / 0.1), 0 2px 4px -2px rgb(0 0 0 / 0.1);
+	--shadow-lg: 0 10px 15px -3px rgb(0 0 0 / 0.1), 0 4px 6px -4px rgb(0 0 0 / 0.1);
+	--shadow-xl: 0 20px 25px -5px rgb(0 0 0 / 0.1), 0 8px 10px -6px rgb(0 0 0 / 0.1);
+	--shadow-2xl: 0 25px 50px -12px rgb(0 0 0 / 0.25);
+	--shadow-inner: inset 0 2px 4px 0 rgb(0 0 0 / 0.05);
+	--shadow-none: none;
 
-  /* Font families */
-  --font-sans: 'Inter', system-ui, -apple-system, BlinkMacSystemFont, 'Segoe UI', Roboto, 'Helvetica Neue', Arial, sans-serif;
-  --font-mono: 'JetBrains Mono', 'Fira Code', Menlo, Monaco, Consolas, monospace;
+	/* Font families */
+	--font-sans: 'Inter', system-ui, -apple-system, BlinkMacSystemFont, 'Segoe UI', Roboto, 'Helvetica Neue', Arial, sans-serif;
+	--font-mono: 'JetBrains Mono', 'Fira Code', Menlo, Monaco, Consolas, monospace;
 
-  /* Animations */
-  --animate-spin-slow: spin 3s linear infinite;
-  --animate-pulse-slow: pulse 3s cubic-bezier(0.4, 0, 0.6, 1) infinite;
-  --animate-bounce-slow: bounce 2s infinite;
-  --animate-fade-in: fadeIn 0.2s ease-out;
-  --animate-fade-out: fadeOut 0.2s ease-in;
-  --animate-slide-in: slideIn 0.2s ease-out;
-  --animate-slide-out: slideOut 0.2s ease-in;
+	/* Animations */
+	--animate-spin-slow: spin 3s linear infinite;
+	--animate-pulse-slow: pulse 3s cubic-bezier(0.4, 0, 0.6, 1) infinite;
+	--animate-bounce-slow: bounce 2s infinite;
+	--animate-fade-in: fadeIn 0.2s ease-out;
+	--animate-fade-out: fadeOut 0.2s ease-in;
+	--animate-slide-in: slideIn 0.2s ease-out;
+	--animate-slide-out: slideOut 0.2s ease-in;
 }
 
 /* ===== Keyframes ===== */
 @keyframes fadeIn {
-  0% { opacity: 0; }
-  100% { opacity: 1; }
+	0% { opacity: 0; }
+	100% { opacity: 1; }
 }
-
 @keyframes fadeOut {
-  0% { opacity: 1; }
-  100% { opacity: 0; }
+	0% { opacity: 1; }
+	100% { opacity: 0; }
 }
-
 @keyframes slideIn {
-  0% { transform: translateY(-10px); opacity: 0; }
-  100% { transform: translateY(0); opacity: 1; }
+	0% { transform: translateY(-10px); opacity: 0; }
+	100% { transform: translateY(0); opacity: 1; }
 }
-
 @keyframes slideOut {
-  0% { transform: translateY(0); opacity: 1; }
-  100% { transform: translateY(-10px); opacity: 0; }
+	0% { transform: translateY(0); opacity: 1; }
+	100% { transform: translateY(-10px); opacity: 0; }
 }
 
 /* ===== Default Theme (Lume Light) ===== */
 :root {
-  /* Base theme values - these are referenced by @theme inline */
-  --theme-primary: hsl(47 95% 58%);
-  --theme-primary-foreground: hsl(0 0% 0%);
-  --theme-secondary: hsl(47 100% 41%);
-  --theme-secondary-foreground: hsl(0 0% 0%);
-  --theme-background: hsl(0 0% 87%);
-  --theme-foreground: hsl(0 0% 17%);
-  --theme-surface: hsl(0 0% 100%);
-  --theme-surface-hover: hsl(0 0% 96%);
-  --theme-surface-elevated: hsl(0 0% 100%);
-  /* Elevation system - progressively lighter surfaces for overlays */
-  --theme-surface-elevated-1: hsl(0 0% 100%);
-  --theme-surface-elevated-2: hsl(0 0% 100%);
-  --theme-surface-elevated-3: hsl(0 0% 100%);
-  --theme-muted: hsl(0 0% 90%);
-  --theme-muted-foreground: hsl(0 0% 40%);
-  --theme-border: hsl(0 0% 90%);
-  --theme-border-strong: hsl(0 0% 80%);
-  --theme-error: hsl(6 78% 57%);
-  --theme-success: hsl(145 63% 42%);
-  --theme-warning: hsl(36 100% 50%);
-  --theme-input: hsl(0 0% 100%);
-  --theme-ring: hsl(47 95% 58%);
+	--color-primary: 47 95% 58%;
+	--color-primary-foreground: 0 0% 0%;
+	--color-secondary: 47 100% 41%;
+	--color-secondary-foreground: 0 0% 0%;
+	--color-background: 0 0% 87%;
+	--color-foreground: 0 0% 17%;
+	--color-surface: 0 0% 100%;
+	--color-surface-hover: 0 0% 96%;
+	--color-surface-elevated: 0 0% 100%;
+	--color-surface-elevated-1: 0 0% 100%;
+	--color-surface-elevated-2: 0 0% 100%;
+	--color-surface-elevated-3: 0 0% 100%;
+	--color-muted: 0 0% 90%;
+	--color-muted-foreground: 0 0% 40%;
+	--color-border: 0 0% 90%;
+	--color-border-strong: 0 0% 80%;
+	--color-error: 6 78% 57%;
+	--color-success: 145 63% 42%;
+	--color-warning: 36 100% 50%;
+	--color-input: 0 0% 100%;
+	--color-ring: 47 95% 58%;
+	--color-card: 0 0% 100%;
+	--color-card-foreground: 0 0% 17%;
+	--color-accent: 0 0% 96%;
+	--color-accent-foreground: 0 0% 17%;
 
-  /* ShadCN-style aliases */
-  --theme-card: hsl(0 0% 100%);
-  --theme-card-foreground: hsl(0 0% 17%);
-  --theme-accent: hsl(0 0% 96%);
-  --theme-accent-foreground: hsl(0 0% 17%);
-
-  /* Legacy aliases */
-  --theme-content: hsl(0 0% 100%);
-  --theme-content-hover: hsl(0 0% 96%);
-  --theme-content-page: hsl(0 0% 87%);
-  --theme-menu: hsl(0 0% 90%);
-  --theme-menu-hover: hsl(0 0% 96%);
-
-  /* Border radius */
-  --radius-sm: 0.25rem;
-  --radius: 0.375rem;
-  --radius-md: 0.5rem;
-  --radius-lg: 0.75rem;
-  --radius-xl: 1rem;
-  --radius-2xl: 1.5rem;
-  --radius-3xl: 2rem;
-
-  /* ShadCN legacy aliases (HSL components for hsl(var()) usage) */
-  --background: 0 0% 87%;
-  --foreground: 0 0% 17%;
-  --primary: 47 95% 58%;
-  --primary-foreground: 0 0% 0%;
-  --secondary: 47 100% 41%;
-  --secondary-foreground: 0 0% 0%;
-  --muted: 0 0% 90%;
-  --muted-foreground: 0 0% 40%;
-  --border: 0 0% 90%;
-  --input: 0 0% 100%;
-  --ring: 47 95% 58%;
-  --card: 0 0% 100%;
-  --card-foreground: 0 0% 17%;
-  --accent: 0 0% 96%;
-  --accent-foreground: 0 0% 17%;
+	/* Border radius (legacy alias used by component utilities below) */
+	--radius-sm: 0.25rem;
+	--radius: 0.375rem;
+	--radius-md: 0.5rem;
+	--radius-lg: 0.75rem;
+	--radius-xl: 1rem;
+	--radius-2xl: 1.5rem;
+	--radius-3xl: 2rem;
 }
 
-/* ===== Dark Mode ===== */
+/* ===== Default Dark Mode ===== */
 .dark,
 :root.dark {
-  /* Override theme values for dark mode */
-  --theme-primary: hsl(47 95% 58%);
-  --theme-primary-foreground: hsl(0 0% 0%);
-  --theme-secondary: hsl(47 70% 29%);
-  --theme-secondary-foreground: hsl(0 0% 100%);
-  --theme-background: hsl(0 0% 6%);
-  --theme-foreground: hsl(0 0% 100%);
-  --theme-surface: hsl(0 0% 12%);
-  --theme-surface-hover: hsl(0 0% 16%);
-  --theme-surface-elevated: hsl(0 0% 14%);
-  /* Elevation system - progressively lighter surfaces for overlays */
-  --theme-surface-elevated-1: hsl(0 0% 16%);
-  --theme-surface-elevated-2: hsl(0 0% 20%);
-  --theme-surface-elevated-3: hsl(0 0% 24%);
-  --theme-muted: hsl(0 0% 20%);
-  --theme-muted-foreground: hsl(0 0% 60%);
-  --theme-border: hsl(0 0% 26%);
-  --theme-border-strong: hsl(0 0% 35%);
-  --theme-error: hsl(6 78% 57%);
-  --theme-success: hsl(145 63% 49%);
-  --theme-warning: hsl(48 100% 50%);
-  --theme-input: hsl(0 0% 14%);
-  --theme-ring: hsl(47 95% 58%);
-
-  /* ShadCN-style aliases */
-  --theme-card: hsl(0 0% 12%);
-  --theme-card-foreground: hsl(0 0% 100%);
-  --theme-accent: hsl(0 0% 16%);
-  --theme-accent-foreground: hsl(0 0% 100%);
-
-  /* Legacy aliases */
-  --theme-content: hsl(0 0% 12%);
-  --theme-content-hover: hsl(0 0% 16%);
-  --theme-content-page: hsl(0 0% 6%);
-  --theme-menu: hsl(0 0% 20%);
-  --theme-menu-hover: hsl(0 0% 16%);
-
-  /* ShadCN legacy aliases (HSL components for hsl(var()) usage) */
-  --background: 0 0% 6%;
-  --foreground: 0 0% 100%;
-  --primary: 47 95% 58%;
-  --primary-foreground: 0 0% 0%;
-  --secondary: 47 70% 29%;
-  --secondary-foreground: 0 0% 100%;
-  --muted: 0 0% 20%;
-  --muted-foreground: 0 0% 60%;
-  --border: 0 0% 26%;
-  --input: 0 0% 14%;
-  --ring: 47 95% 58%;
-  --card: 0 0% 12%;
-  --card-foreground: 0 0% 100%;
-  --accent: 0 0% 16%;
-  --accent-foreground: 0 0% 100%;
+	--color-primary: 47 95% 58%;
+	--color-primary-foreground: 0 0% 0%;
+	--color-secondary: 47 70% 29%;
+	--color-secondary-foreground: 0 0% 100%;
+	--color-background: 0 0% 6%;
+	--color-foreground: 0 0% 100%;
+	--color-surface: 0 0% 12%;
+	--color-surface-hover: 0 0% 16%;
+	--color-surface-elevated: 0 0% 14%;
+	--color-surface-elevated-1: 0 0% 16%;
+	--color-surface-elevated-2: 0 0% 20%;
+	--color-surface-elevated-3: 0 0% 24%;
+	--color-muted: 0 0% 20%;
+	--color-muted-foreground: 0 0% 60%;
+	--color-border: 0 0% 26%;
+	--color-border-strong: 0 0% 35%;
+	--color-error: 6 78% 57%;
+	--color-success: 145 63% 49%;
+	--color-warning: 48 100% 50%;
+	--color-input: 0 0% 14%;
+	--color-ring: 47 95% 58%;
+	--color-card: 0 0% 12%;
+	--color-card-foreground: 0 0% 100%;
+	--color-accent: 0 0% 16%;
+	--color-accent-foreground: 0 0% 100%;
 }
 
 /* ===== Lume Theme (Gold) ===== */
-[data-theme="lume"] {
-  --theme-primary: hsl(47 95% 58%);
-  --theme-primary-foreground: hsl(0 0% 0%);
-  --theme-secondary: hsl(47 100% 41%);
-  --theme-secondary-foreground: hsl(0 0% 0%);
-  --theme-background: hsl(0 0% 87%);
-  --theme-foreground: hsl(0 0% 17%);
-  --theme-surface: hsl(0 0% 100%);
-  --theme-surface-hover: hsl(0 0% 96%);
-  --theme-surface-elevated: hsl(0 0% 100%);
-  --theme-surface-elevated-1: hsl(0 0% 100%);
-  --theme-surface-elevated-2: hsl(0 0% 100%);
-  --theme-surface-elevated-3: hsl(0 0% 100%);
-  --theme-muted: hsl(0 0% 90%);
-  --theme-muted-foreground: hsl(0 0% 40%);
-  --theme-border: hsl(0 0% 90%);
-  --theme-border-strong: hsl(0 0% 80%);
-  --theme-error: hsl(6 78% 57%);
-  --theme-success: hsl(145 63% 42%);
-  --theme-warning: hsl(36 100% 50%);
-  --theme-input: hsl(0 0% 100%);
-  --theme-ring: hsl(47 95% 58%);
-  --theme-card: hsl(0 0% 100%);
-  --theme-card-foreground: hsl(0 0% 17%);
-  --theme-accent: hsl(0 0% 96%);
-  --theme-accent-foreground: hsl(0 0% 17%);
-  --theme-content: hsl(0 0% 100%);
-  --theme-content-hover: hsl(0 0% 96%);
-  --theme-content-page: hsl(0 0% 87%);
-  --theme-menu: hsl(0 0% 90%);
-  --theme-menu-hover: hsl(0 0% 96%);
+[data-theme='lume'] {
+	--color-primary: 47 95% 58%;
+	--color-primary-foreground: 0 0% 0%;
+	--color-secondary: 47 100% 41%;
+	--color-secondary-foreground: 0 0% 0%;
+	--color-background: 0 0% 87%;
+	--color-foreground: 0 0% 17%;
+	--color-surface: 0 0% 100%;
+	--color-surface-hover: 0 0% 96%;
+	--color-surface-elevated: 0 0% 100%;
+	--color-surface-elevated-1: 0 0% 100%;
+	--color-surface-elevated-2: 0 0% 100%;
+	--color-surface-elevated-3: 0 0% 100%;
+	--color-muted: 0 0% 90%;
+	--color-muted-foreground: 0 0% 40%;
+	--color-border: 0 0% 90%;
+	--color-border-strong: 0 0% 80%;
+	--color-error: 6 78% 57%;
+	--color-success: 145 63% 42%;
+	--color-warning: 36 100% 50%;
+	--color-input: 0 0% 100%;
+	--color-ring: 47 95% 58%;
+	--color-card: 0 0% 100%;
+	--color-card-foreground: 0 0% 17%;
+	--color-accent: 0 0% 96%;
+	--color-accent-foreground: 0 0% 17%;
 }
 
-[data-theme="lume"].dark,
-.dark[data-theme="lume"] {
-  --theme-primary: hsl(47 95% 58%);
-  --theme-primary-foreground: hsl(0 0% 0%);
-  --theme-secondary: hsl(47 70% 29%);
-  --theme-secondary-foreground: hsl(0 0% 100%);
-  --theme-background: hsl(0 0% 6%);
-  --theme-foreground: hsl(0 0% 100%);
-  --theme-surface: hsl(0 0% 12%);
-  --theme-surface-hover: hsl(0 0% 16%);
-  --theme-surface-elevated: hsl(0 0% 14%);
-  --theme-surface-elevated-1: hsl(0 0% 16%);
-  --theme-surface-elevated-2: hsl(0 0% 20%);
-  --theme-surface-elevated-3: hsl(0 0% 24%);
-  --theme-muted: hsl(0 0% 20%);
-  --theme-muted-foreground: hsl(0 0% 60%);
-  --theme-border: hsl(0 0% 26%);
-  --theme-border-strong: hsl(0 0% 35%);
-  --theme-error: hsl(6 78% 57%);
-  --theme-success: hsl(145 63% 49%);
-  --theme-warning: hsl(48 100% 50%);
-  --theme-input: hsl(0 0% 14%);
-  --theme-ring: hsl(47 95% 58%);
-  --theme-card: hsl(0 0% 12%);
-  --theme-card-foreground: hsl(0 0% 100%);
-  --theme-accent: hsl(0 0% 16%);
-  --theme-accent-foreground: hsl(0 0% 100%);
-  --theme-content: hsl(0 0% 12%);
-  --theme-content-hover: hsl(0 0% 16%);
-  --theme-content-page: hsl(0 0% 6%);
-  --theme-menu: hsl(0 0% 20%);
-  --theme-menu-hover: hsl(0 0% 16%);
+[data-theme='lume'].dark,
+.dark[data-theme='lume'] {
+	--color-primary: 47 95% 58%;
+	--color-primary-foreground: 0 0% 0%;
+	--color-secondary: 47 70% 29%;
+	--color-secondary-foreground: 0 0% 100%;
+	--color-background: 0 0% 6%;
+	--color-foreground: 0 0% 100%;
+	--color-surface: 0 0% 12%;
+	--color-surface-hover: 0 0% 16%;
+	--color-surface-elevated: 0 0% 14%;
+	--color-surface-elevated-1: 0 0% 16%;
+	--color-surface-elevated-2: 0 0% 20%;
+	--color-surface-elevated-3: 0 0% 24%;
+	--color-muted: 0 0% 20%;
+	--color-muted-foreground: 0 0% 60%;
+	--color-border: 0 0% 26%;
+	--color-border-strong: 0 0% 35%;
+	--color-error: 6 78% 57%;
+	--color-success: 145 63% 49%;
+	--color-warning: 48 100% 50%;
+	--color-input: 0 0% 14%;
+	--color-ring: 47 95% 58%;
+	--color-card: 0 0% 12%;
+	--color-card-foreground: 0 0% 100%;
+	--color-accent: 0 0% 16%;
+	--color-accent-foreground: 0 0% 100%;
 }
 
 /* ===== Nature Theme (Green) ===== */
-[data-theme="nature"] {
-  --theme-primary: hsl(122 39% 49%);
-  --theme-primary-foreground: hsl(0 0% 100%);
-  --theme-secondary: hsl(122 38% 63%);
-  --theme-secondary-foreground: hsl(0 0% 0%);
-  --theme-background: hsl(80 33% 97%);
-  --theme-foreground: hsl(122 56% 24%);
-  --theme-surface: hsl(0 0% 100%);
-  --theme-surface-hover: hsl(120 25% 95%);
-  --theme-surface-elevated: hsl(0 0% 100%);
-  --theme-surface-elevated-1: hsl(0 0% 100%);
-  --theme-surface-elevated-2: hsl(0 0% 100%);
-  --theme-surface-elevated-3: hsl(0 0% 100%);
-  --theme-muted: hsl(120 25% 95%);
-  --theme-muted-foreground: hsl(122 20% 40%);
-  --theme-border: hsl(120 25% 91%);
-  --theme-border-strong: hsl(120 26% 79%);
-  --theme-error: hsl(0 65% 67%);
-  --theme-success: hsl(122 39% 49%);
-  --theme-warning: hsl(36 100% 50%);
-  --theme-input: hsl(0 0% 100%);
-  --theme-ring: hsl(122 39% 49%);
-  --theme-card: hsl(0 0% 100%);
-  --theme-card-foreground: hsl(122 56% 24%);
-  --theme-accent: hsl(120 25% 95%);
-  --theme-accent-foreground: hsl(122 56% 24%);
-  --theme-content: hsl(0 0% 100%);
-  --theme-content-hover: hsl(120 25% 95%);
-  --theme-content-page: hsl(80 33% 97%);
-  --theme-menu: hsl(120 25% 95%);
-  --theme-menu-hover: hsl(120 25% 95%);
+[data-theme='nature'] {
+	--color-primary: 122 39% 49%;
+	--color-primary-foreground: 0 0% 100%;
+	--color-secondary: 122 38% 63%;
+	--color-secondary-foreground: 0 0% 0%;
+	--color-background: 80 33% 97%;
+	--color-foreground: 122 56% 24%;
+	--color-surface: 0 0% 100%;
+	--color-surface-hover: 120 25% 95%;
+	--color-surface-elevated: 0 0% 100%;
+	--color-surface-elevated-1: 0 0% 100%;
+	--color-surface-elevated-2: 0 0% 100%;
+	--color-surface-elevated-3: 0 0% 100%;
+	--color-muted: 120 25% 95%;
+	--color-muted-foreground: 122 20% 40%;
+	--color-border: 120 25% 91%;
+	--color-border-strong: 120 26% 79%;
+	--color-error: 0 65% 67%;
+	--color-success: 122 39% 49%;
+	--color-warning: 36 100% 50%;
+	--color-input: 0 0% 100%;
+	--color-ring: 122 39% 49%;
+	--color-card: 0 0% 100%;
+	--color-card-foreground: 122 56% 24%;
+	--color-accent: 120 25% 95%;
+	--color-accent-foreground: 122 56% 24%;
 }
 
-[data-theme="nature"].dark,
-.dark[data-theme="nature"] {
-  --theme-primary: hsl(122 39% 49%);
-  --theme-primary-foreground: hsl(0 0% 100%);
-  --theme-secondary: hsl(122 30% 35%);
-  --theme-secondary-foreground: hsl(0 0% 100%);
-  --theme-background: hsl(0 0% 7%);
-  --theme-foreground: hsl(0 0% 100%);
-  --theme-surface: hsl(120 10% 12%);
-  --theme-surface-hover: hsl(120 10% 16%);
-  --theme-surface-elevated: hsl(120 10% 14%);
-  --theme-surface-elevated-1: hsl(120 10% 16%);
-  --theme-surface-elevated-2: hsl(120 10% 20%);
-  --theme-surface-elevated-3: hsl(120 10% 24%);
-  --theme-muted: hsl(120 10% 20%);
-  --theme-muted-foreground: hsl(120 10% 60%);
-  --theme-border: hsl(120 10% 25%);
-  --theme-border-strong: hsl(120 10% 35%);
-  --theme-error: hsl(0 65% 57%);
-  --theme-success: hsl(122 50% 55%);
-  --theme-warning: hsl(48 100% 50%);
-  --theme-input: hsl(120 10% 14%);
-  --theme-ring: hsl(122 39% 49%);
-  --theme-card: hsl(120 10% 12%);
-  --theme-card-foreground: hsl(0 0% 100%);
-  --theme-accent: hsl(120 10% 16%);
-  --theme-accent-foreground: hsl(0 0% 100%);
-  --theme-content: hsl(120 10% 12%);
-  --theme-content-hover: hsl(120 10% 16%);
-  --theme-content-page: hsl(0 0% 7%);
-  --theme-menu: hsl(120 10% 20%);
-  --theme-menu-hover: hsl(120 10% 16%);
+[data-theme='nature'].dark,
+.dark[data-theme='nature'] {
+	--color-primary: 122 39% 49%;
+	--color-primary-foreground: 0 0% 100%;
+	--color-secondary: 122 30% 35%;
+	--color-secondary-foreground: 0 0% 100%;
+	--color-background: 0 0% 7%;
+	--color-foreground: 0 0% 100%;
+	--color-surface: 120 10% 12%;
+	--color-surface-hover: 120 10% 16%;
+	--color-surface-elevated: 120 10% 14%;
+	--color-surface-elevated-1: 120 10% 16%;
+	--color-surface-elevated-2: 120 10% 20%;
+	--color-surface-elevated-3: 120 10% 24%;
+	--color-muted: 120 10% 20%;
+	--color-muted-foreground: 120 10% 60%;
+	--color-border: 120 10% 25%;
+	--color-border-strong: 120 10% 35%;
+	--color-error: 0 65% 57%;
+	--color-success: 122 50% 55%;
+	--color-warning: 48 100% 50%;
+	--color-input: 120 10% 14%;
+	--color-ring: 122 39% 49%;
+	--color-card: 120 10% 12%;
+	--color-card-foreground: 0 0% 100%;
+	--color-accent: 120 10% 16%;
+	--color-accent-foreground: 0 0% 100%;
 }
 
 /* ===== Stone Theme (Blue Gray) ===== */
-[data-theme="stone"] {
-  --theme-primary: hsl(200 18% 46%);
-  --theme-primary-foreground: hsl(0 0% 100%);
-  --theme-secondary: hsl(200 15% 62%);
-  --theme-secondary-foreground: hsl(0 0% 0%);
-  --theme-background: hsl(210 17% 97%);
-  --theme-foreground: hsl(200 19% 18%);
-  --theme-surface: hsl(0 0% 100%);
-  --theme-surface-hover: hsl(200 10% 94%);
-  --theme-surface-elevated: hsl(0 0% 100%);
-  --theme-surface-elevated-1: hsl(0 0% 100%);
-  --theme-surface-elevated-2: hsl(0 0% 100%);
-  --theme-surface-elevated-3: hsl(0 0% 100%);
-  --theme-muted: hsl(200 10% 94%);
-  --theme-muted-foreground: hsl(200 10% 45%);
-  --theme-border: hsl(200 10% 88%);
-  --theme-border-strong: hsl(200 12% 75%);
-  --theme-error: hsl(4 90% 63%);
-  --theme-success: hsl(145 63% 42%);
-  --theme-warning: hsl(36 100% 50%);
-  --theme-input: hsl(0 0% 100%);
-  --theme-ring: hsl(200 18% 46%);
-  --theme-card: hsl(0 0% 100%);
-  --theme-card-foreground: hsl(200 19% 18%);
-  --theme-accent: hsl(200 10% 94%);
-  --theme-accent-foreground: hsl(200 19% 18%);
-  --theme-content: hsl(0 0% 100%);
-  --theme-content-hover: hsl(200 10% 94%);
-  --theme-content-page: hsl(210 17% 97%);
-  --theme-menu: hsl(200 10% 94%);
-  --theme-menu-hover: hsl(200 10% 94%);
+[data-theme='stone'] {
+	--color-primary: 200 18% 46%;
+	--color-primary-foreground: 0 0% 100%;
+	--color-secondary: 200 15% 62%;
+	--color-secondary-foreground: 0 0% 0%;
+	--color-background: 210 17% 97%;
+	--color-foreground: 200 19% 18%;
+	--color-surface: 0 0% 100%;
+	--color-surface-hover: 200 10% 94%;
+	--color-surface-elevated: 0 0% 100%;
+	--color-surface-elevated-1: 0 0% 100%;
+	--color-surface-elevated-2: 0 0% 100%;
+	--color-surface-elevated-3: 0 0% 100%;
+	--color-muted: 200 10% 94%;
+	--color-muted-foreground: 200 10% 45%;
+	--color-border: 200 10% 88%;
+	--color-border-strong: 200 12% 75%;
+	--color-error: 4 90% 63%;
+	--color-success: 145 63% 42%;
+	--color-warning: 36 100% 50%;
+	--color-input: 0 0% 100%;
+	--color-ring: 200 18% 46%;
+	--color-card: 0 0% 100%;
+	--color-card-foreground: 200 19% 18%;
+	--color-accent: 200 10% 94%;
+	--color-accent-foreground: 200 19% 18%;
 }
 
-[data-theme="stone"].dark,
-.dark[data-theme="stone"] {
-  --theme-primary: hsl(200 15% 52%);
-  --theme-primary-foreground: hsl(0 0% 0%);
-  --theme-secondary: hsl(200 12% 35%);
-  --theme-secondary-foreground: hsl(0 0% 100%);
-  --theme-background: hsl(0 0% 7%);
-  --theme-foreground: hsl(0 0% 100%);
-  --theme-surface: hsl(200 10% 12%);
-  --theme-surface-hover: hsl(200 10% 16%);
-  --theme-surface-elevated: hsl(200 10% 14%);
-  --theme-surface-elevated-1: hsl(200 10% 16%);
-  --theme-surface-elevated-2: hsl(200 10% 20%);
-  --theme-surface-elevated-3: hsl(200 10% 24%);
-  --theme-muted: hsl(200 10% 20%);
-  --theme-muted-foreground: hsl(200 10% 60%);
-  --theme-border: hsl(200 10% 25%);
-  --theme-border-strong: hsl(200 10% 35%);
-  --theme-error: hsl(4 90% 58%);
-  --theme-success: hsl(145 63% 49%);
-  --theme-warning: hsl(48 100% 50%);
-  --theme-input: hsl(200 10% 14%);
-  --theme-ring: hsl(200 15% 52%);
-  --theme-card: hsl(200 10% 12%);
-  --theme-card-foreground: hsl(0 0% 100%);
-  --theme-accent: hsl(200 10% 16%);
-  --theme-accent-foreground: hsl(0 0% 100%);
-  --theme-content: hsl(200 10% 12%);
-  --theme-content-hover: hsl(200 10% 16%);
-  --theme-content-page: hsl(0 0% 7%);
-  --theme-menu: hsl(200 10% 20%);
-  --theme-menu-hover: hsl(200 10% 16%);
+[data-theme='stone'].dark,
+.dark[data-theme='stone'] {
+	--color-primary: 200 15% 52%;
+	--color-primary-foreground: 0 0% 0%;
+	--color-secondary: 200 12% 35%;
+	--color-secondary-foreground: 0 0% 100%;
+	--color-background: 0 0% 7%;
+	--color-foreground: 0 0% 100%;
+	--color-surface: 200 10% 12%;
+	--color-surface-hover: 200 10% 16%;
+	--color-surface-elevated: 200 10% 14%;
+	--color-surface-elevated-1: 200 10% 16%;
+	--color-surface-elevated-2: 200 10% 20%;
+	--color-surface-elevated-3: 200 10% 24%;
+	--color-muted: 200 10% 20%;
+	--color-muted-foreground: 200 10% 60%;
+	--color-border: 200 10% 25%;
+	--color-border-strong: 200 10% 35%;
+	--color-error: 4 90% 58%;
+	--color-success: 145 63% 49%;
+	--color-warning: 48 100% 50%;
+	--color-input: 200 10% 14%;
+	--color-ring: 200 15% 52%;
+	--color-card: 200 10% 12%;
+	--color-card-foreground: 0 0% 100%;
+	--color-accent: 200 10% 16%;
+	--color-accent-foreground: 0 0% 100%;
 }
 
 /* ===== Ocean Theme (Blue) ===== */
-[data-theme="ocean"] {
-  --theme-primary: hsl(199 98% 45%);
-  --theme-primary-foreground: hsl(0 0% 100%);
-  --theme-secondary: hsl(199 92% 64%);
-  --theme-secondary-foreground: hsl(0 0% 0%);
-  --theme-background: hsl(199 100% 97%);
-  --theme-foreground: hsl(199 100% 18%);
-  --theme-surface: hsl(0 0% 100%);
-  --theme-surface-hover: hsl(199 100% 94%);
-  --theme-surface-elevated: hsl(0 0% 100%);
-  --theme-surface-elevated-1: hsl(0 0% 100%);
-  --theme-surface-elevated-2: hsl(0 0% 100%);
-  --theme-surface-elevated-3: hsl(0 0% 100%);
-  --theme-muted: hsl(199 100% 94%);
-  --theme-muted-foreground: hsl(199 50% 40%);
-  --theme-border: hsl(199 71% 87%);
-  --theme-border-strong: hsl(199 79% 76%);
-  --theme-error: hsl(4 90% 63%);
-  --theme-success: hsl(145 63% 42%);
-  --theme-warning: hsl(36 100% 50%);
-  --theme-input: hsl(0 0% 100%);
-  --theme-ring: hsl(199 98% 45%);
-  --theme-card: hsl(0 0% 100%);
-  --theme-card-foreground: hsl(199 100% 18%);
-  --theme-accent: hsl(199 100% 94%);
-  --theme-accent-foreground: hsl(199 100% 18%);
-  --theme-content: hsl(0 0% 100%);
-  --theme-content-hover: hsl(199 100% 94%);
-  --theme-content-page: hsl(199 100% 97%);
-  --theme-menu: hsl(199 100% 94%);
-  --theme-menu-hover: hsl(199 100% 94%);
+[data-theme='ocean'] {
+	--color-primary: 199 98% 45%;
+	--color-primary-foreground: 0 0% 100%;
+	--color-secondary: 199 92% 64%;
+	--color-secondary-foreground: 0 0% 0%;
+	--color-background: 199 100% 97%;
+	--color-foreground: 199 100% 18%;
+	--color-surface: 0 0% 100%;
+	--color-surface-hover: 199 100% 94%;
+	--color-surface-elevated: 0 0% 100%;
+	--color-surface-elevated-1: 0 0% 100%;
+	--color-surface-elevated-2: 0 0% 100%;
+	--color-surface-elevated-3: 0 0% 100%;
+	--color-muted: 199 100% 94%;
+	--color-muted-foreground: 199 50% 40%;
+	--color-border: 199 71% 87%;
+	--color-border-strong: 199 79% 76%;
+	--color-error: 4 90% 63%;
+	--color-success: 145 63% 42%;
+	--color-warning: 36 100% 50%;
+	--color-input: 0 0% 100%;
+	--color-ring: 199 98% 45%;
+	--color-card: 0 0% 100%;
+	--color-card-foreground: 199 100% 18%;
+	--color-accent: 199 100% 94%;
+	--color-accent-foreground: 199 100% 18%;
 }
 
-[data-theme="ocean"].dark,
-.dark[data-theme="ocean"] {
-  --theme-primary: hsl(199 98% 48%);
-  --theme-primary-foreground: hsl(0 0% 0%);
-  --theme-secondary: hsl(199 60% 35%);
-  --theme-secondary-foreground: hsl(0 0% 100%);
-  --theme-background: hsl(0 0% 7%);
-  --theme-foreground: hsl(0 0% 100%);
-  --theme-surface: hsl(199 30% 12%);
-  --theme-surface-hover: hsl(199 30% 16%);
-  --theme-surface-elevated: hsl(199 30% 14%);
-  --theme-surface-elevated-1: hsl(199 30% 16%);
-  --theme-surface-elevated-2: hsl(199 30% 20%);
-  --theme-surface-elevated-3: hsl(199 30% 24%);
-  --theme-muted: hsl(199 20% 20%);
-  --theme-muted-foreground: hsl(199 20% 60%);
-  --theme-border: hsl(199 20% 25%);
-  --theme-border-strong: hsl(199 20% 35%);
-  --theme-error: hsl(4 90% 58%);
-  --theme-success: hsl(145 63% 49%);
-  --theme-warning: hsl(48 100% 50%);
-  --theme-input: hsl(199 30% 14%);
-  --theme-ring: hsl(199 98% 48%);
-  --theme-card: hsl(199 30% 12%);
-  --theme-card-foreground: hsl(0 0% 100%);
-  --theme-accent: hsl(199 30% 16%);
-  --theme-accent-foreground: hsl(0 0% 100%);
-  --theme-content: hsl(199 30% 12%);
-  --theme-content-hover: hsl(199 30% 16%);
-  --theme-content-page: hsl(0 0% 7%);
-  --theme-menu: hsl(199 20% 20%);
-  --theme-menu-hover: hsl(199 30% 16%);
+[data-theme='ocean'].dark,
+.dark[data-theme='ocean'] {
+	--color-primary: 199 98% 48%;
+	--color-primary-foreground: 0 0% 0%;
+	--color-secondary: 199 60% 35%;
+	--color-secondary-foreground: 0 0% 100%;
+	--color-background: 0 0% 7%;
+	--color-foreground: 0 0% 100%;
+	--color-surface: 199 30% 12%;
+	--color-surface-hover: 199 30% 16%;
+	--color-surface-elevated: 199 30% 14%;
+	--color-surface-elevated-1: 199 30% 16%;
+	--color-surface-elevated-2: 199 30% 20%;
+	--color-surface-elevated-3: 199 30% 24%;
+	--color-muted: 199 20% 20%;
+	--color-muted-foreground: 199 20% 60%;
+	--color-border: 199 20% 25%;
+	--color-border-strong: 199 20% 35%;
+	--color-error: 4 90% 58%;
+	--color-success: 145 63% 49%;
+	--color-warning: 48 100% 50%;
+	--color-input: 199 30% 14%;
+	--color-ring: 199 98% 48%;
+	--color-card: 199 30% 12%;
+	--color-card-foreground: 0 0% 100%;
+	--color-accent: 199 30% 16%;
+	--color-accent-foreground: 0 0% 100%;
 }
 
-/* ===== Dark mode via media query (fallback) ===== */
+/* ===== Dark mode via media query (fallback for users without explicit preference) ===== */
 @media (prefers-color-scheme: dark) {
-  :root:not(.dark):not([data-theme]) {
-    --theme-primary: hsl(47 95% 58%);
-    --theme-primary-foreground: hsl(0 0% 0%);
-    --theme-secondary: hsl(47 70% 29%);
-    --theme-secondary-foreground: hsl(0 0% 100%);
-    --theme-background: hsl(0 0% 6%);
-    --theme-foreground: hsl(0 0% 100%);
-    --theme-surface: hsl(0 0% 12%);
-    --theme-surface-hover: hsl(0 0% 16%);
-    --theme-surface-elevated: hsl(0 0% 14%);
-    --theme-surface-elevated-1: hsl(0 0% 16%);
-    --theme-surface-elevated-2: hsl(0 0% 20%);
-    --theme-surface-elevated-3: hsl(0 0% 24%);
-    --theme-muted: hsl(0 0% 20%);
-    --theme-muted-foreground: hsl(0 0% 60%);
-    --theme-border: hsl(0 0% 26%);
-    --theme-border-strong: hsl(0 0% 35%);
-    --theme-error: hsl(6 78% 57%);
-    --theme-success: hsl(145 63% 49%);
-    --theme-warning: hsl(48 100% 50%);
-    --theme-input: hsl(0 0% 14%);
-    --theme-ring: hsl(47 95% 58%);
-    --theme-card: hsl(0 0% 12%);
-    --theme-card-foreground: hsl(0 0% 100%);
-    --theme-accent: hsl(0 0% 16%);
-    --theme-accent-foreground: hsl(0 0% 100%);
-    --theme-content: hsl(0 0% 12%);
-    --theme-content-hover: hsl(0 0% 16%);
-    --theme-content-page: hsl(0 0% 6%);
-    --theme-menu: hsl(0 0% 20%);
-    --theme-menu-hover: hsl(0 0% 16%);
-  }
+	:root:not(.dark):not([data-theme]) {
+		--color-primary: 47 95% 58%;
+		--color-primary-foreground: 0 0% 0%;
+		--color-secondary: 47 70% 29%;
+		--color-secondary-foreground: 0 0% 100%;
+		--color-background: 0 0% 6%;
+		--color-foreground: 0 0% 100%;
+		--color-surface: 0 0% 12%;
+		--color-surface-hover: 0 0% 16%;
+		--color-surface-elevated: 0 0% 14%;
+		--color-surface-elevated-1: 0 0% 16%;
+		--color-surface-elevated-2: 0 0% 20%;
+		--color-surface-elevated-3: 0 0% 24%;
+		--color-muted: 0 0% 20%;
+		--color-muted-foreground: 0 0% 60%;
+		--color-border: 0 0% 26%;
+		--color-border-strong: 0 0% 35%;
+		--color-error: 6 78% 57%;
+		--color-success: 145 63% 49%;
+		--color-warning: 48 100% 50%;
+		--color-input: 0 0% 14%;
+		--color-ring: 47 95% 58%;
+		--color-card: 0 0% 12%;
+		--color-card-foreground: 0 0% 100%;
+		--color-accent: 0 0% 16%;
+		--color-accent-foreground: 0 0% 100%;
+	}
 }
 
 /* ===== Base Styles ===== */
 @layer base {
-  * {
-    border-color: var(--color-border);
-  }
+	* {
+		border-color: hsl(var(--color-border));
+	}
 
-  body {
-    background-color: var(--color-background);
-    color: var(--color-foreground);
-    font-family: 'Inter', system-ui, -apple-system, sans-serif;
-  }
+	body {
+		background-color: hsl(var(--color-background));
+		color: hsl(var(--color-foreground));
+		font-family: 'Inter', system-ui, -apple-system, sans-serif;
+	}
 
-  /* Smooth color transitions for theme switching */
-  html {
-    color-scheme: light;
-  }
-
-  html.dark {
-    color-scheme: dark;
-  }
+	html {
+		color-scheme: light;
+	}
+	html.dark {
+		color-scheme: dark;
+	}
 }
 
 /* ===== Component Utilities ===== */
 @layer components {
-  /* Primary Button */
-  .btn-primary {
-    background-color: var(--color-primary);
-    color: var(--color-primary-foreground);
-    padding: 0.5rem 1rem;
-    border-radius: var(--radius-md);
-    font-weight: 500;
-    transition: all 0.2s ease;
-  }
+	/* Primary Button */
+	.btn-primary {
+		background-color: hsl(var(--color-primary));
+		color: hsl(var(--color-primary-foreground));
+		padding: 0.5rem 1rem;
+		border-radius: var(--radius-md);
+		font-weight: 500;
+		transition: all 0.2s ease;
+	}
+	.btn-primary:hover {
+		filter: brightness(0.9);
+	}
+	.btn-primary:focus-visible {
+		outline: 2px solid hsl(var(--color-ring));
+		outline-offset: 2px;
+	}
 
-  .btn-primary:hover {
-    filter: brightness(0.9);
-  }
+	/* Secondary Button */
+	.btn-secondary {
+		background-color: hsl(var(--color-secondary));
+		color: hsl(var(--color-secondary-foreground));
+		padding: 0.5rem 1rem;
+		border-radius: var(--radius-md);
+		font-weight: 500;
+		transition: all 0.2s ease;
+	}
+	.btn-secondary:hover {
+		filter: brightness(0.95);
+	}
 
-  .btn-primary:focus-visible {
-    outline: 2px solid var(--color-ring);
-    outline-offset: 2px;
-  }
+	/* Ghost Button */
+	.btn-ghost {
+		background-color: transparent;
+		color: hsl(var(--color-foreground));
+		padding: 0.5rem 1rem;
+		border-radius: var(--radius-md);
+		font-weight: 500;
+		transition: all 0.2s ease;
+	}
+	.btn-ghost:hover {
+		background-color: hsl(var(--color-surface-hover));
+	}
 
-  /* Secondary Button */
-  .btn-secondary {
-    background-color: var(--color-secondary);
-    color: var(--color-secondary-foreground);
-    padding: 0.5rem 1rem;
-    border-radius: var(--radius-md);
-    font-weight: 500;
-    transition: all 0.2s ease;
-  }
+	/* Card */
+	.card {
+		background-color: hsl(var(--color-surface));
+		border: 1px solid hsl(var(--color-border));
+		border-radius: var(--radius-lg);
+		padding: 1rem;
+	}
+	.card-elevated {
+		background-color: hsl(var(--color-surface-elevated));
+		box-shadow: 0 4px 6px -1px rgb(0 0 0 / 0.1), 0 2px 4px -2px rgb(0 0 0 / 0.1);
+	}
 
-  .btn-secondary:hover {
-    filter: brightness(0.95);
-  }
+	/* Input */
+	.input {
+		background-color: hsl(var(--color-input));
+		border: 1px solid hsl(var(--color-border));
+		border-radius: var(--radius-md);
+		padding: 0.5rem 0.75rem;
+		color: hsl(var(--color-foreground));
+		transition: border-color 0.2s ease, box-shadow 0.2s ease;
+	}
+	.input:focus {
+		border-color: hsl(var(--color-ring));
+		box-shadow: 0 0 0 2px hsl(var(--color-ring) / 0.2);
+		outline: none;
+	}
+	.input::placeholder {
+		color: hsl(var(--color-muted-foreground));
+	}
 
-  /* Ghost Button */
-  .btn-ghost {
-    background-color: transparent;
-    color: var(--color-foreground);
-    padding: 0.5rem 1rem;
-    border-radius: var(--radius-md);
-    font-weight: 500;
-    transition: all 0.2s ease;
-  }
-
-  .btn-ghost:hover {
-    background-color: var(--color-surface-hover);
-  }
-
-  /* Card */
-  .card {
-    background-color: var(--color-surface);
-    border: 1px solid var(--color-border);
-    border-radius: var(--radius-lg);
-    padding: 1rem;
-  }
-
-  .card-elevated {
-    background-color: var(--color-surface-elevated);
-    box-shadow: 0 4px 6px -1px rgb(0 0 0 / 0.1), 0 2px 4px -2px rgb(0 0 0 / 0.1);
-  }
-
-  /* Input */
-  .input {
-    background-color: var(--color-input);
-    border: 1px solid var(--color-border);
-    border-radius: var(--radius-md);
-    padding: 0.5rem 0.75rem;
-    color: var(--color-foreground);
-    transition: border-color 0.2s ease, box-shadow 0.2s ease;
-  }
-
-  .input:focus {
-    border-color: var(--color-ring);
-    box-shadow: 0 0 0 2px color-mix(in srgb, var(--color-ring) 20%, transparent);
-    outline: none;
-  }
-
-  .input::placeholder {
-    color: var(--color-muted-foreground);
-  }
-
-  /* Badge */
-  .badge {
-    display: inline-flex;
-    align-items: center;
-    padding: 0.25rem 0.5rem;
-    border-radius: var(--radius);
-    font-size: 0.75rem;
-    font-weight: 500;
-    background-color: var(--color-muted);
-    color: var(--color-muted-foreground);
-  }
-
-  .badge-primary {
-    background-color: color-mix(in srgb, var(--color-primary) 10%, transparent);
-    color: var(--color-primary);
-  }
-
-  .badge-success {
-    background-color: color-mix(in srgb, var(--color-success) 10%, transparent);
-    color: var(--color-success);
-  }
-
-  .badge-error {
-    background-color: color-mix(in srgb, var(--color-error) 10%, transparent);
-    color: var(--color-error);
-  }
-
-  .badge-warning {
-    background-color: color-mix(in srgb, var(--color-warning) 10%, transparent);
-    color: var(--color-warning);
-  }
+	/* Badge */
+	.badge {
+		display: inline-flex;
+		align-items: center;
+		padding: 0.25rem 0.5rem;
+		border-radius: var(--radius);
+		font-size: 0.75rem;
+		font-weight: 500;
+		background-color: hsl(var(--color-muted));
+		color: hsl(var(--color-muted-foreground));
+	}
+	.badge-primary {
+		background-color: hsl(var(--color-primary) / 0.1);
+		color: hsl(var(--color-primary));
+	}
+	.badge-success {
+		background-color: hsl(var(--color-success) / 0.1);
+		color: hsl(var(--color-success));
+	}
+	.badge-error {
+		background-color: hsl(var(--color-error) / 0.1);
+		color: hsl(var(--color-error));
+	}
+	.badge-warning {
+		background-color: hsl(var(--color-warning) / 0.1);
+		color: hsl(var(--color-warning));
+	}
 }
diff --git a/services/mana-analytics/package.json b/services/mana-analytics/package.json
index d66562e98..3ffd4637a 100644
--- a/services/mana-analytics/package.json
+++ b/services/mana-analytics/package.json
@@ -10,6 +10,7 @@
 		"db:studio": "drizzle-kit studio"
 	},
 	"dependencies": {
+		"@mana/shared-hono": "workspace:*",
 		"hono": "^4.7.0",
 		"drizzle-orm": "^0.38.3",
 		"postgres": "^3.4.5",
diff --git a/services/mana-analytics/src/index.ts b/services/mana-analytics/src/index.ts
index 7f7fe4898..e8e5fd12b 100644
--- a/services/mana-analytics/src/index.ts
+++ b/services/mana-analytics/src/index.ts
@@ -9,7 +9,7 @@ import { Hono } from 'hono';
 import { cors } from 'hono/cors';
 import { loadConfig } from './config';
 import { getDb } from './db/connection';
-import { errorHandler } from './middleware/error-handler';
+import { serviceErrorHandler as errorHandler } from '@mana/shared-hono';
 import { jwtAuth } from './middleware/jwt-auth';
 import { FeedbackService } from './services/feedback';
 import { healthRoutes } from './routes/health';
diff --git a/services/mana-analytics/src/middleware/error-handler.ts b/services/mana-analytics/src/middleware/error-handler.ts
deleted file mode 100644
index cec6640e8..000000000
--- a/services/mana-analytics/src/middleware/error-handler.ts
+++ /dev/null
@@ -1,29 +0,0 @@
-/**
- * Global error handler middleware for Hono.
- */
-
-import type { ErrorHandler } from 'hono';
-import { HTTPException } from 'hono/http-exception';
-
-export const errorHandler: ErrorHandler = (err, c) => {
-	if (err instanceof HTTPException) {
-		const cause = err.cause as Record<string, unknown> | undefined;
-		return c.json(
-			{
-				statusCode: err.status,
-				message: err.message,
-				...(cause ? { details: cause } : {}),
-			},
-			err.status
-		);
-	}
-
-	console.error('Unhandled error:', err);
-	return c.json(
-		{
-			statusCode: 500,
-			message: 'Internal server error',
-		},
-		500
-	);
-};
diff --git a/services/mana-auth/package.json b/services/mana-auth/package.json
index f77248638..6da294242 100644
--- a/services/mana-auth/package.json
+++ b/services/mana-auth/package.json
@@ -12,6 +12,7 @@
 		"db:studio": "drizzle-kit studio"
 	},
 	"dependencies": {
+		"@mana/shared-hono": "workspace:*",
 		"hono": "^4.7.0",
 		"better-auth": "^1.4.3",
 		"drizzle-orm": "^0.38.3",
diff --git a/services/mana-auth/src/auth/better-auth.config.ts b/services/mana-auth/src/auth/better-auth.config.ts
index 1494de1e8..2181958f3 100644
--- a/services/mana-auth/src/auth/better-auth.config.ts
+++ b/services/mana-auth/src/auth/better-auth.config.ts
@@ -38,6 +38,33 @@ import {
 } from '../email/send';
 import { sourceAppStore, passwordResetRedirectStore } from './stores';
 
+/**
+ * Single source of truth for SSO trusted origins.
+ *
+ * Better Auth rejects any cross-origin auth request whose Origin header
+ * isn't in this list — silent login failure on mis-configured apps. When
+ * adding a new top-level domain (NOT a path under mana.how), update both:
+ *
+ *   1. This array
+ *   2. The `mana-auth` `CORS_ORIGINS` env var in
+ *      `docker-compose.macmini.yml` (must be a superset of this list)
+ *
+ * `sso-config.spec.ts` enforces both invariants. The unified app under
+ * `mana.how` does NOT need per-module subdomains here — modules are routed
+ * by path on the same origin.
+ */
+export const TRUSTED_ORIGINS: string[] = [
+	// Unified app — all productivity apps live under mana.how
+	'https://mana.how',
+	'https://auth.mana.how',
+	// Separate apps (not part of the unified app)
+	'https://arcade.mana.how', // Games
+	'https://whopxl.mana.how', // Games
+	// Local development
+	'http://localhost:3001',
+	'http://localhost:5173',
+];
+
 /**
  * JWT Custom Payload Interface
  *
@@ -240,17 +267,8 @@ export function createBetterAuth(databaseUrl: string) {
 		// Better Auth will reject cross-origin requests with credentials.
 		// When adding a new app, add its production domain here AND to
 		// CORS_ORIGINS in docker-compose.macmini.yml.
-		trustedOrigins: [
-			// Unified app — all productivity apps are now under mana.how
-			'https://mana.how',
-			'https://auth.mana.how',
-			// Separate apps (not part of unified app)
-			'https://arcade.mana.how', // Games
-			'https://whopxl.mana.how', // Games
-			// Local development
-			'http://localhost:3001',
-			'http://localhost:5173',
-		],
+		// Single source of truth: TRUSTED_ORIGINS (exported below).
+		trustedOrigins: TRUSTED_ORIGINS,
 
 		// Plugins
 		plugins: [
diff --git a/services/mana-auth/src/index.ts b/services/mana-auth/src/index.ts
index 9d5c6a47d..5d7296ee2 100644
--- a/services/mana-auth/src/index.ts
+++ b/services/mana-auth/src/index.ts
@@ -10,7 +10,7 @@ import { cors } from 'hono/cors';
 import { loadConfig } from './config';
 import { getDb } from './db/connection';
 import { createBetterAuth } from './auth/better-auth.config';
-import { errorHandler } from './middleware/error-handler';
+import { serviceErrorHandler as errorHandler } from '@mana/shared-hono';
 import { jwtAuth } from './middleware/jwt-auth';
 import { serviceAuth } from './middleware/service-auth';
 import { SecurityEventsService, AccountLockoutService } from './services/security';
diff --git a/services/mana-auth/src/middleware/error-handler.ts b/services/mana-auth/src/middleware/error-handler.ts
deleted file mode 100644
index cec6640e8..000000000
--- a/services/mana-auth/src/middleware/error-handler.ts
+++ /dev/null
@@ -1,29 +0,0 @@
-/**
- * Global error handler middleware for Hono.
- */
-
-import type { ErrorHandler } from 'hono';
-import { HTTPException } from 'hono/http-exception';
-
-export const errorHandler: ErrorHandler = (err, c) => {
-	if (err instanceof HTTPException) {
-		const cause = err.cause as Record<string, unknown> | undefined;
-		return c.json(
-			{
-				statusCode: err.status,
-				message: err.message,
-				...(cause ? { details: cause } : {}),
-			},
-			err.status
-		);
-	}
-
-	console.error('Unhandled error:', err);
-	return c.json(
-		{
-			statusCode: 500,
-			message: 'Internal server error',
-		},
-		500
-	);
-};
diff --git a/services/mana-credits/package.json b/services/mana-credits/package.json
index 2a689a148..35467acf1 100644
--- a/services/mana-credits/package.json
+++ b/services/mana-credits/package.json
@@ -11,6 +11,7 @@
 		"db:studio": "drizzle-kit studio"
 	},
 	"dependencies": {
+		"@mana/shared-hono": "workspace:*",
 		"hono": "^4.7.0",
 		"drizzle-orm": "^0.38.3",
 		"postgres": "^3.4.5",
diff --git a/services/mana-credits/src/index.ts b/services/mana-credits/src/index.ts
index 10eea80f7..78e996081 100644
--- a/services/mana-credits/src/index.ts
+++ b/services/mana-credits/src/index.ts
@@ -9,7 +9,7 @@ import { Hono } from 'hono';
 import { cors } from 'hono/cors';
 import { loadConfig } from './config';
 import { getDb } from './db/connection';
-import { errorHandler } from './middleware/error-handler';
+import { serviceErrorHandler as errorHandler } from '@mana/shared-hono';
 import { jwtAuth } from './middleware/jwt-auth';
 import { serviceAuth } from './middleware/service-auth';
 import { StripeService } from './services/stripe';
diff --git a/services/mana-credits/src/middleware/error-handler.ts b/services/mana-credits/src/middleware/error-handler.ts
deleted file mode 100644
index cec6640e8..000000000
--- a/services/mana-credits/src/middleware/error-handler.ts
+++ /dev/null
@@ -1,29 +0,0 @@
-/**
- * Global error handler middleware for Hono.
- */
-
-import type { ErrorHandler } from 'hono';
-import { HTTPException } from 'hono/http-exception';
-
-export const errorHandler: ErrorHandler = (err, c) => {
-	if (err instanceof HTTPException) {
-		const cause = err.cause as Record<string, unknown> | undefined;
-		return c.json(
-			{
-				statusCode: err.status,
-				message: err.message,
-				...(cause ? { details: cause } : {}),
-			},
-			err.status
-		);
-	}
-
-	console.error('Unhandled error:', err);
-	return c.json(
-		{
-			statusCode: 500,
-			message: 'Internal server error',
-		},
-		500
-	);
-};
diff --git a/services/mana-subscriptions/package.json b/services/mana-subscriptions/package.json
index 20b8f779b..70f5fa9f6 100644
--- a/services/mana-subscriptions/package.json
+++ b/services/mana-subscriptions/package.json
@@ -11,6 +11,7 @@
 		"db:seed": "bun run src/db/seed.ts"
 	},
 	"dependencies": {
+		"@mana/shared-hono": "workspace:*",
 		"hono": "^4.7.0",
 		"drizzle-orm": "^0.38.3",
 		"postgres": "^3.4.5",
diff --git a/services/mana-subscriptions/src/index.ts b/services/mana-subscriptions/src/index.ts
index 33df4cb6d..1b6ef47ef 100644
--- a/services/mana-subscriptions/src/index.ts
+++ b/services/mana-subscriptions/src/index.ts
@@ -9,7 +9,7 @@ import { Hono } from 'hono';
 import { cors } from 'hono/cors';
 import { loadConfig } from './config';
 import { getDb } from './db/connection';
-import { errorHandler } from './middleware/error-handler';
+import { serviceErrorHandler as errorHandler } from '@mana/shared-hono';
 import { jwtAuth } from './middleware/jwt-auth';
 import { serviceAuth } from './middleware/service-auth';
 import { StripeService } from './services/stripe';
diff --git a/services/mana-subscriptions/src/middleware/error-handler.ts b/services/mana-subscriptions/src/middleware/error-handler.ts
deleted file mode 100644
index cec6640e8..000000000
--- a/services/mana-subscriptions/src/middleware/error-handler.ts
+++ /dev/null
@@ -1,29 +0,0 @@
-/**
- * Global error handler middleware for Hono.
- */
-
-import type { ErrorHandler } from 'hono';
-import { HTTPException } from 'hono/http-exception';
-
-export const errorHandler: ErrorHandler = (err, c) => {
-	if (err instanceof HTTPException) {
-		const cause = err.cause as Record<string, unknown> | undefined;
-		return c.json(
-			{
-				statusCode: err.status,
-				message: err.message,
-				...(cause ? { details: cause } : {}),
-			},
-			err.status
-		);
-	}
-
-	console.error('Unhandled error:', err);
-	return c.json(
-		{
-			statusCode: 500,
-			message: 'Internal server error',
-		},
-		500
-	);
-};
diff --git a/services/mana-user/package.json b/services/mana-user/package.json
index ca5dbecb6..9fe87db83 100644
--- a/services/mana-user/package.json
+++ b/services/mana-user/package.json
@@ -11,6 +11,7 @@
 		"db:studio": "drizzle-kit studio"
 	},
 	"dependencies": {
+		"@mana/shared-hono": "workspace:*",
 		"hono": "^4.7.0",
 		"drizzle-orm": "^0.38.3",
 		"postgres": "^3.4.5",
diff --git a/services/mana-user/src/index.ts b/services/mana-user/src/index.ts
index 3a8267f24..234fe1777 100644
--- a/services/mana-user/src/index.ts
+++ b/services/mana-user/src/index.ts
@@ -9,7 +9,7 @@ import { Hono } from 'hono';
 import { cors } from 'hono/cors';
 import { loadConfig } from './config';
 import { getDb } from './db/connection';
-import { errorHandler } from './middleware/error-handler';
+import { serviceErrorHandler as errorHandler } from '@mana/shared-hono';
 import { jwtAuth } from './middleware/jwt-auth';
 import { TagsService } from './services/tags';
 import { SettingsService } from './services/settings';
diff --git a/services/mana-user/src/middleware/error-handler.ts b/services/mana-user/src/middleware/error-handler.ts
deleted file mode 100644
index cec6640e8..000000000
--- a/services/mana-user/src/middleware/error-handler.ts
+++ /dev/null
@@ -1,29 +0,0 @@
-/**
- * Global error handler middleware for Hono.
- */
-
-import type { ErrorHandler } from 'hono';
-import { HTTPException } from 'hono/http-exception';
-
-export const errorHandler: ErrorHandler = (err, c) => {
-	if (err instanceof HTTPException) {
-		const cause = err.cause as Record<string, unknown> | undefined;
-		return c.json(
-			{
-				statusCode: err.status,
-				message: err.message,
-				...(cause ? { details: cause } : {}),
-			},
-			err.status
-		);
-	}
-
-	console.error('Unhandled error:', err);
-	return c.json(
-		{
-			statusCode: 500,
-			message: 'Internal server error',
-		},
-		500
-	);
-};