AddThisFeature

Card and List View Toggle

Let users switch between a visual card view and a compact list without losing context.

simple UI & Polish

What it adds

Two renderings of the same result set, sharing one query, one selection, and one set of controls.

What your agent is told to do

5
  1. 1

    Drive both views from a single query and a single result set. The toggle is a rendering choice, not a second data path.

  2. 2

    Keep search, filters, sort, selection, and pagination identical across views. Switching must not clear a filter or reset the page.

  3. 3

    Give every row action a card equivalent and every card action a row equivalent. If an action exists in only one view, users will not find it.

  4. 4

    Switch without refetching data you already have, and without a flash of empty state on the way.

  5. 5

    Persisting the chosen view is owned by Persistent View Preferences; use it rather than adding another storage mechanism.

Edge cases it handles

6
  • Page size that suits a list is usually wrong for cards — if it differs, changing view must keep the user looking at the same records, not the same page number.
  • Selection must survive the switch, including selections scrolled out of view.
  • The empty, loading, and error states need a treatment in both views, not just the default one.
  • Both views must enforce the same permissions — a card must not reveal a field the list hides.
  • Cards without an image need a defined placeholder, or the grid collapses into ragged rows.
  • The toggle itself must be keyboard-operable and announce the current view, not just show a highlighted icon.

Definition of done

8
  • Switching views issues no additional data request and shows no flicker.
  • Search, filters, sort, selection, and position in the result set are preserved.
  • Every action is available in both views.
  • Empty, loading, and error states exist for both renderings.
  • The two views expose exactly the same fields under the same permissions.
  • The chosen view is persisted through Persistent View Preferences.
  • 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.