Skip to content

Homepage: scroll-pinned story chapters driven by curve math - #115

Merged
charan-rathore merged 1 commit into
mainfrom
feat/story-chapters
Nov 13, 2026
Merged

charan-rathore merged 1 commit into
mainfrom
feat/story-chapters

Conversation

@charan-rathore

Copy link
Copy Markdown
Owner

The homepage now tells its story in scroll-pinned chapters, the way Wispr Flow does. It replaces the orbit hero and the three looping panels, which sat empty for much of each loop.

What you see

  1. Your work, remembered. A scattered day of notes flies into one log, joined by a thread that draws itself.
  2. Write it down. Three lines are typed and land in the log. The third replaces the first, which is struck through and linked to it.
  3. Find it again. The page floods to periwinkle paper from the search box. The query pulls three matches out of a wall of notes and issues. Keyword score ranks the old Redis decision first, then the replacement rule swaps the two.
  4. See what's next. Open items lift out of the week into a ranked list, each showing the rule that put it there, and the top one opens into its actions.
  5. The number. Keyword search (73%) against memoRABLE semantic search (97%) on the 179-query duplicate-issue benchmark. Both numbers come from bench-results.ts.

After the chapters come the live analyzer, the live demo search (now titled "Try it on a sample memory"), briefs and the workspace.

How the motion works

  • Scroll-driven: each scene is a pure function of scroll progress, so every scroll position has exactly one frame and scrolling back plays it in reverse. The code is in src/motion/scroll-scene.ts.
  • Smoothing: progress is smoothed with frame-rate independent damping (half-life 70 ms). Under reduced motion the smoothing is off.
  • New curve helpers (in src/motion/curves.ts, with unit tests):
    • flight: Bézier travel that banks along its tangent;
    • catmullRomPath: a thread that passes through every note;
    • span;
    • Emil Kowalski's EASE_OUT and EASE_IO;
    • a seeded rng.
  • No animation library. Positions are written as transforms, and React does not re-render per frame.
  • Type: Instrument Serif (OFL, self-hosted) is used for chapter headlines only. Geist stays for everything else.
  • Accessibility: the scenes are aria-hidden; each chapter's copy says the same thing in words. Inactive scroll-spy steps are dimmed with colour rather than opacity, so they keep readable contrast.

Checked

  • Rendered with bun and Playwright at 1440×900 and 390×844, at several progress values per chapter.
  • Recorded a full scroll-through at both sizes.
  • motion-curves unit tests pass locally.
  • Updated the e2e heading.
  • Updated docs/design/SYSTEM.md (motion, story order, and how to verify chapters).

Generated by Claude Code

…math

Replace the hero orbit and the three looping panels with four pinned
chapters and a measured-number chapter. Each scene is a pure function of
scroll progress: Bézier flights that bank along their tangent, a
Catmull-Rom thread drawn by arc length, damped progress, importance-ordered
staggers. Search chapter floods the page to paper from the search box.
Instrument Serif for chapter headlines only. The live demo search moves
below the story.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01RuUzfKR31rVxVEVZEEP8Vd
@vercel

vercel Bot commented Nov 13, 2026

Copy link
Copy Markdown

The latest updates on your projects. Learn more about Vercel for GitHub.

Project Deployment Actions Updated
memo-rable Ready Ready Preview Nov 13, 2026 11:12am UTC

@chatgpt-codex-connector

chatgpt-codex-connector Bot commented Nov 13, 2026 •

Copy link
Copy Markdown
Codex Review Summary: ✅ Completed

This comment shows the latest Codex review activity on this pull request.

Review Status Commit Review trigger
📝 Code Review ✅ Completed 2026-11-13T11:13:40.564488Z 8ffc446 PR opened
ℹ️ About Codex in GitHub

Your team has set up Codex to review pull requests in this repo. Reviews are triggered when you

  • Open a pull request for review
  • Mark a draft as ready
  • Comment "@codex review" or "@codex security review".

Codex reacts with 👀 while any review is running, comments if it has suggestions, and reacts with 👍 once all reviews finish with no findings.

@chatgpt-codex-connector chatgpt-codex-connector Bot left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

💡 Codex Review

Here are some automated review suggestions for this pull request.

Reviewed commit: 8ffc4460d1

ℹ️ About Codex in GitHub

Your team has set up Codex to review pull requests in this repo. Reviews are triggered when you

  • Open a pull request for review
  • Mark a draft as ready
  • Comment "@codex review".

If Codex has suggestions, it will comment; otherwise it will react with 👍.

Codex can also answer questions or update the PR. Try commenting "@codex address that feedback".

const fr = EASE_OUT(span(p, 0, 0.16));
if (flood.current) flood.current.style.clipPath = `circle(${(fr * R).toFixed(1)}px at ${fc.x.toFixed(0)}px ${fc.y.toFixed(0)}px)`;
const shown = EASE_OUT(span(p, 0.08, 0.2));
if (copy.current) { copy.current.style.opacity = shown.toFixed(3); copy.current.style.transform = `translateY(${((1 - shown) * 16).toFixed(1)}px)`; }

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

P2 Badge Preserve desktop centering when animating the search copy

On desktop, .ch-copy uses top: 50% and translateY(-50%) to center the heading and steps, but this inline transform replaces that centering with a pixel-only translation. Once the entrance finishes, the entire copy block starts halfway down the stage. At common laptop viewport heights, the later steps extend below the stage and are clipped by .ch-stage { overflow: hidden }; scrolling through the pinned chapter never reveals them. Compose the entrance offset with the desktop centering transform while retaining the mobile layout's uncentered positioning.

Useful? React with 👍 / 👎.

@charan-rathore
charan-rathore merged commit c842e37 into main Nov 13, 2026
6 checks passed

This branch was successfully deployed

1 active deployment
Preview — 8ffc4460 Deployed Nov 13, 2026 by vercel[bot]
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants