How dani-8/devgarden works
DevGarden is a multiplayer pixel-art greenhouse game. Players authenticate with GitHub, enter the game world, interact with other players and garden features, and earn progression from GitHub activity or coding challenges. The frontend combines React interface components with Phaser game scenes; an Express backend serves authentication and feature APIs, while Socket.IO/Supabase support multiplayer state and Supabase stores persistent data. The README documents major capabilities not fully sampled; links to those features are limited to documented or indexed relationships.
Main entry points: App.tsx App shell · authRoutes.ts Auth routes · apiRoutes.ts Feature API · GameContainer.tsx Game container
Components 34
Client experience
- App shell
frontend/src/App.tsx - Login UI
frontend/src/components/auth/LoginView.tsx - Sidebar profile
frontend/src/components/layout/Sidebar.tsx - Chat and emotes
frontend/src/components/chat/ChatBar.tsx - Leaderboard
frontend/src/components/leaderboard/Leaderboard.tsx - Profile card
frontend/src/components/profile/ProfileCard.tsx - Challenge interface
frontend/src/components/modals/ChallengeModal.tsx - Decor hotbar
frontend/src/components/decor/DecorHotbar.tsx - Cafe boards
frontend/src/components/modals/CafeCollabModal.tsx
Game world
- Game container
frontend/src/game/GameContainer.tsx - Cafe scene
frontend/src/game/scenes/CodeCafeScene.ts - Cafe furnishings
frontend/src/game/cafe/CafePropsManager.ts - Community wing
frontend/src/game/cafe/communityWing/CafeCommunityWing.ts - Cafe interactions
frontend/src/game/scenes/cafe/CafeInteractionManager.ts - Garden scene
frontend/src/game/scenes/GardenScene.ts - Garden props
frontend/src/game/props/WorldPropsManager.ts - Player rendering
frontend/src/game/scenes/PlayerManager.ts - Sprout Tree
frontend/src/game/managers/StarTreeManager.ts
Backend services
- Auth routes
backend/src/routes/authRoutes.ts - Feature API
backend/src/routes/apiRoutes.ts - AI challenges
backend/src/services/aiChallenge.ts - GitHub integration
backend/src/services/githubService.ts - Level calculation
backend/src/services/levelingService.ts - Realtime server
backend/src/socket/socketServer.ts
Persistence and integrations
- Realtime client
frontend/src/SupabaseSocket.ts - Supabase client
backend/src/db/client.ts - User and sessions
backend/src/db/users.ts - Decorations
backend/src/db/decorations.ts - Community data
backend/src/db/cafeCommunity.ts - Tree progression
backend/src/db/starTree.ts
Other components
- Gardener
- Supabase
- GitHub OAuth/API
- Gemini
Connections 42
- Gardener → App shell: opens
- App shell → Login UI: renders
frontend/src/App.tsx - App shell → Sidebar profile: renders
frontend/src/App.tsx - App shell → Game container: mounts
frontend/src/App.tsx - App shell → Chat and emotes: renders
frontend/src/App.tsx - App shell → Leaderboard: renders
frontend/src/App.tsx - App shell → Profile card: renders
frontend/src/App.tsx - Gardener → Login UI: signs in
- Login UI → Auth routes: starts OAuth
- Auth routes → GitHub integration: exchanges code
backend/src/routes/authRoutes.ts - GitHub integration → GitHub OAuth/API: requests stats
- Auth routes → Level calculation: calculates level
backend/src/routes/authRoutes.ts - Auth routes → User and sessions: saves user session
backend/src/routes/authRoutes.ts - Auth routes → App shell: returns session
- App shell → Challenge interface: offers challenges
- Challenge interface → Feature API: requests challenge
- Feature API → AI challenges: generates and verifies
backend/src/routes/apiRoutes.ts - AI challenges → Gemini: uses model
- Gardener → Game container: plays
- Game container → Cafe scene: hosts scene
- Cafe scene → Cafe furnishings: builds furnishings
frontend/src/game/cafe/CafePropsManager.ts - Cafe furnishings → Community wing: creates wing
frontend/src/game/cafe/CafePropsManager.ts - Cafe scene → Cafe interactions: handles interaction
frontend/src/game/scenes/cafe/CafeInteractionManager.ts - Game container → Garden scene: hosts garden
- Garden scene → Garden props: builds environment
frontend/src/game/props/WorldPropsManager.ts - Garden props → Sprout Tree: places tree
- Game container → Player rendering: renders avatars
frontend/src/game/scenes/PlayerManager.ts - App shell → Realtime client: connects multiplayer
- Realtime client → Realtime server: syncs realtime state
- Gardener → Chat and emotes: chats
- Gardener → Leaderboard: views rankings
- Gardener → Cafe boards: shares projects
- Gardener → Decor hotbar: customizes world
- Feature API → Community data: reads and writes
backend/src/routes/apiRoutes.ts - Feature API → Decorations: reads and writes
backend/src/routes/apiRoutes.ts - Feature API → User and sessions: reads users
backend/src/routes/apiRoutes.ts - Realtime server → Community data: handles cafe data
- Realtime server → Decorations: handles decor data
- Sprout Tree → Tree progression: persists growth
- Supabase client → Supabase: connects
backend/src/db/client.ts - User and sessions → Supabase client: uses client
backend/src/db/index.ts - Decorations → Supabase client: uses client
backend/src/db/decorations.ts