AddThisFeature

Scroll Position Restoration

Bring people back to where they were, not to the top of the list.

moderate Navigation

What it adds

Restore scroll position when a user returns to a list they navigated away from.

What your agent is told to do

5
  1. 1

    Record the scroll position when leaving a scrollable view and restore it when returning to the same view.

  2. 2

    Key the saved position on the full view state: route, filters, search, sort, and page. A position from a different filter is worse than the top of the list.

  3. 3

    Restore only on a return, meaning back navigation or a return from a detail view. A fresh visit starts at the top.

  4. 4

    Wait for the content that determines page height before restoring, or the restore will land in the wrong place.

  5. 5

    Do not fight the browser's own restoration. Take it over explicitly for the views you manage instead of running both.

Edge cases it handles

6
  • Images and embeds without reserved dimensions change the page height after restore. Reserve space or restore after they settle.
  • In a virtualized list the original node no longer exists. Restore by item identity and offset, not pixel value.
  • An infinite list must restore the loaded pages too, or the target position does not exist yet.
  • If the item the user was looking at has since been deleted, land near where it was rather than jumping.
  • Saved positions must be discarded when the view state changes, and must not grow without bound.
  • The restore jump must not be animated; scrolling the user through a thousand rows is worse than arriving.

Definition of done

8
  • Returning to a list from a detail view lands on the same item.
  • Positions are keyed by route, filters, search, sort, and pagination.
  • A fresh navigation to the view starts at the top.
  • Restoration happens after height-affecting content has loaded, with no visible second jump.
  • Virtualized and infinite lists restore correctly.
  • Stored positions are bounded and expire.
  • The feature matches the existing design system.
  • No existing functionality is broken.

Related features

How it works

  1. 1

    Copy the link

    Grab the Markdown instruction URL for this feature.

  2. 2

    Give it to your AI

    Paste it into Claude Code, Cursor, v0, Lovable — whatever you build with.

  3. 3

    It inspects, then implements

    Your agent reads your existing app first, then adds the feature to fit it.

Works with your stack

These instructions are written to adapt. They tell the agent to detect your framework, match your existing design system, and reuse what you already have — rather than assuming a particular stack.

Need it tighter than that? Customize the feature and tell it exactly what you're running.