Policy rules

A React block (a whole screen) in Beamline's CMS & media app.

One access policy's permissions. Admin access (said to skip every rule, on warning) and app access (without it its people can't sign in; rules still apply to their keys). Collections against create, read, update, delete and share, each cell All (success; on delete and share warning, a broad grant), None or Custom (info), changed cells outlined. Custom opens the cell's rules beside the matrix: which items with query-builder and Only their own through $CURRENT_USER (said), which fields (none said), validation on create and update (values that must match or saving is refused) and presets (filled in, unchangeable). Unsaved changes counted; Discard and Save; saved for how many people or refused with the reason.

Use it for

Setting what a policy or role may do per collection and action, with item rules, field access, validation and presets.
Row-level permissions relative to who's signed in.

Not for

A plain roles × permissions matrix without item rules (roles-permissions).
Who did what (audit-log).

Anatomy

header: the tool's mark, the policy, who holds it, Admin access, App access
notes: admin skips rules; no app access
matrix: collections × create, read, update, delete, share; each cell's menu (All, None, Custom…); on a phone one collection at a time
rules: which items (Only their own, query-builder), which fields, validation, presets
footer: what was saved or refused, unsaved changes, Discard, Save

States

admin on, app off, nothing granted
cell all, none, custom, changed, chosen; custom with no fields; their own
saved, refused
phone: a collection picker with its five actions
right to left: mirrored
reduced motion: through the tokens

Keyboard

Tab through the switches and every cell (Enter opens its menu), the rules and their builders, Discard and Save

Motion

Nothing runs at rest.

Props

Prop	Type	Default	Description
`policy`	`Policy`	—
`defaultPolicy`	`Policy`	—
`onPolicyChange`	`((p: Policy) => void)`	—
`collections` (required)	`PolicyCollection[]`	—
`members` (required)	`number`	—	People holding the policy.
`onSave` (required)	`(p: Policy) => Promise<{ ok: true; } \| { refused: string; }>`	—
`defaultCell`	`{ collection: string; action: PolicyAction; } \| null`	—
`product`	`string`	—
`className`	`string`	—	Classes on the documented visual root; no override by default.
`style`	`CSSProperties`	—	Inline styles on the documented visual root; no overrides by default.
`ref`	`Ref<HTMLDivElement>`	—	Receives the documented native target or imperative handle; omitted by default.

Built from

Dependencies

lucide-react

Import

import { PolicyRules, ACTIONS } from "@beamline/policy-rules";

Get it

Policy rules is part of Beamline UI. Install the parts you need in your React app as compiled packages or editable source. Get Beamline · Connect your agent