Gift batches

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

Gift batches between counting and the books: batches a counting team enters, each with the day the gifts were received (apart from when they were entered and committed), its defaults (fund, method) and the gifts that override them marked; batches gathered into a group and the group committed as one; totals by fund. A counter prepares, a bookkeeper commits after seeing what donors will see and whether receipts go (consequence-preview); a refused commit keeps every batch in progress, and receipts failing is said apart from the commit. Each gift's fund reads as a value (its own, or the batch default) and opens its own menu; the batch's defaults (fund, method, group) read as one line of values, each changed from its menu.

Use it for

Gifts counted and entered in batches before they reach the books: a church's Sunday offering, a charity's mailed checks, a school's fundraiser envelopes.
Anywhere one role prepares records and another commits them, with what the commit reaches said before it runs.

Not for

Taking one gift in person (gift-desk).
A shop's or a firm's ledger of invoices (invoices).
Approving one record at a time (approval-card).

Anatomy

header: the product's mark and the title
list (nav): In progress or Committed (segmented control); groups with their batches hanging under them, then the batches in no group; each with its gift count and total
sheet head: the batch's name, received, entered and committed days; or the group's batch and gift counts; the total
defaults (an open batch): fund, method and group (selects)
gifts (table): donor, amount, fund (a select: the batch default or one set on this gift, marked), method (batch default or set on this gift)
a group's batches: each with its received day, gift count and total
totals by fund (side): each fund's total with a hairline of its share, in ink
bar (sticky): Send receipts (switch) and Commit batch or Commit group (consequence-preview: donors who see it, receipts or none, gifts locked); for a counter, why the commit is a bookkeeper's

States

uncommitted batch, grouped batch, defaults set, a row's override marked
counter review: the commit said as a bookkeeper's
bookkeeper commit: the preview, working, the receipt
committed: read only, the commit's day and who, the receipts' result
receipt disabled: no receipts sent, said
commit failure: every batch stays in progress
loading, no batches
phone: the list, then the batch with Back
right to left: the list's threads and the table mirror
reduced motion: through the tokens

Keyboard

Tab through the list, the defaults, each gift's fund, the switch and the commit
Escape closes the commit preview

Motion

The tab's thumb slides; the commit preview opens and moves through working to its receipt (consequence-preview). Nothing runs at rest.

Props

Prop	Type	Default	Description
`batches`	`GiftBatch[]`	—
`defaultBatches`	`GiftBatch[]`	—
`onBatchesChange`	`((batches: GiftBatch[]) => void)`	—
`groups`	`BatchGroup[]`	—
`funds` (required)	`BatchOption[]`	—
`methods` (required)	`BatchOption[]`	—
`role`	`"bookkeeper" \| "counter"`	—	"counter" prepares batches (defaults, overrides, groups) but cannot commit; "bookkeeper" commits.
`onCommit`	`((batchIds: string[], options: { receipts: boolean; }) => Promise<CommitResult>)`	—	Commit these batches atomically. Reject to keep them all in progress (said so).
`open`	`string`	—	The open batch or group (`group:<id>`).
`defaultOpen`	`string`	—	Initial open state when uncontrolled; defaults to false.
`onOpenChange`	`((id: string) => void)`	—	Reports an open-state change; no callback by default.
`by`	`string`	—	Who is signed in, written on a commit.
`currency`	`string`	—
`loading`	`boolean`	—
`product`	`string`	—	Your product's name, shown as its mark.
`className`	`string`	—	Classes on the documented visual root; no override by default.
`ref`	`Ref<HTMLDivElement>`	—	Receives the documented native target or imperative handle; omitted by default.

Built from

Dependencies

lucide-react

Import

import { GiftBatches } from "@beamline/gift-batches";

Get it

Gift batches 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

Gift batchesComplete system · $49

Gift batches between counting and the books.

Sunday's plates

The 9:00 plate is in the Sunday 1 Nov group; the 11:00 plate (twelve gifts, $555) is not yet. States: a counter who prepares but can't commit; a commit the server refuses; committed while the receipts failed; a committed batch; loading; no batches. A gift that names its own fund or method is marked as set on that gift; the rest follow the batch's defaults. Put the 11:00 plate in the group, open the group and commit both as one.

0 × 0full

The ledger

Every gift's processing and payout apart: Daniel's gift succeeded but isn't paid out yet; Owen's was refunded and Tomas's failed, struck; two fees are still pending, so the net isn't known yet. Grace's gift was moved to the Building fund, and its row says by whom.