# ericbss05/use-wake-up architecture

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

- Interactive diagram: https://gitdiagram.com/ericbss05/use-wake-up
- Repository: https://github.com/ericbss05/use-wake-up

## Overview

Wake Up is a study-support web app whose main workflow collects a learner’s email, grants access by token, accepts a course PDF, indexes its text, and generates a document-grounded mind map for display. The repository also presents a marketing landing page and includes a subscriber email flow. The upload, retrieval, and mind-map paths are evidenced in sampled source; several other landing sections are represented from the SOURCE INDEX, which establishes their imports but not their detailed behavior.

Main entry points: [`app/page.tsx`](https://github.com/ericbss05/use-wake-up/blob/main/app/page.tsx) (Landing page), [`components/landing/how-it-work.tsx`](https://github.com/ericbss05/use-wake-up/blob/main/components/landing/how-it-work.tsx) (How it works), [`lib/pinecone.ts`](https://github.com/ericbss05/use-wake-up/blob/main/lib/pinecone.ts) (PDF indexing), [`app/api/send/route.ts`](https://github.com/ericbss05/use-wake-up/blob/main/app/api/send/route.ts) (Signup endpoint)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_web["Web experience"]
  node_home["Landing page<br/>[page.tsx]"]
  node_hero["Signup hero<br/>[hero.tsx]"]
  node_benefits["Benefits<br/>[benefits.tsx]"]
  node_how["How it works<br/>[how-it-work.tsx]"]
  node_feature1["Feature one<br/>[feature-1.tsx]"]
  node_feature2["Feature two<br/>[feature-2.tsx]"]
  node_feature3["Feature three<br/>[feature-3.tsx]"]
  node_future["Future vision<br/>[future.tsx]"]
  node_faq["FAQ<br/>[faq.tsx]"]
  node_cta["Call to action<br/>[cta.tsx]"]
  node_header["Site header<br/>[header.tsx]"]
  node_footer["Site footer<br/>[footer.tsx]"]
end

subgraph group_study["Study workflow"]
  node_onboard["Onboarding flow"]
  node_step1["Onboarding step one<br/>[step-1.tsx]"]
  node_step2["PDF upload step<br/>[step-2.tsx]"]
  node_chatpage["Mind-map page<br/>[page.tsx]"]
  node_mindmap["Mind-map viewer<br/>[mindmap.tsx]"]
end

subgraph group_services["Application services"]
  node_upload["Upload endpoint<br/>[route.ts]"]
  node_indexer["PDF indexing<br/>[pinecone.ts]"]
  node_embeddings["Text embeddings<br/>[embeddings.ts]"]
  node_ai["AI generation endpoint<br/>[route.ts]"]
  node_verify["Token verification<br/>[route.ts]"]
  node_send["Signup endpoint<br/>[route.ts]"]
  node_email["Welcome email template<br/>[email-template.tsx]"]
end

subgraph group_storage["Persistence and integrations"]
  node_prisma["Subscriber database access<br/>[prisma.ts]"]
  node_schema["Subscriber schema<br/>[schema.prisma]"]
  node_pinecone[("Vector index")]
  node_google["Google AI services"]
  node_resend["Resend email service"]
  node_pdfparser["PDF parsing tools"]
end

node_learner(("Learner"))

node_learner -->|"visits"| node_home
node_home -->|"renders"| node_header
node_home -->|"renders"| node_hero
node_home -->|"renders"| node_benefits
node_home -->|"renders"| node_how
node_home -->|"renders"| node_future
node_home -->|"renders"| node_faq
node_home -->|"renders"| node_cta
node_home -->|"renders"| node_footer
node_how -->|"renders"| node_feature1
node_how -->|"renders"| node_feature2
node_how -->|"renders"| node_feature3
node_hero -->|"submits email"| node_send
node_send -->|"stores subscriber"| node_prisma
node_send -->|"renders email"| node_email
node_send -->|"sends email"| node_resend
node_prisma -.->|"uses schema"| node_schema
node_learner -.->|"starts onboarding"| node_onboard
node_onboard -->|"renders"| node_step1
node_onboard -->|"renders"| node_step2
node_step2 -->|"uploads PDF"| node_upload
node_upload -->|"loads PDF"| node_indexer
node_indexer -.->|"parses PDF"| node_pdfparser
node_indexer -->|"embeds chunks"| node_embeddings
node_embeddings -.->|"requests embeddings"| node_google
node_indexer -->|"upserts vectors"| node_pinecone
node_step2 -->|"redirects after upload"| node_chatpage
node_chatpage -->|"renders"| node_mindmap
node_mindmap -->|"checks token"| node_verify
node_verify -->|"checks subscriber"| node_prisma
node_mindmap -->|"requests mind map"| node_ai
node_ai -->|"queries vectors"| node_pinecone
node_ai -.->|"generates response"| node_google
node_learner -.->|"views result"| node_mindmap

click node_home "https://github.com/ericbss05/use-wake-up/blob/main/app/page.tsx"
click node_hero "https://github.com/ericbss05/use-wake-up/blob/main/components/landing/hero.tsx"
click node_benefits "https://github.com/ericbss05/use-wake-up/blob/main/components/landing/benefits.tsx"
click node_how "https://github.com/ericbss05/use-wake-up/blob/main/components/landing/how-it-work.tsx"
click node_feature1 "https://github.com/ericbss05/use-wake-up/blob/main/components/landing/features/feature-1.tsx"
click node_feature2 "https://github.com/ericbss05/use-wake-up/blob/main/components/landing/features/feature-2.tsx"
click node_feature3 "https://github.com/ericbss05/use-wake-up/blob/main/components/landing/features/feature-3.tsx"
click node_future "https://github.com/ericbss05/use-wake-up/blob/main/components/landing/future.tsx"
click node_faq "https://github.com/ericbss05/use-wake-up/blob/main/components/landing/faq.tsx"
click node_cta "https://github.com/ericbss05/use-wake-up/blob/main/components/landing/cta.tsx"
click node_header "https://github.com/ericbss05/use-wake-up/blob/main/components/landing/header.tsx"
click node_footer "https://github.com/ericbss05/use-wake-up/blob/main/components/landing/footer.tsx"
click node_onboard "https://github.com/ericbss05/use-wake-up/blob/main/components/onboarding-form.tsx"
click node_step1 "https://github.com/ericbss05/use-wake-up/blob/main/components/onboarding/step-1.tsx"
click node_step2 "https://github.com/ericbss05/use-wake-up/blob/main/components/onboarding/step-2.tsx"
click node_upload "https://github.com/ericbss05/use-wake-up/blob/main/app/api/upload/route.ts"
click node_indexer "https://github.com/ericbss05/use-wake-up/blob/main/lib/pinecone.ts"
click node_embeddings "https://github.com/ericbss05/use-wake-up/blob/main/lib/embeddings.ts"
click node_chatpage "https://github.com/ericbss05/use-wake-up/blob/main/app/(onboarding)/mvp/chat/page.tsx"
click node_mindmap "https://github.com/ericbss05/use-wake-up/blob/main/components/mindmap.tsx"
click node_ai "https://github.com/ericbss05/use-wake-up/blob/main/app/api/ai/route.ts"
click node_verify "https://github.com/ericbss05/use-wake-up/blob/main/app/api/verify-token/route.ts"
click node_send "https://github.com/ericbss05/use-wake-up/blob/main/app/api/send/route.ts"
click node_email "https://github.com/ericbss05/use-wake-up/blob/main/components/email-template.tsx"
click node_prisma "https://github.com/ericbss05/use-wake-up/blob/main/lib/prisma.ts"
click node_schema "https://github.com/ericbss05/use-wake-up/blob/main/prisma/schema.prisma"

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_home,node_hero,node_benefits,node_how,node_feature1,node_feature2,node_feature3,node_future,node_faq,node_cta,node_header,node_footer toneBlue
class node_onboard,node_step1,node_step2,node_chatpage,node_mindmap toneAmber
class node_upload,node_indexer,node_embeddings,node_ai,node_verify,node_send,node_email toneMint
class node_prisma,node_schema,node_pinecone,node_google,node_resend,node_pdfparser toneRose
class node_learner toneIndigo
```

## Components

### Web experience

- [Landing page](https://github.com/ericbss05/use-wake-up/blob/main/app/page.tsx): `app/page.tsx`
- [Signup hero](https://github.com/ericbss05/use-wake-up/blob/main/components/landing/hero.tsx): `components/landing/hero.tsx`
- [Benefits](https://github.com/ericbss05/use-wake-up/blob/main/components/landing/benefits.tsx): `components/landing/benefits.tsx`
- [How it works](https://github.com/ericbss05/use-wake-up/blob/main/components/landing/how-it-work.tsx): `components/landing/how-it-work.tsx`
- [Feature one](https://github.com/ericbss05/use-wake-up/blob/main/components/landing/features/feature-1.tsx): `components/landing/features/feature-1.tsx`
- [Feature two](https://github.com/ericbss05/use-wake-up/blob/main/components/landing/features/feature-2.tsx): `components/landing/features/feature-2.tsx`
- [Feature three](https://github.com/ericbss05/use-wake-up/blob/main/components/landing/features/feature-3.tsx): `components/landing/features/feature-3.tsx`
- [Future vision](https://github.com/ericbss05/use-wake-up/blob/main/components/landing/future.tsx): `components/landing/future.tsx`
- [FAQ](https://github.com/ericbss05/use-wake-up/blob/main/components/landing/faq.tsx): `components/landing/faq.tsx`
- [Call to action](https://github.com/ericbss05/use-wake-up/blob/main/components/landing/cta.tsx): `components/landing/cta.tsx`
- [Site header](https://github.com/ericbss05/use-wake-up/blob/main/components/landing/header.tsx): `components/landing/header.tsx`
- [Site footer](https://github.com/ericbss05/use-wake-up/blob/main/components/landing/footer.tsx): `components/landing/footer.tsx`

### Study workflow

- [Onboarding flow](https://github.com/ericbss05/use-wake-up/blob/main/components/onboarding-form.tsx): `components/onboarding-form.tsx`
- [Onboarding step one](https://github.com/ericbss05/use-wake-up/blob/main/components/onboarding/step-1.tsx): `components/onboarding/step-1.tsx`
- [PDF upload step](https://github.com/ericbss05/use-wake-up/blob/main/components/onboarding/step-2.tsx): `components/onboarding/step-2.tsx`
- [Mind-map page](https://github.com/ericbss05/use-wake-up/blob/main/app/(onboarding)/mvp/chat/page.tsx): `app/(onboarding)/mvp/chat/page.tsx`
- [Mind-map viewer](https://github.com/ericbss05/use-wake-up/blob/main/components/mindmap.tsx): `components/mindmap.tsx`

### Application services

- [Upload endpoint](https://github.com/ericbss05/use-wake-up/blob/main/app/api/upload/route.ts): `app/api/upload/route.ts`
- [PDF indexing](https://github.com/ericbss05/use-wake-up/blob/main/lib/pinecone.ts): `lib/pinecone.ts`
- [Text embeddings](https://github.com/ericbss05/use-wake-up/blob/main/lib/embeddings.ts): `lib/embeddings.ts`
- [AI generation endpoint](https://github.com/ericbss05/use-wake-up/blob/main/app/api/ai/route.ts): `app/api/ai/route.ts`
- [Token verification](https://github.com/ericbss05/use-wake-up/blob/main/app/api/verify-token/route.ts): `app/api/verify-token/route.ts`
- [Signup endpoint](https://github.com/ericbss05/use-wake-up/blob/main/app/api/send/route.ts): `app/api/send/route.ts`
- [Welcome email template](https://github.com/ericbss05/use-wake-up/blob/main/components/email-template.tsx): `components/email-template.tsx`

### Persistence and integrations

- [Subscriber database access](https://github.com/ericbss05/use-wake-up/blob/main/lib/prisma.ts): `lib/prisma.ts`
- [Subscriber schema](https://github.com/ericbss05/use-wake-up/blob/main/prisma/schema.prisma): `prisma/schema.prisma`
- **Vector index**
- **Google AI services**
- **Resend email service**
- **PDF parsing tools**

### Other components

- **Learner**

## Connections

- Learner → Landing page: visits (evidence: `app/page.tsx`)
- Landing page → Site header: renders (evidence: `app/page.tsx`)
- Landing page → Signup hero: renders (evidence: `app/page.tsx`)
- Landing page → Benefits: renders (evidence: `app/page.tsx`)
- Landing page → How it works: renders (evidence: `app/page.tsx`)
- Landing page → Future vision: renders (evidence: `app/page.tsx`)
- Landing page → FAQ: renders (evidence: `app/page.tsx`)
- Landing page → Call to action: renders (evidence: `app/page.tsx`)
- Landing page → Site footer: renders (evidence: `app/page.tsx`)
- How it works → Feature one: renders (evidence: `components/landing/how-it-work.tsx`)
- How it works → Feature two: renders (evidence: `components/landing/how-it-work.tsx`)
- How it works → Feature three: renders (evidence: `components/landing/how-it-work.tsx`)
- Signup hero → Signup endpoint: submits email (evidence: `components/landing/hero.tsx`)
- Signup endpoint → Subscriber database access: stores subscriber (evidence: `app/api/send/route.ts`)
- Signup endpoint → Welcome email template: renders email (evidence: `app/api/send/route.ts`)
- Signup endpoint → Resend email service: sends email (evidence: `app/api/send/route.ts`)
- Subscriber database access → Subscriber schema: uses schema
- Learner → Onboarding flow: starts onboarding
- Onboarding flow → Onboarding step one: renders (evidence: `components/onboarding-form.tsx`)
- Onboarding flow → PDF upload step: renders (evidence: `components/onboarding-form.tsx`)
- PDF upload step → Upload endpoint: uploads PDF (evidence: `components/onboarding/step-2.tsx`)
- Upload endpoint → PDF indexing: loads PDF (evidence: `app/api/upload/route.ts`)
- PDF indexing → PDF parsing tools: parses PDF
- PDF indexing → Text embeddings: embeds chunks (evidence: `lib/pinecone.ts`)
- Text embeddings → Google AI services: requests embeddings
- PDF indexing → Vector index: upserts vectors (evidence: `lib/pinecone.ts`)
- PDF upload step → Mind-map page: redirects after upload (evidence: `components/onboarding/step-2.tsx`)
- Mind-map page → Mind-map viewer: renders (evidence: `app/(onboarding)/mvp/chat/page.tsx`)
- Mind-map viewer → Token verification: checks token (evidence: `components/mindmap.tsx`)
- Token verification → Subscriber database access: checks subscriber (evidence: `app/api/verify-token/route.ts`)
- Mind-map viewer → AI generation endpoint: requests mind map (evidence: `components/mindmap.tsx`)
- AI generation endpoint → Vector index: queries vectors (evidence: `app/api/ai/route.ts`)
- AI generation endpoint → Google AI services: generates response
- Learner → Mind-map viewer: views result
