# Project Modules block

> Modules data grid with circular progress rings, status badges, and row actions

Project modules table with per-row circular progress ring, task counts, date window, and status badges. Search, sort, status-filter, pagination, and row actions. ReUI DataGrid and Badge with shadcn DropdownMenu and InputGroup. For module manager.

- Type: Pro block
- Category: [Base](https://web.dev.reui.io/blocks/data-grid/base.md)
- Page: https://web.dev.reui.io/blocks/data-grid/base/data-grid-base-7
- Docs (Base UI): https://web.dev.reui.io/docs/components/base/data-grid.md
- Docs (Radix UI): https://web.dev.reui.io/docs/components/radix/data-grid.md
- MCP: `get_block("data-grid-base-7")`
- Built with: Badge, Button, Data Grid, Dropdown Menu, Input Group
- Installs with a ReUI Pro or Ultimate license; setup: https://web.dev.reui.io/docs/license-setup

## Best for

Project modules with a readiness ring and tasks done count, a date window with its length, a favorite star and a sort by menu

## Agent notes

- Replace `MODULE_RECORDS`; the ring reads `progress` while the tasks label reads `tasksCompleted` and `tasksTotal`, so keep them in step
- `dateRange` is a preformatted label; the N-day window length comes from `dateStart` and `dateEnd`, so update all three together
- `handleModuleAction` and `handleAddModule` only toast, except favorite, which flips local `modules` state

## When not to use

- Modules paged by an API, with sorting and search sent to the server: use [Data Grid](https://web.dev.reui.io/components/data-grid.md) (`get_component("data-grid")`)

## Third-party libraries

- TanStack Table v9: [API reference](https://tanstack.com/table/v9/docs/framework/react/reference/index), [docs](https://tanstack.com/table/v9/docs/framework/react/quick-start)
- Sonner v2: [API reference](https://sonner.emilkowal.ski/toast), [docs](https://sonner.emilkowal.ski/getting-started)

## Install

```bash
npx shadcn@latest add @reui/data-grid-base-7
```

## About Base blocks

### When to use

- A whole table section: a title, a create button, filter controls, the rows and pagination
- Customer, contact and deal tables for a sales team, with a row menu, pinned rows or a rule filter bar
- Operations tables for support tickets, weekly timesheets, team members, project modules or SKU prices

### When not to use

- A bare table for your own columns and rows, without a title bar, toolbar or demo rows: use [Data Grid](https://web.dev.reui.io/components/data-grid.md) (`get_component("data-grid")`)
- Thousands of rows in one scrolling list that loads more as the reader nears the end: use the [Virtualization blocks](https://web.dev.reui.io/blocks/data-grid/virtualization.md)
- A payments ledger, a renewals queue or an automation library led by a rule filter bar: use the [Filtering blocks](https://web.dev.reui.io/blocks/data-grid/filtering.md)

### Agent notes

- Each page.tsx wraps the table in a centered `min-h-svh` main under an sr-only `h1`; drop that wrapper and keep a single `h1` once it sits in your page
- Each block filters and pages its data.tsx rows in the browser with `pagination` in local state; move both to your API before the row count grows large

Every ReUI item has a twin like this one; the index is https://web.dev.reui.io/llms.txt. Agents with the ReUI MCP (https://web.dev.reui.io/docs/mcp) get the same guidance from the getters named above.