How mohdsahil36/nocta works
Nocta’s documented product workflow is a nightly check-in that uses deterministic priority scoring to choose one fitting action or a protected recovery night, with goal tracking and weekly reflection around it. The sampled implementation is mostly a landing/auth surface plus a GitHub-backed activity feature; the core decision workflow appears in README and landing content, but its runtime implementation is not shown. The graph preserves that documented product capability while marking the gap, and distinguishes the separate activity API. Backend and activity connections are supported by excerpts/index; unsampled dashboard and product modules are represented cautiously.
Main entry points: page.tsx Landing page · content.ts Nightly check-in · activity.service.ts Activity service · server.ts Express server
Components 25
Web experience
- Landing page
frontend/app/login/page.tsx - Product content
frontend/app/login/content.ts - Email auth flow
frontend/app/login/functions/auth.ts - Dashboard
frontend/app/dashboard
Nightly decision
- Nightly check-in
frontend/app/login/content.ts - Goal tracking
frontend/app/login/content.ts - Priority scoring
frontend/app/login/content.ts - Single action
frontend/app/login/content.ts - Recovery night
frontend/app/login/content.ts - Weekly reflection
frontend/app/login/content.ts
Activity feed
- Activity page
frontend/app/activity/page.tsx - Activity API client
frontend/lib/activity-api.ts
Activity API
- Express server
backend/src/server.ts - API routes
backend/src/routes/index.ts - Activity route
backend/src/routes/activity.route.ts - Activity controller
backend/src/controller/activity.controller.ts - Activity service
backend/src/services/activity.service.ts - GitHub client
backend/src/lib/github.ts - Activity stats
backend/src/lib/activity-stats.ts - Environment config
backend/src/config/envConfig.ts - Prisma client
backend/src/lib/prisma.ts
Other components
- Visitor
- Supabase Auth
- GitHub
- PostgreSQL
Connections 24
- Visitor → Landing page: opens
frontend/app/login/page.tsx - Landing page → Product content: uses copy
frontend/app/login/page.tsx - Landing page → Email auth flow: calls auth
frontend/app/login/page.tsx - Email auth flow → Supabase Auth: authenticates
frontend/app/login/functions/auth.ts - Landing page → Dashboard: routes after auth
frontend/app/login/page.tsx - Dashboard → Nightly check-in: offers check-in
- Nightly check-in → Goal tracking: uses goals
frontend/app/login/content.ts - Nightly check-in → Priority scoring: scores priorities
frontend/app/login/content.ts - Priority scoring → Single action: selects one
frontend/app/login/content.ts - Nightly check-in → Recovery night: can protect rest
frontend/app/login/content.ts - Weekly reflection → Goal tracking: reviews patterns
frontend/app/login/content.ts - Visitor → Activity page: views activity
frontend/app/activity/page.tsx - Activity page → Activity API client: loads activity
- Activity API client → Express server: requests API
- Express server → API routes: mounts routes
backend/src/server.ts - API routes → Activity route: registers route
backend/src/routes/index.ts - Activity route → Activity controller: dispatches
- Activity controller → Activity service: calls service
backend/src/controller/activity.controller.ts - Activity service → GitHub client: fetches commits
backend/src/services/activity.service.ts - GitHub client → GitHub: queries commits
- Activity service → Activity stats: computes stats
backend/src/services/activity.service.ts - Activity service → Environment config: reads settings
backend/src/services/activity.service.ts - Express server → Prisma client: health-checks DB
backend/src/server.ts - Prisma client → PostgreSQL: queries