Budget Variance
Prov1.0.0Budget against actual by department and line, with overspend flags and period switching.
Build for your project
Code/install build
Usage
Import it and pass your content. The props that matter most are listed next.
Example
import { BudgetVariance, type BudgetDepartment, type BudgetLine } from "@/components/ui/notchset/blocks/budget-variance";
export function Spend({ departments }: { departments: BudgetDepartment[] }) {
return (
<BudgetVariance
title="Budget vs actual"
periods={[{ id: "month", label: "MONTH", caption: "SEPTEMBER 2026" }]}
departments={departments}
onFlag={(line: BudgetLine, department: BudgetDepartment, flagged: boolean) =>
fetch("/api/flags", { method: "POST", body: JSON.stringify({ line: line.id, owner: department.owner, flagged }) })
}
/>
);
}Props
departments–{ id, name, owner, initials, lines: { id, name, amounts }[] }[]amounts maps each period id to [actual, budget] in currency units.
periods–{ id, label, caption }[]The period control (MONTH / QUARTER / YEAR TO DATE) and the caption above the title.
title / currency–stringThe heading and the currency after the caption (USD).
defaultFlagged / onFlag–string[] / (line, department, flagged) => voidLines flagged at the start, and notifying a line's owner.
Anatomy
- One department is open at a time.
- Only lines more than 5% over budget can be flagged.
- Within ±1% of budget reads ON PLAN.
BudgetVariancedata-slot="budget-variance"Header controls, total, departments with lines, flags and legend.
Source
components/ui/notchset/blocks/budget-variance.tsx
This component is included with Pro.
Try the live preview above. Get Pro to install the source.
Build for your project
Code/install build
Installation
pnpm dlx shadcn@latest add @beautiful-ui-pro/budget-varianceNeeds your registry key. Your components.json style picks the Base UI or Radix build: radix-*, new-york and default get Radix, base-* gets Base UI.
Styles didn't apply?
The CLI adds the styles to the CSS file named in components.json (tailwind.css). Check that it points at your global stylesheet, that the project uses Tailwind CSS v4, and that the file is imported in your root layout. Installed by hand: paste styles.css into that file.
For coding agents
Give your coding assistant the Markdown guide instead of screenshots.
Use it for
- Monthly or quarterly budget reviews by team
- Finding which line items drive an overspend
Use something else when
- A ledger of transactions: use a data table
- Forecasting cash: use Cash Runway
Mistakes to avoid
- Pass amounts for every period id, or the period shows zeros
- Notify owners on the server; the block only reports the flag
Agents find it by
- budget vs actual, variance report, spend by department, FP&A, cost control, finance dashboard, overspend, Notchset
Where agents read it
- Guide for this component: https://beautiful-ui.dev/md/budget-variance.md
- Every component, for tools without MCP: /llms.txt
- MCP server:
https://beautiful-ui.dev/api/mcp(setup)
Behaviour
Keyboard
- Tab then Enter
- Open a department, flag a line
- ← →
- Change the period
- Space
- Toggle OVER BUDGET ONLY
Accessibility
- Each department's chevron is a button with aria-expanded; the row itself also toggles for pointer users
- Flags are toggle buttons (aria-pressed) named with the line and its owner
- OVER BUDGET ONLY is a switch; folded departments leave the tab order; the flag count is a polite live region
Motion
- Period
- Numbers roll and bars glide to their new length (620ms, 40ms apart per row)
- Open a department
- Rows unroll (380ms) and lines cascade in 45ms apart
- OVER BUDGET ONLY
- On-plan departments fold away (360ms)
Responsive
- Under 700px (container width) the table keeps 660px and scrolls sideways.
Performance
- Plain rows and CSS transitions; nothing runs while idle.
Changelog
v1.0.0 · 2026-10-04
First release
Part of
Included with Pro
Pro is in early access.
