How iggy14/remindu works
RemindU turns a person’s natural-language request into a confirmed reminder, stores it as private or group-shared responsibility, computes due dates deterministically, and delivers scheduled push notifications. The main path runs from chat through server-side AI interpretation and rule validation to reminder persistence; users can also manage reminders directly, organize a shared group, and configure notifications. The graph preserves documented features and indicates where unsampled implementation details limit relationship evidence.
Main entry points: respond.ts AI response builder · send-reminders.ts Scheduled reminder sender · App.tsx App shell · chat.ts AI chat endpoint
Components 27
App experience
- App shell
src/App.tsx - Chat UI
src/pages/Chat.tsx - Chat workflow
src/hooks/useReminderChat.ts - Reminder screens
src/pages/Reminders.tsx - Settings and groups
src/components - Sign-in screen
src/components/AuthScreen.tsx
AI interpretation
- AI chat endpoint
api/ai/chat.ts - AI response builder
src/ai/server/respond.ts - Prompt and model
src/ai/server/prompt.ts - Intent router
src/ai/route.ts - Draft interpretation
src/ai/interpret.ts - Edit handling
src/ai/applyEdit.ts - AI schema
src/ai/schema.ts - Date resolution
src/ai/resolveDate.ts
Reminder rules
- Rule scheduler
src/ruleEngine/index.ts - Date calculations
src/ruleEngine/dates.ts
Identity and data
- Reminder data hook
src/hooks/useResponsibilities.ts - Reminder persistence
src/lib/responsibilities.ts - Supabase client
src/lib/supabase.ts - Auth context
src/lib/auth.ts
Notification delivery
- Scheduled reminder sender
api/send-reminders.ts - Push payload builder
api/_lib/pushPayload.ts - Push service worker
public/push-sw.js
Other components
- Person
- Supabase Auth and Postgres
- Web Push service
- Supabase pg_cron
Connections 29
- Person → App shell: uses
- App shell → Sign-in screen: shows when signed out
src/App.tsx - App shell → Supabase client: checks configuration
src/App.tsx - Person → Chat UI: describes reminder
- Chat UI → Chat workflow: uses workflow
src/pages/Chat.tsx - Chat workflow → AI chat endpoint: submits chat
- AI chat endpoint → AI response builder: delegates response
api/ai/chat.ts - AI chat endpoint → Supabase Auth and Postgres: authenticates and loads items
api/ai/chat.ts - AI response builder → Prompt and model: builds response
src/ai/server/respond.ts - AI response builder → Intent router: routes extracted intent
src/ai/server/respond.ts - AI response builder → AI schema: validates extraction
src/ai/server/respond.ts - Intent router → Draft interpretation: interprets additions
src/ai/route.ts - Intent router → Edit handling: applies edits
src/ai/route.ts - Draft interpretation → Date resolution: resolves dates
src/ai/interpret.ts - Draft interpretation → AI schema: uses extracted fields
src/ai/interpret.ts - Person → Reminder screens: manages reminders
- Reminder screens → Reminder data hook: loads and mutates
src/pages/Reminders.tsx - Reminder data hook → Reminder persistence: calls data operations
src/hooks/useResponsibilities.ts - Reminder persistence → Supabase client: reads and writes
src/lib/responsibilities.ts - Reminder persistence → Rule scheduler: plans reminder dates
src/lib/responsibilities.ts - Rule scheduler → Date calculations: uses date functions
src/ruleEngine/index.ts - Auth context → Supabase Auth and Postgres: provides authentication
- Person → Settings and groups: configures group and alerts
- Supabase pg_cron → Scheduled reminder sender: invokes periodically
- Scheduled reminder sender → Supabase Auth and Postgres: queries due reminders
- Scheduled reminder sender → Push payload builder: builds notification
api/send-reminders.ts - Push payload builder → Date calculations: formats due dates
api/_lib/pushPayload.ts - Scheduled reminder sender → Web Push service: sends push
- Web Push service → Push service worker: delivers notification