How thiagobraga/planner works
Planner is a Bullet Journal-style task manager: users plan daily tasks, organize collections, track habits, and sync changes across devices. The React app presents these workflows and calls the API; the API handles authentication, domain services, and persistence. AI-agent access is provided through MCP tools and OAuth. The standalone site is a separate product-facing landing page. Relationships are limited to those visible in sampled imports/calls or stated in the README; unsampled feature internals are represented at their source paths, with no inferred internal call chains.
Main entry points: App.tsx App shell · client.ts API client · index.ts HTTP API · authService.ts Authentication
Components 23
Planner app
- App shell
app/src/App.tsx - Daily planning
app/src/pages/DailyPage.tsx - Collections
app/src/pages/CollectionsPage.tsx - Habit tracking
app/src/pages/HabitsPage.tsx - Settings and account
app/src/pages/SettingsPage.tsx - Task detail
app/src/hooks/useTaskDetailController.ts - API client
app/src/api/client.ts - Offline and live sync
app/src/hooks/useOfflineQueueReplay.ts
API services
- HTTP API
api/src/index.ts - Authentication
api/src/services/authService.ts - Session management
api/src/services/sessionService.ts - Task operations
api/src/services/taskService.ts - Task endpoints
api/src/routes/tasks.ts - Recurrence engine
api/src/engines/recurrenceEngine.ts - PostgreSQL
api/src/db/pool.ts - Task imports
api/src/services/import/importService.ts - Rich task documents
api/src/services/document/store.ts
Agent integrations
- MCP server
api/src/mcp/server.ts - MCP task tools
api/src/mcp/tools/tasks.ts - OAuth authorization
api/src/services/oauthService.ts
Landing site
- Marketing pages
site/src/App.tsx
Other components
- Planner user
- Site visitor
Connections 26
- Planner user → App shell: uses
README.md - App shell → Daily planning: routes to
app/src/App.tsx - App shell → Collections: routes to
app/src/App.tsx - App shell → Habit tracking: routes to
app/src/App.tsx - App shell → Settings and account: routes to
app/src/App.tsx - Daily planning → API client: requests data
- Collections → API client: requests data
- Habit tracking → API client: requests data
- Task detail → App shell: controls detail state
- API client → HTTP API: sends requests
- Offline and live sync → API client: replays edits
- Planner user → HTTP API: authenticates
README.md - HTTP API → Authentication: handles auth
- Authentication → Session management: creates sessions
api/src/services/authService.ts - HTTP API → Task endpoints: routes requests
api/src/index.ts - Task endpoints → Task operations: calls
api/src/routes/tasks.ts - Task operations → PostgreSQL: queries
api/src/services/taskService.ts - Authentication → PostgreSQL: queries
api/src/services/authService.ts - Planner user → MCP server: connects agent
README.md - MCP server → MCP task tools: registers tools
api/src/mcp/server.ts - MCP task tools → Task operations: calls task operations
api/src/mcp/tools/tasks.ts - Planner user → OAuth authorization: approves client
README.md - OAuth authorization → PostgreSQL: stores grants
api/src/services/oauthService.ts - Planner user → Task imports: imports tasks
- Planner user → Rich task documents: edits documents
- Site visitor → Marketing pages: visits
site/src/App.tsx