How kinghochin/family-chat works
Gatherly is a shared trip-research organiser: family members collect messages and attachments, organise ideas in topics, request message-based suggestions, and review reusable artifacts. The App Router pages and components provide the user workflow; API routes handle persistence and Hermes callbacks, with Supabase supplying authentication and data services. The README also describes a local demo board. Some subsystems are unsampled, so their links are shown only where the README or source index supports them.
Main entry points: server.ts Server Supabase client · topics/page.tsx Topic browsing · [topicId]/page.tsx Topic details · topic-assistant.tsx Topic assistant
Components 26
User experience
- Sign-in and signup
src/components/auth-form.tsx - Family workspace
src/components/family-shell.tsx - Message inbox
src/app/inbox/page.tsx - Message composer
src/components/inbox-interactive.tsx
Research workflows
- Topic browsing
src/app/topics/page.tsx - Topic details
src/app/topics/[topicId]/page.tsx - Topic assistant
src/components/topic-assistant.tsx - Message suggestions
src/components/topic-selection-panel.tsx - Artifact library
src/app/artifacts/page.tsx - Artifact details
src/app/artifacts/[artifactId]/page.tsx - Demo trip board
src/components/trip-board.tsx
Requests and integrations
- Message API
src/app/api/messages/route.ts - Topic API
src/app/api/topics/route.ts - AI request route
src/app/api/topics/[topicId]/ai-requests/route.ts - AI callback route
src/app/api/topics/[topicId]/ai-callback/route.ts - Selection request routes
src/app/api/topics/[topicId]/selection-requests/route.ts - Selection callback
src/app/api/topics/[topicId]/selection-callback/route.ts - Authentication actions
src/app/auth-actions.ts - Household member management
src/app/settings/member-actions.ts
Identity and data
- Attachment parsing
src/lib/message-attachments.ts - Server Supabase client
src/lib/supabase/server.ts - Browser Supabase client
src/lib/supabase/client.ts - Admin Supabase client
src/lib/supabase/admin.ts
Other components
- Family member
- Supabase
- Hermes webhook
Connections 33
- Family member → Sign-in and signup: signs in
src/components/auth-form.tsx - Sign-in and signup → Authentication actions: submits credentials
src/components/auth-form.tsx - Authentication actions → Server Supabase client: uses client
src/app/auth-actions.ts - Family member → Message inbox: views messages
- Message inbox → Message composer: renders
src/app/inbox/page.tsx - Message composer → Message API: sends messages
- Message API → Server Supabase client: uses client
src/app/api/messages/route.ts - Message API → Attachment parsing: parses metadata
src/app/api/messages/route.ts - Server Supabase client → Supabase: connects to
src/lib/supabase/server.ts - Family member → Topic browsing: organises ideas
- Topic browsing → Topic details: opens topic
src/app/topics/page.tsx - Topic browsing → Topic API: creates topic
- Topic details → Topic assistant: renders
src/app/topics/[topicId]/page.tsx - Topic details → Message suggestions: renders
src/app/topics/[topicId]/page.tsx - Topic assistant → Browser Supabase client: uses client
src/components/topic-assistant.tsx - Message suggestions → Browser Supabase client: uses client
src/components/topic-selection-panel.tsx - Topic assistant → AI request route: requests answers
- AI request route → Server Supabase client: uses client
src/app/api/topics/[topicId]/ai-requests/route.ts - AI request route → Hermes webhook: sends request
src/app/api/topics/[topicId]/ai-requests/route.ts - Hermes webhook → AI callback route: posts result
- AI callback route → Admin Supabase client: uses client
src/app/api/topics/[topicId]/ai-callback/route.ts - AI callback route → Supabase: stores results
src/app/api/topics/[topicId]/ai-callback/route.ts - Message suggestions → Selection request routes: requests suggestions
- Selection request routes → Server Supabase client: uses client
src/app/api/topics/[topicId]/selection-requests/route.ts - Hermes webhook → Selection callback: posts suggestions
- Selection callback → Admin Supabase client: uses client
src/app/api/topics/[topicId]/selection-callback/route.ts - Family member → Artifact library: reviews outputs
- Artifact library → Artifact details: opens artifact
src/app/artifacts/page.tsx - Family member → Demo trip board: tries demo
- Family member → Household member management: manages household
- Household member management → Server Supabase client: uses client
src/app/settings/member-actions.ts - Browser Supabase client → Supabase: connects to
src/lib/supabase/client.ts - Admin Supabase client → Supabase: connects to
src/lib/supabase/admin.ts