How suki-amalie/journal-habit-tracker works
Hibi is a personal journaling and habit-tracking application. Users register or log in, then write and revisit journal entries, manage habits, record completions, and review activity summaries. The client uses authenticated API requests; server routes apply authentication and controllers validate requests and read or mutate user-scoped data. The README documents draft recovery, notebook-style history, heatmaps, and session security. Some UI and server modules were not excerpted, so uncertain connections are omitted or marked unverified.
Main entry points: App.tsx Route shell · Dashboard.tsx Dashboard · apiClient.ts API client · JournalHistory.tsx Journal history
Components 34
Client experience
- Route shell
client/src/App.tsx - Protected routes
client/src/components/ProtectedRoutes.tsx - Dashboard
client/src/pages/Dashboard.tsx - Habit tracking
client/src/pages/Habits.tsx - Journal writing
client/src/pages/Journal.tsx - Journal history
client/src/pages/JournalHistory.tsx - Activity heatmaps
client/src/components/ActivityHeatmap.tsx - Notebook view
client/src/components/JournalDayBook.tsx - Draft recovery
client/src/hooks/useDraft.ts - Account pages
client/src/pages/Login.tsx
Client data access
- Habit data hooks
client/src/hooks/useHabits.ts - Completion hooks
client/src/hooks/useHabitsCompletions.ts - Journal data hooks
client/src/hooks/useJournalEntries.ts - Journal activity hooks
client/src/hooks/useJournalActivity.ts - Habit API service
client/src/services/habitService.ts - Journal API service
client/src/services/journalService.ts - API client
client/src/services/apiClient.ts - Query cache
client/src/lib/queryClient.ts - Current user hook
client/src/hooks/useCurrentUser.ts
API and domain
- Express API
server/src/app.ts - Habit routes
server/src/routes/habitRoutes.ts - Habit operations
server/src/controllers/habitController.ts - Journal routes
server/src/routes/journalRoutes.ts - Journal operations
server/src/controllers/journalController.ts - Request validation
server/src/validation/schemas.ts
Authentication
- Auth routes
server/src/routes/authRoutes.ts - Account and sessions
server/src/controllers/authController.ts - Session guard
server/src/middleware/requireAuth.ts - Session service
server/src/lib/sessionService.ts - Session cookie
server/src/lib/authCookie.ts
Persistence
- Prisma client
server/src/lib/prisma.ts - PostgreSQL
Other components
- Hibi user
- Browser localStorage
Connections 48
- Hibi user → Route shell: uses
client/src/App.tsx - Route shell → Protected routes: guards routes
client/src/App.tsx - Protected routes → Current user hook: checks session
client/src/components/ProtectedRoutes.tsx - Route shell → Dashboard: routes to
client/src/App.tsx - Route shell → Habit tracking: routes to
client/src/App.tsx - Route shell → Journal writing: routes to
client/src/App.tsx - Route shell → Journal history: routes to
client/src/App.tsx - Dashboard → Habit data hooks: loads habits
client/src/pages/Dashboard.tsx - Dashboard → Completion hooks: loads completions
client/src/pages/Dashboard.tsx - Dashboard → Journal data hooks: loads entries
client/src/pages/Dashboard.tsx - Dashboard → Journal activity hooks: loads activity
client/src/pages/Dashboard.tsx - Dashboard → Activity heatmaps: renders
client/src/pages/Dashboard.tsx - Habit tracking → Habit data hooks: uses
client/src/pages/Habits.tsx - Habit tracking → Completion hooks: uses
client/src/pages/Habits.tsx - Journal writing → Journal data hooks: uses
client/src/pages/Journal.tsx - Journal writing → Draft recovery: recovers drafts
README.md - Journal history → Journal data hooks: loads entries
client/src/pages/JournalHistory.tsx - Journal history → Journal activity hooks: loads activity
client/src/pages/JournalHistory.tsx - Journal history → Activity heatmaps: renders
client/src/pages/JournalHistory.tsx - Journal history → Notebook view: renders
client/src/pages/JournalHistory.tsx - Journal writing → Notebook view: renders
client/src/pages/Journal.tsx - Draft recovery → Browser localStorage: persists drafts
README.md - Habit data hooks → Habit API service: calls
- Completion hooks → Habit API service: calls
client/src/hooks/useHabitsCompletions.ts - Journal data hooks → Journal API service: calls
- Journal activity hooks → Journal API service: calls
- Habit API service → API client: requests
client/src/services/habitService.ts - Journal API service → API client: requests
client/src/services/journalService.ts - API client → Query cache: clears on 401
client/src/services/apiClient.ts - Account pages → API client: submits credentials
client/src/pages/Login.tsx - Account pages → Current user hook: checks account
client/src/pages/Login.tsx - Current user hook → API client: requests user
client/src/hooks/useCurrentUser.ts - API client → Express API: sends API requests
- Express API → Habit routes: mounts routes
server/src/app.ts - Express API → Journal routes: mounts routes
server/src/app.ts - Express API → Auth routes: mounts routes
server/src/app.ts - Habit routes → Session guard: requires auth
server/src/routes/habitRoutes.ts - Habit routes → Habit operations: dispatches
server/src/routes/habitRoutes.ts - Journal routes → Session guard: requires auth
server/src/routes/journalRoutes.ts - Journal routes → Journal operations: dispatches
server/src/routes/journalRoutes.ts - Auth routes → Account and sessions: dispatches
server/src/routes/authRoutes.ts - Habit operations → Request validation: validates requests
server/src/controllers/habitController.ts - Journal operations → Request validation: validates requests
server/src/controllers/journalController.ts - Habit operations → Prisma client: reads and writes
server/src/controllers/habitController.ts - Journal operations → Prisma client: reads and writes
server/src/controllers/journalController.ts - Account and sessions → Prisma client: accesses records
server/src/controllers/authController.ts - Account and sessions → Session service: manages sessions
server/src/controllers/authController.ts - Account and sessions → Session cookie: sets cookie
server/src/controllers/authController.ts