Home

# Design pass proposal: GSAP, Lenis, React Bits
Nov 19, 2026. Proposal only. No live page has been changed. Originals stay untouched; every change goes into a new `-motion` copy first.

## What each tool is for
- **GSAP** (with ScrollTrigger): the animation engine. Timed reveals, staggered lists, scroll-linked effects, count-ups. Free to use.
- **Lenis**: smooth, eased scrolling that keeps native scroll (links, sticky, accessibility keep working). It is meant to run together with GSAP ScrollTrigger.
- **React Bits**: a library of animated React components (split text, spotlight card, aurora background, count up, magnetic buttons). Our pages are plain HTML, not React, and its license (MIT + Commons Clause) forbids reselling it. So we copy the *patterns* and write our own small vanilla versions. Nothing from it is pasted in.

## Sample ready
`/mnt/project-files/review-hub-motion.html` (before: `review-hub.html`). It shows: letters of the title rising in, numbers counting up, a gold scroll-progress bar, cards revealing in a stagger as you scroll, a glow that follows the pointer on each card, a slow drifting aurora background, smooth Lenis scrolling. Tested at desktop width with the real libraries; with reduced motion, or if the libraries fail to load, the page just shows normally.

## Ranked recommendations (what I'd do first)
1. **Reveal-on-scroll with stagger** (GSAP ScrollTrigger). Biggest "feels designed" gain, lowest risk. Every page.
2. **Split-text titles** (React Bits pattern). Hero titles on onboarding, pitch, decks.
3. **Spotlight cards and button glow** (React Bits pattern). Hub, onboarding, war room.
4. **Count-up numbers** (React Bits pattern). Only on numbers that are real and sourced (pitch, war room, hub counts).
5. **Soft aurora background** (React Bits pattern, CSS only, stays soft, never dark black).
6. **Lenis smooth scroll.** Great on long scrolling pages (hub, onboarding, pitch). Skip on call decks that use arrow-key slides.
7. **Scroll progress bar.** Long pages only.
8. **Magnetic buttons, cursor trails, 3D tilt.** Skip: flashy, hurts phone use, little value.

## Page by page
| Page | Changes (in order) | Lenis? |
|---|---|---|
| Review Hub | Done as the sample | Yes |
| Investor pitch (another thread is building it) | Section reveals, split-text hero, count-up on sourced numbers, progress bar. I will hand that thread the snippet, not edit the file | Yes |
| Roundtable onboarding | Step-by-step reveal, split-text welcome, spotlight option cards, progress bar that fills as steps finish | Yes |
| Nap AI onboarding | Same as above, plus a soft aurora behind the hero | Yes |
| War room | Count-up tiles, staggered tiles on load, subtle pulse on live items | No (it is a dashboard) |
| Call decks 12:00, 12:30, 1:00 | Slide-in per slide on key press, title split text. Keep arrow keys exactly as they are | No |
| Briefing room, Briefing builder | Card reveals and spotlight only | No |

## Rules I'd keep on every page
Page works with no animation (reduced motion or failed load). Text 14 px or larger, taps 44 px or taller, one gold main button. Locked lines and the income disclaimer untouched. No em dashes. Soft background, never black. Backup before each edit, nothing deleted. Libraries only from cdn.jsdelivr.net with fixed versions. Fable review before anything is shown as done.

## Risks
- Libraries load from a CDN, so an offline viewer sees the page without animation (still fully readable).
- Smooth scroll can feel odd to some people; reduced motion turns it off.
- Publishing as a Claude artifact is limited until 7 PM ET today, so the sample is a file for now.