till/managarten
1
0
Fork 0
mirror of https://github.com/Memo-2023/mana-monorepo.git synced 2026-05-14 21:41:09 +02:00
Code Issues Projects Releases Packages Wiki Activity Actions 4
managarten/apps/chat/CLAUDE.md
Wuesteon ff80aeec1f refactor: restructure 
monorepo with apps/ and services/
  directories
2025-11-26 03:03:24 +01:00

3.8 KiB
Raw Blame History

Chat Project Guide

Project Structure

apps/chat/
├── apps/
│   ├── backend/      # NestJS API server (@chat/backend)
│   ├── 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

Commands

Root Level

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:backend            # Start backend server

Mobile App (chat/apps/mobile)

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

Backend (apps/chat/apps/backend)

pnpm start:dev                   # Start with hot reload
pnpm build                       # Build for production
pnpm start:prod                  # Start production server

Web App (chat/apps/web)

pnpm dev                         # Start dev server
pnpm build                       # Build for production
pnpm preview                     # Preview production build

Landing Page (chat/apps/landing)

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
  • Backend: NestJS 10, Azure OpenAI, Supabase
  • Types: TypeScript 5.x

Architecture

Backend API Endpoints

Endpoint Method Description
/api/health GET Health check
/api/chat/models GET List available AI models
/api/chat/completions POST Create chat completion
/api/conversations GET List user conversations
/api/conversations/:id GET Get conversation details
/api/conversations/:id/messages GET Get conversation messages
/api/conversations POST Create new conversation
/api/conversations/:id/messages POST Add message to conversation

Environment Variables

Backend (.env)

AZURE_OPENAI_ENDPOINT=https://...
AZURE_OPENAI_API_KEY=...
AZURE_OPENAI_API_VERSION=2024-12-01-preview
SUPABASE_URL=https://...
SUPABASE_SERVICE_KEY=...
PORT=3001

Mobile (.env)

EXPO_PUBLIC_SUPABASE_URL=https://...
EXPO_PUBLIC_SUPABASE_ANON_KEY=...
EXPO_PUBLIC_BACKEND_URL=http://localhost:3001

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

Model ID Name Description
550e8400-e29b-41d4-a716-446655440000 GPT-O3-Mini Fast, efficient responses
550e8400-e29b-41d4-a716-446655440004 GPT-4o-Mini Compact, powerful
550e8400-e29b-41d4-a716-446655440005 GPT-4o Most advanced

Important Notes

  1. Security: API keys are stored in the backend only - never in client apps
  2. Authentication: Uses Supabase Auth, shared with Mana Core ecosystem
  3. Database: Supabase PostgreSQL with RLS policies
  4. Deployment: Backend runs on port 3001 by default