How fortunatoman/goodie-ai works
Goodie AI is a full-stack character-chat product: users discover or create characters, chat with them, collect conversations, generate images, and use AI calls. The React app presents these flows; its services and hooks manage client state and API interactions, while Express controllers delegate domain work to services backed by Supabase and AI providers. The README documents Supabase and OpenAI/DeepAI integrations. Some frontend-to-backend wiring and unsampled feature internals are not shown, so those links are omitted or marked unverified.
Main entry points: App.tsx App routing · call.service.ts Call service · message.service.ts Message service · useChats.ts Chats hook
Components 26
Web experience
- App routing
Frontend/src/App.tsx - Discover
Frontend/src/pages/Discover/index.tsx - Create character
Frontend/src/pages/CreateCharacter/index.tsx - Chat
Frontend/src/pages/Chat/index.tsx - Collection
Frontend/src/pages/Collection/index.tsx - Image generation
Frontend/src/pages/GenerateImage/index.tsx - My AI
Frontend/src/pages/MyAI/index.tsx - Subscriptions
Frontend/src/pages/subscriptions/index.tsx
Client state and API
- Global context
Frontend/src/contexts/GlobalContext.tsx - Auth hook
Frontend/src/hooks/useAuth.ts - Auth service
Frontend/src/services/auth.service.ts - Chats hook
Frontend/src/hooks/useChats.ts - Chats service
Frontend/src/services/chats.service.ts
Backend API
- Express API
Backend/src/index.ts - Auth controller
Backend/src/controllers/auth.controller.ts - Call controller
Backend/src/controllers/call.controller.ts - Message controller
Backend/src/controllers/message.controller.ts
Domain services
- Auth service
Backend/src/services/auth.service.ts - Call service
Backend/src/services/call.service.ts - Character service
Backend/src/services/character.service.ts - Chats service
Backend/src/services/chats.service.ts - Message service
Backend/src/services/message.service.ts
Other components
- User
- Supabase
- OpenAI
- DeepAI
Connections 32
- User → App routing: uses
Frontend/src/App.tsx - App routing → Global context: provides state
Frontend/src/App.tsx - App routing → Discover: routes to
Frontend/src/App.tsx - App routing → Create character: routes to
Frontend/src/App.tsx - App routing → Chat: routes to
Frontend/src/App.tsx - App routing → Collection: routes to
Frontend/src/App.tsx - App routing → Image generation: routes to
Frontend/src/App.tsx - App routing → My AI: routes to
Frontend/src/App.tsx - App routing → Subscriptions: routes to
Frontend/src/App.tsx - Auth hook → Global context: reads state
Frontend/src/hooks/useAuth.ts - Auth hook → Auth service: delegates
Frontend/src/hooks/useAuth.ts - Auth service → Auth controller: calls API
- Chat → Chats hook: uses
Frontend/src/pages/Chat/index.tsx - Collection → Chats hook: uses
Frontend/src/pages/Collection/index.tsx - My AI → Chats hook: uses
Frontend/src/pages/MyAI/index.tsx - Chats hook → Chats service: delegates
Frontend/src/hooks/useChats.ts - Chats service → Chats service: calls API
- Express API → Auth controller: routes requests
- Auth controller → Auth service: delegates
Backend/src/controllers/auth.controller.ts - Call controller → Call service: delegates
Backend/src/controllers/call.controller.ts - Message controller → Message service: delegates
Backend/src/controllers/message.controller.ts - Message controller → Character service: loads character
Backend/src/controllers/message.controller.ts - Auth service → Supabase: auth operations
Backend/src/services/auth.service.ts - Call service → Supabase: reads and writes
Backend/src/services/call.service.ts - Character service → Supabase: reads and writes
Backend/src/services/character.service.ts - Chats service → Supabase: reads and writes
Backend/src/services/chats.service.ts - Message service → Supabase: reads and writes
Backend/src/services/message.service.ts - Call service → Character service: loads character
Backend/src/services/call.service.ts - Call service → Message service: creates message
Backend/src/services/call.service.ts - Call service → OpenAI: generates voice
Backend/src/services/call.service.ts - Message service → OpenAI: AI generation
- Message service → DeepAI: image generation