How atetoon/whatsapp-wrapped works
WhatsApp Wrapped is a browser-based chat-export analytics app. The user selects or drops a WhatsApp .txt export; the page reads it locally, parses messages, computes statistics, then presents an animated, navigable 13-card deck. The stats implementation covers reply timing, activity patterns, media, deletes, drama, and a rule-based relationship verdict. A separate anonymous usage counter is the documented server-side exception. Relationships follow the excerpts, SOURCE INDEX references, and README; unexcerpted counter wiring is not inferred.
Main entry points: slides.tsx Analytics cards · page.tsx Home workflow · UploadScreen.tsx Upload screen · WrappedDeck.tsx Card deck
Components 21
Upload and analysis
- Home workflow
app/page.tsx - Upload screen
components/UploadScreen.tsx - Export parser
lib/parser.ts - Chat statistics
lib/stats.ts - Chat data types
lib/types.ts
Wrapped deck
- Card deck
components/WrappedDeck.tsx - Analytics cards
components/slides.tsx - Display formatting
lib/format.ts
Deck effects
- Ghost stack
components/effects/GhostStack.tsx - Progress ring
components/effects/ProgressRing.tsx - Odometer
components/effects/Odometer.tsx - Scramble text
components/effects/ScrambleText.tsx - Stagger text
components/effects/StaggerText.tsx - Shine wrapper
components/effects/ShineWrap.tsx - Mini bar chart
components/effects/MiniBarChart.tsx - Confetti burst
components/effects/ConfettiBurst.tsx
Usage counter
- Usage counter
components/UsageCounter.tsx - Count endpoint
app/api/count/route.ts - Upstash Redis
Other components
- Chat owner
- Chat export
Connections 23
- Chat owner → Upload screen: selects export
components/UploadScreen.tsx - Chat export → Upload screen: supplies file
components/UploadScreen.tsx - Upload screen → Home workflow: passes file
components/UploadScreen.tsx - Home workflow → Export parser: parses locally
app/page.tsx - Export parser → Home workflow: returns messages
app/page.tsx - Home workflow → Chat statistics: computes stats
app/page.tsx - Chat statistics → Chat data types: uses data types
lib/stats.ts - Export parser → Chat data types: uses message type
lib/parser.ts - Home workflow → Card deck: renders results
app/page.tsx - Home workflow → Upload screen: renders intake
app/page.tsx - Card deck → Analytics cards: builds cards
components/WrappedDeck.tsx - Analytics cards → Display formatting: formats values
components/slides.tsx - Analytics cards → Odometer: renders numbers
components/slides.tsx - Analytics cards → Scramble text: renders headings
components/slides.tsx - Analytics cards → Stagger text: reveals text
components/slides.tsx - Analytics cards → Shine wrapper: wraps highlights
components/slides.tsx - Analytics cards → Mini bar chart: renders charts
components/slides.tsx - Analytics cards → Confetti burst: renders finale
components/slides.tsx - Card deck → Ghost stack: renders stack
components/WrappedDeck.tsx - Card deck → Progress ring: renders progress
components/WrappedDeck.tsx - Upload screen → Usage counter: renders counter
components/UploadScreen.tsx - Home workflow → Count endpoint: posts usage
app/page.tsx - Count endpoint → Upstash Redis: tracks usage
README.md