AGENTS.md

1# Project Overview
2 
3**Party Battle** is a real-time multiplayer game platform built as an npm workspace with distinct backend and frontend packages. The architecture supports multiple mini-games (Potato, Snake, Pick-Cards) with live player interactions via WebSocket connections.
4 
5### Architecture
6 
7- **Backend** (`backend-party-battle`): Node.js server with Colyseus game rooms
8- **Frontend** (`frontend-party-battle`): Expo/React Native mobile app
9- **Shared Types** (`types-party-battle`): Shared TypeScript schemas and configs between frontend and backend
10 
11### Core Technologies
12 
13- **Real-time Engine**: Colyseus for authoritative server game rooms
14- **Frontend Framework**: Expo SDK with React Native
15- **Styling**: NativeWind (Tailwind CSS for React Native)
16- **UI Components**: GlueStack UI component library (V3)
17 
18## Setup
19 
20### Workspace Installation
21 
22```bash
23npm ci
24 
25# Build shared types first
26npm run build --workspace=types-party-battle
27```
28 
29### Development Environment
30 
31```bash
32# Start backend development server (stays open until canceled)
33npm run dev --workspace=backend-party-battle
34 
35# Start frontend development server (stays open until canceled)
36npm run start --workspace=frontend-party-battle
37```
38 
39## Test, Lint & Type check
40 
41```bash
42npm test
43
44npm run lint
45npm run lint:fix
46
47npm run check-types
48```
49 
50## PR instructions
51 
52- This project uses the Release-Please commit style.
53- PR Title format: type: description
54 
55types
56 
57- `feat`: New features
58- `fix`: Bug fixes
59- `deps`: Dependencies
60 
61## Coding Guidelines
62 
63- NEVER write comments in code. Write self-documenting code instead!
64- Use existing UI components if possible. If no matching component is available, copy one from gluestack ui v3 into the components/ui directory
65- Prefer tailwind over custom style props
66- React Native does not support all features which are available in web browsers
67