# vedansh-mittal/dayplanner architecture

> Architecture diagram of the GitHub repository vedansh-mittal/dayplanner, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-06). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/vedansh-mittal/dayplanner
- Repository: https://github.com/vedansh-mittal/dayplanner

## Overview

Daylight Planner is a private journaling and daily-planning app. Users authenticate, complete onboarding, record morning and evening reflections, then revisit history, insights, and settings. The main data path is the planner through an auto-saving entry hook to Supabase, with optional client-side encryption. The map also preserves personalization, reminders, and security capabilities documented or represented in the tree; some links to unsampled pages and serverless functions are omitted where invocation evidence was unavailable.

Main entry points: [`src/App.tsx`](https://github.com/vedansh-mittal/dayplanner/blob/main/src/App.tsx) (Route application), [`src/lib/supabase.ts`](https://github.com/vedansh-mittal/dayplanner/blob/main/src/lib/supabase.ts) (Supabase client), [`src/pages/SettingsPage.tsx`](https://github.com/vedansh-mittal/dayplanner/blob/main/src/pages/SettingsPage.tsx) (Settings and backup), [`src/pages/PlannerPage.tsx`](https://github.com/vedansh-mittal/dayplanner/blob/main/src/pages/PlannerPage.tsx) (Daily planner)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_app["App and identity"]
  node_routes["Route application<br/>[App.tsx]"]
  node_auth["Authentication state<br/>[auth-store.ts]"]
  node_authguard["Protected routes<br/>[AuthGuard.tsx]"]
  node_callback["Magic-link callback"]
end

subgraph group_planning["Planning and reflection"]
  node_onboarding["User onboarding<br/>[OnboardingPage.tsx]"]
  node_planner["Daily planner<br/>[PlannerPage.tsx]"]
  node_entry["Daily entry autosave<br/>[useDailyEntry.ts]"]
  node_morning["Morning reflection<br/>[MorningPlanner.tsx]"]
  node_evening["Evening reflection<br/>[NightPlanner.tsx]"]
  node_history["Journal history<br/>[HistoryPage.tsx]"]
  node_insightspage["Insights experience<br/>[InsightsPage.tsx]"]
end

subgraph group_account["Personalization and security"]
  node_settingspage["Settings and backup<br/>[SettingsPage.tsx]"]
  node_personalisationpage["Personalization page"]
  node_settings["User settings<br/>[useUserSettings.ts]"]
  node_personalisation["Personalization data"]
  node_cryptoctx["Encryption session<br/>[CryptoContext.tsx]"]
  node_cryptolib["Encryption primitives<br/>[crypto.ts]"]
end

subgraph group_services["Data and insights"]
  node_insights["Deterministic analysis<br/>[insights-engine.ts]"]
  node_push["Push reminders<br/>[push.ts]"]
  node_supabase["Supabase client<br/>[supabase.ts]"]
  node_backend[("Supabase services")]
  node_generate["Insight generation function<br/>[index.ts]"]
  node_query["Insight query function<br/>[index.ts]"]
  node_reminders["Reminder function<br/>[index.ts]"]
end

node_user(("Planner user"))

node_user -->|"uses"| node_routes
node_routes -->|"initializes"| node_auth
node_routes -->|"protects routes"| node_authguard
node_routes -->|"routes to"| node_planner
node_routes -->|"routes to"| node_history
node_routes -->|"routes to"| node_insightspage
node_routes -->|"routes to"| node_onboarding
node_routes -->|"routes to"| node_settingspage
node_routes -->|"routes to"| node_personalisationpage
node_routes -->|"provides encryption"| node_cryptoctx
node_callback -->|"exchanges session"| node_supabase
node_callback -->|"routes when incomplete"| node_onboarding
node_callback -->|"routes when complete"| node_planner
node_planner -.->|"presents"| node_morning
node_planner -.->|"presents"| node_evening
node_planner -.->|"edits entries"| node_entry
node_entry -->|"reads and saves"| node_supabase
node_entry -->|"gets user"| node_auth
node_entry -->|"encrypts and decrypts"| node_cryptoctx
node_history -->|"queries entries"| node_supabase
node_history -->|"uses decryption"| node_cryptoctx
node_insightspage -->|"requests analysis"| node_insights
node_insights -->|"decrypts entries"| node_cryptolib
node_insights -->|"reads data"| node_supabase
node_settingspage -->|"manages settings"| node_settings
node_settingspage -->|"manages preferences"| node_personalisation
node_settingspage -->|"encrypts backups"| node_cryptolib
node_settingspage -->|"subscribes reminders"| node_push
node_onboarding -->|"saves setup"| node_settings
node_onboarding -->|"sets preferences"| node_personalisation
node_settings -->|"reads and writes"| node_supabase
node_settings -->|"gets user"| node_auth
node_personalisation -->|"reads and writes"| node_supabase
node_personalisation -->|"gets user"| node_auth
node_cryptoctx -->|"calls cryptography"| node_cryptolib
node_cryptoctx -->|"stores key settings"| node_supabase
node_auth -->|"authenticates"| node_supabase
node_supabase -->|"accesses"| node_backend
node_generate -.->|"serves insights"| node_insightspage
node_query -.->|"serves queries"| node_insightspage
node_reminders -.->|"dispatches reminders"| node_push

click node_routes "https://github.com/vedansh-mittal/dayplanner/blob/main/src/App.tsx"
click node_auth "https://github.com/vedansh-mittal/dayplanner/blob/main/src/stores/auth-store.ts"
click node_authguard "https://github.com/vedansh-mittal/dayplanner/blob/main/src/components/AuthGuard.tsx"
click node_callback "https://github.com/vedansh-mittal/dayplanner/blob/main/src/pages/AuthCallbackPage.tsx"
click node_onboarding "https://github.com/vedansh-mittal/dayplanner/blob/main/src/pages/OnboardingPage.tsx"
click node_planner "https://github.com/vedansh-mittal/dayplanner/blob/main/src/pages/PlannerPage.tsx"
click node_entry "https://github.com/vedansh-mittal/dayplanner/blob/main/src/hooks/useDailyEntry.ts"
click node_morning "https://github.com/vedansh-mittal/dayplanner/blob/main/src/components/MorningPlanner.tsx"
click node_evening "https://github.com/vedansh-mittal/dayplanner/blob/main/src/components/NightPlanner.tsx"
click node_history "https://github.com/vedansh-mittal/dayplanner/blob/main/src/pages/HistoryPage.tsx"
click node_insightspage "https://github.com/vedansh-mittal/dayplanner/blob/main/src/pages/InsightsPage.tsx"
click node_settingspage "https://github.com/vedansh-mittal/dayplanner/blob/main/src/pages/SettingsPage.tsx"
click node_personalisationpage "https://github.com/vedansh-mittal/dayplanner/blob/main/src/pages/PersonalisationPage.tsx"
click node_settings "https://github.com/vedansh-mittal/dayplanner/blob/main/src/hooks/useUserSettings.ts"
click node_personalisation "https://github.com/vedansh-mittal/dayplanner/blob/main/src/hooks/usePersonalisation.ts"
click node_cryptoctx "https://github.com/vedansh-mittal/dayplanner/blob/main/src/contexts/CryptoContext.tsx"
click node_cryptolib "https://github.com/vedansh-mittal/dayplanner/blob/main/src/lib/crypto.ts"
click node_insights "https://github.com/vedansh-mittal/dayplanner/blob/main/src/lib/insights-engine.ts"
click node_push "https://github.com/vedansh-mittal/dayplanner/blob/main/src/lib/push.ts"
click node_supabase "https://github.com/vedansh-mittal/dayplanner/blob/main/src/lib/supabase.ts"
click node_generate "https://github.com/vedansh-mittal/dayplanner/blob/main/supabase/functions/generate-insight/index.ts"
click node_query "https://github.com/vedansh-mittal/dayplanner/blob/main/supabase/functions/query-insights/index.ts"
click node_reminders "https://github.com/vedansh-mittal/dayplanner/blob/main/supabase/functions/send-reminders/index.ts"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_routes,node_auth,node_authguard,node_callback,node_user toneBlue
class node_onboarding,node_planner,node_entry,node_morning,node_evening,node_history,node_insightspage toneAmber
class node_settingspage,node_personalisationpage,node_settings,node_personalisation,node_cryptoctx,node_cryptolib toneMint
class node_insights,node_push,node_supabase,node_backend,node_generate,node_query,node_reminders toneRose
```

## Components

### App and identity

- [Route application](https://github.com/vedansh-mittal/dayplanner/blob/main/src/App.tsx): `src/App.tsx`
- [Authentication state](https://github.com/vedansh-mittal/dayplanner/blob/main/src/stores/auth-store.ts): `src/stores/auth-store.ts`
- [Protected routes](https://github.com/vedansh-mittal/dayplanner/blob/main/src/components/AuthGuard.tsx): `src/components/AuthGuard.tsx`
- [Magic-link callback](https://github.com/vedansh-mittal/dayplanner/blob/main/src/pages/AuthCallbackPage.tsx): `src/pages/AuthCallbackPage.tsx`

### Planning and reflection

- [User onboarding](https://github.com/vedansh-mittal/dayplanner/blob/main/src/pages/OnboardingPage.tsx): `src/pages/OnboardingPage.tsx`
- [Daily planner](https://github.com/vedansh-mittal/dayplanner/blob/main/src/pages/PlannerPage.tsx): `src/pages/PlannerPage.tsx`
- [Daily entry autosave](https://github.com/vedansh-mittal/dayplanner/blob/main/src/hooks/useDailyEntry.ts): `src/hooks/useDailyEntry.ts`
- [Morning reflection](https://github.com/vedansh-mittal/dayplanner/blob/main/src/components/MorningPlanner.tsx): `src/components/MorningPlanner.tsx`
- [Evening reflection](https://github.com/vedansh-mittal/dayplanner/blob/main/src/components/NightPlanner.tsx): `src/components/NightPlanner.tsx`
- [Journal history](https://github.com/vedansh-mittal/dayplanner/blob/main/src/pages/HistoryPage.tsx): `src/pages/HistoryPage.tsx`
- [Insights experience](https://github.com/vedansh-mittal/dayplanner/blob/main/src/pages/InsightsPage.tsx): `src/pages/InsightsPage.tsx`

### Personalization and security

- [Settings and backup](https://github.com/vedansh-mittal/dayplanner/blob/main/src/pages/SettingsPage.tsx): `src/pages/SettingsPage.tsx`
- [Personalization page](https://github.com/vedansh-mittal/dayplanner/blob/main/src/pages/PersonalisationPage.tsx): `src/pages/PersonalisationPage.tsx`
- [User settings](https://github.com/vedansh-mittal/dayplanner/blob/main/src/hooks/useUserSettings.ts): `src/hooks/useUserSettings.ts`
- [Personalization data](https://github.com/vedansh-mittal/dayplanner/blob/main/src/hooks/usePersonalisation.ts): `src/hooks/usePersonalisation.ts`
- [Encryption session](https://github.com/vedansh-mittal/dayplanner/blob/main/src/contexts/CryptoContext.tsx): `src/contexts/CryptoContext.tsx`
- [Encryption primitives](https://github.com/vedansh-mittal/dayplanner/blob/main/src/lib/crypto.ts): `src/lib/crypto.ts`

### Data and insights

- [Deterministic analysis](https://github.com/vedansh-mittal/dayplanner/blob/main/src/lib/insights-engine.ts): `src/lib/insights-engine.ts`
- [Push reminders](https://github.com/vedansh-mittal/dayplanner/blob/main/src/lib/push.ts): `src/lib/push.ts`
- [Supabase client](https://github.com/vedansh-mittal/dayplanner/blob/main/src/lib/supabase.ts): `src/lib/supabase.ts`
- **Supabase services**
- [Insight generation function](https://github.com/vedansh-mittal/dayplanner/blob/main/supabase/functions/generate-insight/index.ts): `supabase/functions/generate-insight/index.ts`
- [Insight query function](https://github.com/vedansh-mittal/dayplanner/blob/main/supabase/functions/query-insights/index.ts): `supabase/functions/query-insights/index.ts`
- [Reminder function](https://github.com/vedansh-mittal/dayplanner/blob/main/supabase/functions/send-reminders/index.ts): `supabase/functions/send-reminders/index.ts`

### Other components

- **Planner user**

## Connections

- Planner user → Route application: uses (evidence: `README.md`)
- Route application → Authentication state: initializes (evidence: `src/App.tsx`)
- Route application → Protected routes: protects routes (evidence: `src/App.tsx`)
- Route application → Daily planner: routes to (evidence: `src/App.tsx`)
- Route application → Journal history: routes to (evidence: `src/App.tsx`)
- Route application → Insights experience: routes to (evidence: `src/App.tsx`)
- Route application → User onboarding: routes to (evidence: `src/App.tsx`)
- Route application → Settings and backup: routes to (evidence: `src/App.tsx`)
- Route application → Personalization page: routes to (evidence: `src/App.tsx`)
- Route application → Encryption session: provides encryption (evidence: `src/App.tsx`)
- Magic-link callback → Supabase client: exchanges session (evidence: `src/pages/AuthCallbackPage.tsx`)
- Magic-link callback → User onboarding: routes when incomplete (evidence: `src/pages/AuthCallbackPage.tsx`)
- Magic-link callback → Daily planner: routes when complete (evidence: `src/pages/AuthCallbackPage.tsx`)
- Daily planner → Morning reflection: presents
- Daily planner → Evening reflection: presents
- Daily planner → Daily entry autosave: edits entries
- Daily entry autosave → Supabase client: reads and saves (evidence: `src/hooks/useDailyEntry.ts`)
- Daily entry autosave → Authentication state: gets user (evidence: `src/hooks/useDailyEntry.ts`)
- Daily entry autosave → Encryption session: encrypts and decrypts (evidence: `src/hooks/useDailyEntry.ts`)
- Journal history → Supabase client: queries entries (evidence: `src/pages/HistoryPage.tsx`)
- Journal history → Encryption session: uses decryption (evidence: `src/pages/HistoryPage.tsx`)
- Insights experience → Deterministic analysis: requests analysis (evidence: `src/pages/InsightsPage.tsx`)
- Deterministic analysis → Encryption primitives: decrypts entries (evidence: `src/lib/insights-engine.ts`)
- Deterministic analysis → Supabase client: reads data (evidence: `src/lib/insights-engine.ts`)
- Settings and backup → User settings: manages settings (evidence: `src/pages/SettingsPage.tsx`)
- Settings and backup → Personalization data: manages preferences (evidence: `src/pages/SettingsPage.tsx`)
- Settings and backup → Encryption primitives: encrypts backups (evidence: `src/pages/SettingsPage.tsx`)
- Settings and backup → Push reminders: subscribes reminders (evidence: `src/pages/SettingsPage.tsx`)
- User onboarding → User settings: saves setup (evidence: `src/pages/OnboardingPage.tsx`)
- User onboarding → Personalization data: sets preferences (evidence: `src/pages/OnboardingPage.tsx`)
- User settings → Supabase client: reads and writes (evidence: `src/hooks/useUserSettings.ts`)
- User settings → Authentication state: gets user (evidence: `src/hooks/useUserSettings.ts`)
- Personalization data → Supabase client: reads and writes (evidence: `src/hooks/usePersonalisation.ts`)
- Personalization data → Authentication state: gets user (evidence: `src/hooks/usePersonalisation.ts`)
- Encryption session → Encryption primitives: calls cryptography (evidence: `src/contexts/CryptoContext.tsx`)
- Encryption session → Supabase client: stores key settings (evidence: `src/contexts/CryptoContext.tsx`)
- Authentication state → Supabase client: authenticates (evidence: `src/stores/auth-store.ts`)
- Supabase client → Supabase services: accesses (evidence: `README.md`)
- Insight generation function → Insights experience: serves insights
- Insight query function → Insights experience: serves queries
- Reminder function → Push reminders: dispatches reminders
