managarten/games/figgos/CLAUDE.md
Till-JS 05d074c57e 🔧 refactor(figgos): restructure to standard monorepo pattern
Migrate figgos from single Expo app to multi-app monorepo structure:
- Move mobile app to apps/mobile/
- Add apps/web/ (SvelteKit) and apps/backend/ (NestJS) scaffolds
- Add packages/shared/ for shared types and constants
- Update root package.json with new dev commands
- Temporarily skip type-check (run pnpm install first)

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude <noreply@anthropic.com>
2025-12-04 17:27:15 +01:00

2.1 KiB

Figgos

A collectible figure game where users create and collect AI-generated fantasy figures.

Project Structure

games/figgos/
├── apps/
│   ├── mobile/         # @figgos/mobile - Expo React Native app
│   ├── web/            # @figgos/web - SvelteKit web app (planned)
│   └── backend/        # @figgos/backend - NestJS API (planned)
├── packages/
│   └── shared/         # @figgos/shared - Shared types & constants (planned)
├── package.json
├── pnpm-workspace.yaml
└── turbo.json

Development Commands

# From monorepo root:
pnpm dev:figgos:mobile       # Start mobile app
pnpm dev:figgos:web          # Start web app (when available)
pnpm dev:figgos:backend      # Start backend (when available)
pnpm dev:figgos:app          # Start web + backend together

# Database (when backend is available)
pnpm figgos:db:push          # Push schema to database
pnpm figgos:db:studio        # Open Drizzle Studio

Technology Stack

Mobile App

  • React Native 0.76 + Expo SDK 52
  • Expo Router (file-based routing)
  • NativeWind (Tailwind for React Native)
  • Supabase (currently, migrating to Mana Core Auth)

Web App (Planned)

  • SvelteKit 2.x + Svelte 5
  • Tailwind CSS
  • Mana Core Auth integration

Backend (Planned)

  • NestJS 11
  • Drizzle ORM + PostgreSQL
  • OpenAI API for figure generation
  • S3-compatible storage (MinIO/Hetzner)

Ports

App Port
Web 5181
Backend 3012

Environment Variables

Backend

PORT=3012
DATABASE_URL=postgresql://manacore:devpassword@localhost:5432/figgos
MANA_CORE_AUTH_URL=http://localhost:3001
OPENAI_API_KEY=...
S3_ENDPOINT=http://localhost:9000
S3_BUCKET=figgos-storage

Web

PUBLIC_FIGGOS_API_URL=http://localhost:3012
PUBLIC_MANA_CORE_AUTH_URL=http://localhost:3001

Game Concept

  • Users create fantasy figures by providing a subject/prompt
  • AI generates character info (description, lore, items)
  • AI generates the figure image
  • Figures have rarities: common, rare, epic, legendary
  • Users can browse public figures, like them, and collect their own