# React Native Blocks (Pro)

> Ready React Native blocks for iOS, Android and the web: kanban board with drag and drop, event calendar, agenda, Gantt chart, timeline, wizard, stats row, pricing table, product card, review list, order tracker, activity feed, AI agent activity, AI usage meter and approval card. Accessible, animated, themeable, zero native code.

# Blocks Pro

Blocks are the bigger pieces of an app: a kanban board, a calendar, a pricing table. Each is one component with props for the simple case and render props for the rest. They're built on `patine-ui`, so they follow your theme and `design` and work with a keyboard and a screen reader. They animate only through the library's motion, so they're still when the OS asks to reduce motion.

```tsx
import { Kanban, EventCalendar, PricingTable } from '@patine-ui/pro';
```

| Block | What it's for |
| --- | --- |
| [Stats row](./stats-row) | A dashboard's key figures with their change and trend; tiles can switch a chart |
| [Timeline](./timeline) | Events along a line: a history, a shipment, an incident |
| [Activity feed](./activity-feed) | Who did what, newest first, by day, with filters and unread dots |
| [Order tracker](./order-tracker) | Where an order is, with the carrier's scans |
| [Wizard](./wizard) | A task in steps, with validation and a finish |
| [Pricing table](./pricing-table) | Plans as cards, a comparison table or a phone paywall list |
| [Product card](./product-card) | A product in a grid, with swatches, wishlist and Add to cart |
| [Review list](./review-list) | Customer reviews with their summary, filters and Helpful votes |
| [Kanban](./kanban) | Columns of cards to drag, with WIP limits and a Move to menu |
| [Agenda](./agenda) | The days ahead as a list under a week strip |
| [Event calendar](./event-calendar) | Events by month, week or day |
| [Gantt](./gantt) | A project's tasks on a timeline, dragged to reschedule |
| [AI usage meter](./ai-usage-meter) | Tokens or credits used against the plan's limit |
| [Agent activity](./agent-activity) | What an AI agent is doing, step by step |
| [Approval card](./ai-approval) | An assistant's change, held until the person approves it |
| [Onboarding](./onboarding), [Sign in](./sign-in), [Paywall](./paywall), [Settings](./settings), [Profile](./profile), [Checkout](./checkout) | Whole single screens, each built from free components. For whole apps, see the [templates](/templates) |

## What every block shares

- **`design`** and **`theme`**: the look of the provider, or the block's own.
- **`density`**: `'compact'`, `'comfortable'` (default) or `'spacious'`.
- **`animate`**: entries fade and rise in, changes glide; off with reduce motion or `animate={false}`.
- **`loading`**, **`error`** with **`onRetry`**, **`emptyTitle`**, **`emptyDescription`** and **`renderEmpty`**: a skeleton of the content, a calm error with Try again, or a helpful empty state.
- **Controlled or not**: state like the selected tile or the current step takes `value` and `onValueChange` (or `defaultValue`), and callbacks fire only for what the user does.
- **`labels`**: every word they show, for your language. Layouts use start and end, so they mirror in right-to-left languages.
- **`accessibilityLabel`**, **`style`** and **`testID`**.
