AddThisFeature

Customizable Dashboard Widgets

Let people arrange the panels that matter to them.

involved Analytics

What it adds

A widget system with a catalog, add and remove, drag-to-arrange layout, and persisted per-user layouts that survive permission and data changes.

What your agent is told to do

6
  1. 1

    Define a widget contract — identifier, title, size constraints, required permissions, and configuration schema — and register every widget against it.

  2. 2

    Give users a catalog to add from, removal, and rearranging, with the layout saved per user.

  3. 3

    Persist layout per breakpoint, or persist one layout and define deterministic reflow rules for narrow screens. Do not save absolute positions and hope they still make sense on a phone.

  4. 4

    Revalidate every widget on load against current permissions and data. A widget the user can no longer see must be removed or shown as unavailable, never rendered with someone else's numbers.

  5. 5

    Put a ceiling on cost: cap concurrent expensive widgets, load them lazily below the fold, and give each one its own error boundary.

  6. 6

    Do NOT implement metric computation, pre-aggregation, date ranges, or chart accessibility here — those are owned by Analytics Dashboard. Generic list and table preference storage is owned by Persistent View Preferences. Widgets consume those; they do not reimplement them.

Edge cases it handles

7
  • A widget removed from the catalog in a later release will still appear in saved layouts — handle the unknown identifier instead of crashing the dashboard.
  • A widget whose underlying data source is deleted must degrade to an unavailable tile, not an error page.
  • Overlapping or off-grid tiles after a resize must be reflowed deterministically; two users on the same layout must see the same result.
  • One slow widget must not block the rest of the dashboard from rendering.
  • Always offer a reset to the default layout — it is the only recovery when a saved layout is unusable.
  • An empty dashboard needs a real empty state pointing at the catalog, not blank space.
  • Layouts saved by one user and cloned to another must be re-validated against the second user's permissions before rendering.

Definition of done

8
  • Users can add, remove, and rearrange widgets, and the layout persists across sessions and devices.
  • Widget configuration is revalidated against current permissions and data on every load.
  • No layout produces overlapping or unreachable widgets at any supported width.
  • Expensive widgets are capped, lazily loaded, and individually error-bounded.
  • A reset-to-default action exists and works from a broken layout.
  • Metric computation and chart rendering are deferred to Analytics Dashboard.
  • 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.