How angelperezcastro/angel-os works
Angel OS is a private personal application, with the web app as its implemented product surface; the mobile app is currently a placeholder. The principal documented workflow is a signed-in user managing Tasks and Notes, with additional life-management areas for goals, habits, career, finance and study, plus dashboard and global search. Sampled code confirms Google/Supabase authentication, task persistence and search grouping. Other feature paths are represented from the tree, but their internal call wiring was not sampled.
Main entry points: layout.tsx Web app · route.ts Auth routes · tasks.ts Task persistence · server.ts Supabase clients
Components 19
Web application
- Web app
apps/web/app/app/layout.tsx - Auth routes
apps/web/app/auth/google/route.ts
Personal workflows
- Tasks
apps/web/lib/tasks - Notes
apps/web/lib/notes - Goals and habits
apps/web/lib/goals - Career
apps/web/lib/career - Finance
apps/web/lib/finance - Study areas
apps/web/lib/university - Dashboard
apps/web/lib/dashboard/load-dashboard.ts - Global search
apps/web/lib/search/global-search.ts
Domain and data
- Task actions
apps/web/lib/tasks/task-actions.ts - Task persistence
packages/data/src/tasks.ts - Task rules
packages/domain/src/task.ts - Search grouping
apps/web/lib/search/global-search.ts
Identity and storage
- Access policy
apps/web/lib/auth/authorization.ts - Supabase clients
apps/web/lib/supabase/server.ts - Supabase
Other components
- Person
- Google identity
Connections 18
- Person → Web app: uses
- Person → Auth routes: signs in
- Auth routes → Google identity: starts OAuth
- Auth routes → Supabase clients: exchanges session
- Auth routes → Access policy: checks access
- Web app → Tasks: opens
- Web app → Notes: opens
- Web app → Goals and habits: opens
- Web app → Career: opens
- Web app → Finance: opens
- Web app → Study areas: opens
- Web app → Dashboard: loads
- Web app → Global search: searches
- Task actions → Task persistence: persists tasks
- Task persistence → Task rules: validates with
- Task persistence → Supabase: reads/writes
- Supabase clients → Supabase: connects
- Search grouping → Task rules: uses task rules