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

84 lines
2.1 KiB
Markdown

# 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
```bash
# 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
```env
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
```env
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