How amirovvas/localy works
This repository implements a community chat product: users register or log in, discover or join communities, then exchange messages in community rooms; supporting capabilities include live updates, image attachments, events, summaries, and moderation. The graph shows the frontend request path into backend controllers and services, plus database and socket/storage integrations. Several important areas are present in the tree but were not sampled, so their internal links are omitted where call evidence is unavailable.
Main entry points: pg.ts PostgreSQL · message.service.ts Messaging service · api.ts HTTP client · reaction.service.ts Reactions
Components 23
Web client
- Next.js app
frontend/src/app/page.tsx - Chat interface
frontend/src/components/pages/chat/ChatArea.tsx - Chat data hooks
frontend/src/hooks/messages/useGetMessages.ts - HTTP client
frontend/src/hooks/api/api.ts - Auth hooks
frontend/src/hooks/auth/useLogin.ts - Community hooks
frontend/src/hooks/communities/useDiscoverCommunities.ts - Admin console
frontend/src/components/pages/admin/Admin.tsx
Backend API
- API routes
backend/src/routes/auth.route.ts - Auth controllers
backend/src/controllers/auth.controller.ts - Community controllers
backend/src/controllers/community.controller.ts - Message controllers
backend/src/controllers/message.controller.ts
Product services
- Identity service
backend/src/services/auth.service.ts - Community service
backend/src/services/community.service.ts - Messaging service
backend/src/services/message.service.ts - Reactions
backend/src/services/reaction.service.ts - Moderation reports
backend/src/services/report.service.ts - Community events
backend/src/services/event.service.ts - Room summaries
backend/src/services/summary.service.ts - Image uploads
backend/src/services/upload.service.ts
Persistence and integrations
- PostgreSQL
backend/src/plugins/pg.ts - Realtime sockets
backend/src/plugins/socket.ts - Supabase Storage
backend/src/plugins/storage.ts
Other components
- Community member
Connections 26
- Community member → Next.js app: uses
- Next.js app → Chat interface: opens chat
- Chat interface → Chat data hooks: loads chat data
- Chat data hooks → HTTP client: requests
frontend/src/hooks/messages/useGetMessages.ts - Auth hooks → HTTP client: requests
- Community hooks → HTTP client: requests
frontend/src/hooks/communities/useDiscoverCommunities.ts - Admin console → HTTP client: moderates via
- HTTP client → API routes: HTTP requests
- API routes → Auth controllers: routes auth
backend/src/routes/auth.route.ts - Auth controllers → Identity service: calls
backend/src/controllers/auth.controller.ts - Community controllers → Community service: calls
backend/src/controllers/community.controller.ts - Message controllers → Messaging service: calls
backend/src/controllers/message.controller.ts - Message controllers → Reactions: calls
backend/src/controllers/message.controller.ts - Identity service → Community service: validates choices
backend/src/services/auth.service.ts - Identity service → PostgreSQL: reads and writes
backend/src/services/auth.service.ts - Community service → PostgreSQL: reads and writes
backend/src/services/community.service.ts - Messaging service → PostgreSQL: reads and writes
backend/src/services/message.service.ts - Reactions → PostgreSQL: reads and writes
backend/src/services/reaction.service.ts - Moderation reports → PostgreSQL: reads and writes
backend/src/services/report.service.ts - Community events → PostgreSQL: reads and writes
backend/src/services/event.service.ts - Messaging service → Reactions: selects reactions
backend/src/services/message.service.ts - Messaging service → Realtime sockets: emits room events
backend/src/services/message.service.ts - Reactions → Realtime sockets: emits updates
backend/src/services/reaction.service.ts - Messaging service → Supabase Storage: validates and removes attachments
backend/src/services/message.service.ts - Image uploads → Supabase Storage: stores images
- Room summaries → PostgreSQL: reads data