# fjsg7mskqr-crypto/tracktub architecture

> Architecture diagram of the GitHub repository fjsg7mskqr-crypto/tracktub, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-11-16). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/fjsg7mskqr-crypto/tracktub
- Repository: https://github.com/fjsg7mskqr-crypto/tracktub

## Overview

TrackTub is a short-term-rental hot-tub turnover evidence product. The README describes the web app as a clickable demo, with a Supabase-backed rebuild planned; the sampled waitlist route already writes to Supabase, so that integration is shown only for waitlist signup. The principal product workflow runs from planning a visit through recording its evidence to sharing a report. Several app subsystems are represented by their exact directories because their implementation was not sampled; their links are omitted or marked unverified rather than inferred from folder names.

Main entry points: [`branding/motion/src/BrandReveal.tsx`](https://github.com/fjsg7mskqr-crypto/tracktub/blob/main/branding/motion/src/BrandReveal.tsx) (Brand reveal), [`branding/motion/src/theme.ts`](https://github.com/fjsg7mskqr-crypto/tracktub/blob/main/branding/motion/src/theme.ts) (Brand tokens), [`apps/web/src/components/visit`](https://github.com/fjsg7mskqr-crypto/tracktub/tree/main/apps/web/src/components/visit) (Visit capture), [`apps/web/src/app/landing/page.tsx`](https://github.com/fjsg7mskqr-crypto/tracktub/blob/main/apps/web/src/app/landing/page.tsx) (Product landing)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_turnover["Turnover operations"]
  node_home["Daily route"]
  node_calendar["Visit calendar"]
  node_tubs["Tub management"]
  node_visit["Visit capture"]
  node_visit_actions["Visit actions<br/>[visit.ts]"]
end

subgraph group_records["Evidence and reports"]
  node_evidence["Visit record"]
  node_proof["Public proof link<br/>[page.tsx]"]
  node_reports["Reports and history"]
end

subgraph group_workspace["Team and access"]
  node_people["Team access"]
  node_invite["Invite acceptance"]
  node_auth["Authentication<br/>[auth.ts]"]
  node_supabase["Supabase client<br/>[server.ts]"]
end

subgraph group_public["Public experience"]
  node_landing["Product landing<br/>[page.tsx]"]
  node_faq_content["Landing content<br/>[content.ts]"]
  node_waitlist_form["Waitlist form"]
  node_waitlist_route["Waitlist signup<br/>[route.ts]"]
  node_waitlist_store[("Waitlist table<br/>[server.ts]")]
  node_blog["Guides"]
end

subgraph group_brand["Brand motion"]
  node_brand_reveal["Brand reveal<br/>[BrandReveal.tsx]"]
  node_brand_mark["Animated mark<br/>[Mark.tsx]"]
  node_brand_atmosphere["Motion atmosphere<br/>[Atmosphere.tsx]"]
  node_verified_tag["Verified tag<br/>[VerifiedTag.tsx]"]
  node_brand_theme["Brand tokens<br/>[theme.ts]"]
  node_brand_fonts["Brand fonts<br/>[fonts.ts]"]
end

node_operator(("Operator"))
node_visitor(("Site visitor"))
node_owner(("Property owner"))

node_operator -.->|"plans visits"| node_home
node_home -.->|"starts visit"| node_visit
node_operator -.->|"schedules work"| node_calendar
node_operator -->|"manages tubs"| node_tubs
node_visit -.->|"submits actions"| node_visit_actions
node_visit -.->|"records evidence"| node_evidence
node_evidence -.->|"appears in reports"| node_reports
node_owner -.->|"opens report"| node_proof
node_operator -.->|"manages access"| node_people
node_people -.->|"invites member"| node_invite
node_visitor -->|"views"| node_landing
node_landing -->|"uses copy"| node_faq_content
node_landing -->|"renders form"| node_waitlist_form
node_waitlist_form -->|"posts signup"| node_waitlist_route
node_waitlist_route -->|"creates client"| node_supabase
node_waitlist_route -->|"inserts email"| node_waitlist_store
node_visitor -->|"reads guides"| node_blog
node_brand_reveal -->|"renders"| node_brand_mark
node_brand_reveal -->|"renders"| node_brand_atmosphere
node_brand_reveal -->|"renders"| node_verified_tag
node_brand_reveal -->|"uses tokens"| node_brand_theme
node_brand_reveal -->|"uses fonts"| node_brand_fonts
node_brand_mark -->|"uses tokens"| node_brand_theme
node_brand_atmosphere -->|"uses tokens"| node_brand_theme
node_verified_tag -->|"uses tokens"| node_brand_theme

click node_home "https://github.com/fjsg7mskqr-crypto/tracktub/tree/main/apps/web/src/components/home"
click node_calendar "https://github.com/fjsg7mskqr-crypto/tracktub/tree/main/apps/web/src/components/calendar"
click node_tubs "https://github.com/fjsg7mskqr-crypto/tracktub/tree/main/apps/web/src/app/tubs"
click node_visit "https://github.com/fjsg7mskqr-crypto/tracktub/tree/main/apps/web/src/components/visit"
click node_visit_actions "https://github.com/fjsg7mskqr-crypto/tracktub/blob/main/apps/web/src/lib/actions/visit.ts"
click node_evidence "https://github.com/fjsg7mskqr-crypto/tracktub/tree/main/apps/web/src/components/record"
click node_proof "https://github.com/fjsg7mskqr-crypto/tracktub/blob/main/apps/web/src/app/proof/%5Btoken%5D/page.tsx"
click node_reports "https://github.com/fjsg7mskqr-crypto/tracktub/tree/main/apps/web/src/app/reports"
click node_people "https://github.com/fjsg7mskqr-crypto/tracktub/tree/main/apps/web/src/app/people"
click node_invite "https://github.com/fjsg7mskqr-crypto/tracktub/tree/main/apps/web/src/app/invite/%5Btoken%5D"
click node_auth "https://github.com/fjsg7mskqr-crypto/tracktub/blob/main/apps/web/src/lib/auth.ts"
click node_supabase "https://github.com/fjsg7mskqr-crypto/tracktub/blob/main/apps/web/src/lib/supabase/server.ts"
click node_landing "https://github.com/fjsg7mskqr-crypto/tracktub/blob/main/apps/web/src/app/landing/page.tsx"
click node_faq_content "https://github.com/fjsg7mskqr-crypto/tracktub/blob/main/apps/web/src/app/landing/content.ts"
click node_waitlist_form "https://github.com/fjsg7mskqr-crypto/tracktub/blob/main/apps/web/src/app/landing/LandingWaitlist.tsx"
click node_waitlist_route "https://github.com/fjsg7mskqr-crypto/tracktub/blob/main/apps/web/src/app/landing/waitlist/route.ts"
click node_waitlist_store "https://github.com/fjsg7mskqr-crypto/tracktub/blob/main/apps/web/src/lib/supabase/server.ts"
click node_blog "https://github.com/fjsg7mskqr-crypto/tracktub/tree/main/apps/web/src/app/blog"
click node_brand_reveal "https://github.com/fjsg7mskqr-crypto/tracktub/blob/main/branding/motion/src/BrandReveal.tsx"
click node_brand_mark "https://github.com/fjsg7mskqr-crypto/tracktub/blob/main/branding/motion/src/components/Mark.tsx"
click node_brand_atmosphere "https://github.com/fjsg7mskqr-crypto/tracktub/blob/main/branding/motion/src/components/Atmosphere.tsx"
click node_verified_tag "https://github.com/fjsg7mskqr-crypto/tracktub/blob/main/branding/motion/src/components/VerifiedTag.tsx"
click node_brand_theme "https://github.com/fjsg7mskqr-crypto/tracktub/blob/main/branding/motion/src/theme.ts"
click node_brand_fonts "https://github.com/fjsg7mskqr-crypto/tracktub/blob/main/branding/motion/src/fonts.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_home,node_calendar,node_tubs,node_visit,node_visit_actions toneBlue
class node_evidence,node_proof,node_reports toneAmber
class node_people,node_invite,node_auth,node_supabase toneMint
class node_landing,node_faq_content,node_waitlist_form,node_waitlist_route,node_waitlist_store,node_blog toneRose
class node_brand_reveal,node_brand_mark,node_brand_atmosphere,node_verified_tag,node_brand_theme,node_brand_fonts,node_operator,node_visitor,node_owner toneIndigo
```

## Components

### Turnover operations

- [Daily route](https://github.com/fjsg7mskqr-crypto/tracktub/tree/main/apps/web/src/components/home): `apps/web/src/components/home`
- [Visit calendar](https://github.com/fjsg7mskqr-crypto/tracktub/tree/main/apps/web/src/components/calendar): `apps/web/src/components/calendar`
- [Tub management](https://github.com/fjsg7mskqr-crypto/tracktub/tree/main/apps/web/src/app/tubs): `apps/web/src/app/tubs`
- [Visit capture](https://github.com/fjsg7mskqr-crypto/tracktub/tree/main/apps/web/src/components/visit): `apps/web/src/components/visit`
- [Visit actions](https://github.com/fjsg7mskqr-crypto/tracktub/blob/main/apps/web/src/lib/actions/visit.ts): `apps/web/src/lib/actions/visit.ts`

### Evidence and reports

- [Visit record](https://github.com/fjsg7mskqr-crypto/tracktub/tree/main/apps/web/src/components/record): `apps/web/src/components/record`
- [Public proof link](https://github.com/fjsg7mskqr-crypto/tracktub/blob/main/apps/web/src/app/proof/%5Btoken%5D/page.tsx): `apps/web/src/app/proof/[token]/page.tsx`
- [Reports and history](https://github.com/fjsg7mskqr-crypto/tracktub/tree/main/apps/web/src/app/reports): `apps/web/src/app/reports`

### Team and access

- [Team access](https://github.com/fjsg7mskqr-crypto/tracktub/tree/main/apps/web/src/app/people): `apps/web/src/app/people`
- [Invite acceptance](https://github.com/fjsg7mskqr-crypto/tracktub/tree/main/apps/web/src/app/invite/%5Btoken%5D): `apps/web/src/app/invite/[token]`
- [Authentication](https://github.com/fjsg7mskqr-crypto/tracktub/blob/main/apps/web/src/lib/auth.ts): `apps/web/src/lib/auth.ts`
- [Supabase client](https://github.com/fjsg7mskqr-crypto/tracktub/blob/main/apps/web/src/lib/supabase/server.ts): `apps/web/src/lib/supabase/server.ts`

### Public experience

- [Product landing](https://github.com/fjsg7mskqr-crypto/tracktub/blob/main/apps/web/src/app/landing/page.tsx): `apps/web/src/app/landing/page.tsx`
- [Landing content](https://github.com/fjsg7mskqr-crypto/tracktub/blob/main/apps/web/src/app/landing/content.ts): `apps/web/src/app/landing/content.ts`
- [Waitlist form](https://github.com/fjsg7mskqr-crypto/tracktub/blob/main/apps/web/src/app/landing/LandingWaitlist.tsx): `apps/web/src/app/landing/LandingWaitlist.tsx`
- [Waitlist signup](https://github.com/fjsg7mskqr-crypto/tracktub/blob/main/apps/web/src/app/landing/waitlist/route.ts): `apps/web/src/app/landing/waitlist/route.ts`
- [Waitlist table](https://github.com/fjsg7mskqr-crypto/tracktub/blob/main/apps/web/src/lib/supabase/server.ts): `apps/web/src/lib/supabase/server.ts`
- [Guides](https://github.com/fjsg7mskqr-crypto/tracktub/tree/main/apps/web/src/app/blog): `apps/web/src/app/blog`

### Brand motion

- [Brand reveal](https://github.com/fjsg7mskqr-crypto/tracktub/blob/main/branding/motion/src/BrandReveal.tsx): `branding/motion/src/BrandReveal.tsx`
- [Animated mark](https://github.com/fjsg7mskqr-crypto/tracktub/blob/main/branding/motion/src/components/Mark.tsx): `branding/motion/src/components/Mark.tsx`
- [Motion atmosphere](https://github.com/fjsg7mskqr-crypto/tracktub/blob/main/branding/motion/src/components/Atmosphere.tsx): `branding/motion/src/components/Atmosphere.tsx`
- [Verified tag](https://github.com/fjsg7mskqr-crypto/tracktub/blob/main/branding/motion/src/components/VerifiedTag.tsx): `branding/motion/src/components/VerifiedTag.tsx`
- [Brand tokens](https://github.com/fjsg7mskqr-crypto/tracktub/blob/main/branding/motion/src/theme.ts): `branding/motion/src/theme.ts`
- [Brand fonts](https://github.com/fjsg7mskqr-crypto/tracktub/blob/main/branding/motion/src/fonts.ts): `branding/motion/src/fonts.ts`

### Other components

- **Operator**
- **Site visitor**
- **Property owner**

## Connections

- Operator → Daily route: plans visits
- Daily route → Visit capture: starts visit
- Operator → Visit calendar: schedules work
- Operator → Tub management: manages tubs (evidence: `apps/web/src/app/tubs/page.tsx`)
- Visit capture → Visit actions: submits actions
- Visit capture → Visit record: records evidence
- Visit record → Reports and history: appears in reports
- Property owner → Public proof link: opens report
- Operator → Team access: manages access
- Team access → Invite acceptance: invites member
- Site visitor → Product landing: views (evidence: `apps/web/src/app/landing/page.tsx`)
- Product landing → Landing content: uses copy (evidence: `apps/web/src/app/landing/page.tsx`)
- Product landing → Waitlist form: renders form (evidence: `apps/web/src/app/landing/page.tsx`)
- Waitlist form → Waitlist signup: posts signup (evidence: `apps/web/src/app/landing/LandingWaitlist.tsx`)
- Waitlist signup → Supabase client: creates client (evidence: `apps/web/src/app/landing/waitlist/route.ts`)
- Waitlist signup → Waitlist table: inserts email (evidence: `apps/web/src/app/landing/waitlist/route.ts`)
- Site visitor → Guides: reads guides
- Brand reveal → Animated mark: renders (evidence: `branding/motion/src/BrandReveal.tsx`)
- Brand reveal → Motion atmosphere: renders (evidence: `branding/motion/src/BrandReveal.tsx`)
- Brand reveal → Verified tag: renders (evidence: `branding/motion/src/BrandReveal.tsx`)
- Brand reveal → Brand tokens: uses tokens (evidence: `branding/motion/src/BrandReveal.tsx`)
- Brand reveal → Brand fonts: uses fonts (evidence: `branding/motion/src/BrandReveal.tsx`)
- Animated mark → Brand tokens: uses tokens (evidence: `branding/motion/src/components/Mark.tsx`)
- Motion atmosphere → Brand tokens: uses tokens (evidence: `branding/motion/src/components/Atmosphere.tsx`)
- Verified tag → Brand tokens: uses tokens (evidence: `branding/motion/src/components/VerifiedTag.tsx`)
