How sidsahoo1203/claude works
Hourglass is a private, single-user time-logging and reflection app. The user logs completed hours during a server-enforced window, then reviews patterns and adds plans, goals, reflections, and other long-term records. The client routes these features through a cookie-authenticated API; the server applies time, authentication, and permanence rules and persists domain records in MongoDB. Feature coverage follows the README and route registrations; unsampled route internals and their specific storage calls are not asserted.
Main entry points: api.js API client · app.js Express API · App.jsx Client routes · day.js Day and hour rules
Components 27
Web client
- Client routes
client/src/App.jsx - Session state
client/src/context/AuthContext.jsx - Server clock state
client/src/context/ClockContext.jsx - Logging reminders
client/src/context/RemindersContext.jsx - API client
client/src/api.js - Hour logging
client/src/components/LogForm.jsx - Dashboard
client/src/pages/Dashboard.jsx - Plans and goals
client/src/pages/Plan.jsx - Calendar and day view
client/src/pages/Calendar.jsx - Categories
client/src/pages/Categories.jsx - Stop Doing list
client/src/pages/StopDoing.jsx
API and rules
- Express API
server/src/app.js - Authentication
server/src/routes/auth.js - Day and block logging
server/src/routes/blocks.js - Domain API routes
server/src/routes
Review and growth
- Daily reflection
client/src/pages/Reflection.jsx - Weekly review
client/src/pages/WeeklyReview.jsx - Analytics
client/src/pages/Analytics.jsx - Data export
client/src/pages/Export.jsx - Letters to self
client/src/pages/Letters.jsx
Persistence and safeguards
- Day and hour rules
server/src/services/day.js - Timezone and clock
server/src/lib/time.js - Clock integrity guard
server/src/lib/clockGuard.js - Session verification
server/src/middleware/auth.js - Domain records
server/src/models/index.js - MongoDB
Other components
- Single user
Connections 29
- Single user → Client routes: uses
client/src/App.jsx - Client routes → Session state: checks session
client/src/App.jsx - Client routes → Server clock state: provides clock
client/src/App.jsx - Client routes → Logging reminders: provides reminders
client/src/App.jsx - Session state → API client: requests auth
client/src/context/AuthContext.jsx - Server clock state → API client: loads server time
client/src/context/ClockContext.jsx - Logging reminders → API client: checks open hours
client/src/context/RemindersContext.jsx - Hour logging → API client: submits logs
client/src/components/LogForm.jsx - Dashboard → API client: loads summaries
client/src/pages/Dashboard.jsx - Plans and goals → API client: loads and saves
client/src/pages/Plan.jsx - Daily reflection → API client: loads and saves
client/src/pages/Reflection.jsx - Weekly review → API client: loads review
client/src/pages/WeeklyReview.jsx - Calendar and day view → API client: loads day data
- Categories → API client: manages categories
- Stop Doing list → API client: manages items
- Analytics → API client: loads analytics
- Data export → API client: requests export
- Letters to self → API client: manages letters
- API client → Express API: sends requests
README.md - Express API → Authentication: routes auth
server/src/app.js - Express API → Day and block logging: routes day logs
server/src/app.js - Express API → Domain API routes: mounts features
server/src/app.js - Express API → Session verification: protects API
server/src/app.js - Express API → Clock integrity guard: guards API clock
server/src/app.js - Day and block logging → Day and hour rules: checks day state
server/src/routes/blocks.js - Day and hour rules → Timezone and clock: uses time rules
server/src/services/day.js - Session verification → Timezone and clock: uses app clock
server/src/middleware/auth.js - Day and hour rules → Domain records: uses records
server/src/services/day.js - Domain records → MongoDB: persists records