Stock alerts

A React block (a whole screen) in Beamline's Inventory app.

Alerts on stock counts and expiry dates. Counts of alerts gone off (danger) and close (warning) in the header. A table: item and type, the rule in words (above, at or above, below, at or below a value, or at or below the item's minimum with that minimum said; days before expiry for dates), how far from going off in units or days (gone off, or unknown when the count is), when it last went off or never, who hears; filtered by type and state (gone off, close, not close, never gone off). Picked alerts revise together in one editor: when it goes off and who hears (roles and people; nobody refused); review lists every alert's rule now → after; at or below the minimum sets each item's minimum to the value given and lists those minimums old → new, while an ordinary threshold leaves them alone; alerts it can't apply to are left out and said; saving answers per alert, one changed by someone else meanwhile left as it was; saving rules is said apart from message delivery. New alerts for items that have none use the same editor.

Use it for

Low-stock and expiry alerts managed in one place, revised in bulk with every change shown first.
Where an alert that rewrites item settings must say so before saving.

Not for

A projection of stock over the coming weeks (stock-horizon).
A notification inbox (notification-center).

Anatomy

header: the tool's mark, Stock alerts, gone off, close, New alert
toolbar: type and state as switches (state a menu on a phone), Revise
table: pick, item and type, the rule, how far, last went off, who hears
editor: items (new), when, value or new minimum, who hears as role and people chips; review with now → after, minimums changing, left out; Save; saved and skipped

States

no alerts, none matching, gone off, close, not close, unknown count, never gone off
editing, nobody to tell, reviewing, minimums overwritten, left out, saving, refused, saved with some skipped
phone: the editor first, the table scrolls sideways
right to left: mirrored
reduced motion: through the tokens

Keyboard

Tab through the filters, each row's pick, Revise, and the editor's fields

Motion

Nothing runs at rest.

Props

Prop	Type	Default	Description
`rules`	`AlertRule[]`	—
`defaultRules`	`AlertRule[]`	—
`onRulesChange`	`((r: AlertRule[]) => void)`	—
`items` (required)	`AlertItem[]`	—
`roles` (required)	`string[]`	—
`people` (required)	`string[]`	—
`onSave` (required)	`(req: { ruleIds: string[]; itemIds: string[]; expectedRevisions: Record<string, number>…`	—	Saves the patch onto these alerts (or new ones for these items); resolve per alert. Reject with why nothing saved.
`defaultPicked`	`string[]`	—
`defaultEditing`	`boolean`	—
`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 { StockAlerts } from "@beamline/stock-alerts";

Get it

Stock alerts 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

Stock alertsComplete system · $49

Alerts on stock counts and expiry dates.

Three alerts revised together

The bottle trap's alert has gone off. The LED bulbs are close. The door closer's count is unknown, so how far it is from going off is unknown too. Three count alerts with different thresholds (5, 40 and 5) are being revised together. Review shows each rule before and after. Choosing At or below the item's minimum lists every minimum it overwrites, old → new. The bottle trap's alert was changed by someone else meanwhile, so it's skipped.

0 × 0full

States

No alerts yet; making a new alert for items that have none.