Velocity X Components by Aidxn Design

Standard Data

Standard Staff Availability Grid

StandardStaffAvailabilityGrid — people down the side, days across the top, one editable cell per person per day.

Lifetime access Included with the VX Components lifetime licence.
bash
$ velocityx add standard-staff-availability-grid

Built for react. Needs react already installed as a peer dependency. An Astro-only project needs @astrojs/react wired up first — this won't run on its own in plain Astro.

Full docs for Standard Staff Availability Grid →

Needs a licence key — buy lifetime access here, then velocityx login once.

react v1.0.0
Standard Staff Availability Grid

Staff availability

  • Available
  • Booked
  • Day off
  • On leave
  • Not set
Staff availability — 6 people across 7 days
PersonMon03Tue04Wed05Thu06Fri07Sat08Sun09Load
A. FaberNorth3/7
B. OkonkwoNorth0/7
C. LindqvistCentral4/7
D. MarchettiCentral2/7
E. NovakSouth3/7
F. AdeyemiSouth3/7
Framework
react
Source
268 lines
StandardStaffAvailabilityGrid.jsx
Runtime
Interactive
runs in the browser
Theme
13 tokens
re-themes from your scale
Dark mode
Built in
dark: variants
Accessibility
2 ARIA
attributes and roles

Props

NameTypeRequiredDefaultDescription
people{ id: string; name: string; subtitle?: string }[]NoDEMO_PEOPLE
days{ id: string; label: string; sublabel?: string; muted?: boolean }[]NoDEMO_DAYS
cellsRecord<stringNoDEMO_CELLS{ statusId: string; note?: string }> keyed `${personId}:${dayId}`
statusesRecord<stringNoDEMO_STATUSES{ label: string; code: string; cell: string; legend: string }>
onCellSelect(payload: { person, day, cell }) => voidYes
showLoadbooleanNotrueappend a per-person tally column
loadStatusIdsstring[]No['booked']which statuses count toward the tally
captionstringNo'Staff availability'
classNamestringNo''

Using it

The smallest call that compiles — required props only. The import is written for your own file at src/components/Example.jsx; adjust the relative import if yours sits elsewhere. Everything optional is in the table above, with its default.

tsx
import StandardStaffAvailabilityGrid from './velocity/standard-staff-availability-grid/StandardStaffAvailabilityGrid';

export default function Example() {
  return (
    <StandardStaffAvailabilityGrid
      onCellSelect={() => {}}
    />
  );
}

Built from Standard Staff Availability Grid's own prop signature and the path the CLI installs it to, so it can't drift from either.

Accessibility

ARIA attributes
aria-hidden, aria-label
Keyboard
Built on native controls — Enter/Space work as standard
Screen readers
Ships screen-reader-only text
Motion
Respects prefers-reduced-motion

Read from the source, not asserted — anything not listed simply isn't in this component's markup.

Behaviour

Ships client JS
Yes — this one needs to hydrate
React hooks
useCallback, useId, useMemo
Dark mode
Carries its own dark: variants

Theming

This component paints from 13 steps of your theme scale — no hardcoded colours, and no font-family of its own, so your type cascade wins. Override the variables and it follows.

accent-300accent-400accent-500accent-600primary-50primary-100primary-200primary-500primary-600primary-700primary-800primary-900primary-950

Get the Velocity preset and CSS theme from the public source guide. The CLI theme command is not available on npm yet.

File this creates

The CLI writes this path into your project — nothing else moves. Paths are under your source root, which defaults to src/; pass --dest if yours is elsewhere.

  • src/components/velocity/standard-staff-availability-grid/StandardStaffAvailabilityGrid.jsx 268 lines
Copy the paths
text
src/components/velocity/standard-staff-availability-grid/StandardStaffAvailabilityGrid.jsx

Standard Staff Availability Grid — questions

How do I install Standard Staff Availability Grid?

Run velocityx add standard-staff-availability-grid . The CLI writes the source straight into your project — it is not a runtime package dependency.

Do I need a licence for Standard Staff Availability Grid?

Yes. It is part of the lifetime library — buy access at https://aidxn.com/shop/velocity-x-component-library/, authenticate once, and install it. Your lifetime licence includes future component updates.

Can I edit Standard Staff Availability Grid after installing it?

Yes — the files are yours once written. The CLI compares its lockfile hash before upgrades and refuses to overwrite code you changed.

Does Standard Staff Availability Grid ship JavaScript to my users?

Yes. It runs in the browser (useCallback, useId, useMemo), so it needs to hydrate — in Astro, give it a client:* directive.

Will Standard Staff Availability Grid match my brand colours?

Yes. It paints entirely from your theme scale — 13 steps of primary-* / accent-* — with no hardcoded hex values and no font-family of its own. Override the theme CSS variables and it follows your design system instead of ours.

Does Standard Staff Availability Grid pull in any dependencies?

No external ones. Every component in the library is built with react/react-dom or plain Astro only — no GSAP, Radix, Swiper or Headless UI — which is what makes dropping it into an existing project safe.

Set up & reference

All docs →

Install this component:

bash
$ velocityx add standard-staff-availability-grid

More from Standard Data.