@dads-framework/ui
On this page
React controls, data tables, and application layouts with a neutral default theme.
Try it
Install the components and default theme in a React 19 TypeScript app with Tailwind CSS 4 configured.
npm install @dads-framework/ui @dads-framework/styles react@^19 react-dom@^19
Set your Tailwind CSS entry point to the following. This example assumes the
stylesheet lives in src/. Resolve the source path from your stylesheet to
the location of the installed UI package.
@import "@dads-framework/styles/index.css";
@source "../node_modules/@dads-framework/ui/dist";
Render <StockCounter /> on a page that loads that stylesheet.
import { useState } from "react";
import { Button } from "@dads-framework/ui/elements";
export function StockCounter() {
const [units, setUnits] = useState(0);
return (
<>
<Button type="button" onClick={() => setUnits((count) => count + 1)}>
Add unit
</Button>
<p role="status">Units in stock: {units}</p>
</>
);
}
The page shows a themed Add unit button and a count of zero. Press Tab to focus the button, then Enter to increment the count.
The starter's note forms
use the shared Button and disable form submission while a request is pending.
Use it
| Import path | Includes |
|---|---|
@dads-framework/ui/elements |
Buttons, badges, calendar, and class name utilities |
@dads-framework/ui/forms |
Inputs, fields, switches, checkbox, and combobox |
@dads-framework/ui/display |
Alerts, empty states, tables, and permission decisions |
@dads-framework/ui/overlays |
Dialogs, menus, sheets, tooltips, and attachment previews |
@dads-framework/ui/data-table |
Responsive data table, toolbar, filters, and sorting |
@dads-framework/ui/data-table/routing |
Table search schemas and helpers for route files |
@dads-framework/ui/page |
Page layout, list tabs, and master-detail views |
@dads-framework/ui/shell |
Sidebar, breadcrumb, and mobile detection |
@dads-framework/ui/icons |
Named icon exports |
The elements subpaths /elements/calendar and
/elements/css-custom-properties expose the standalone calendar and CSS
property types.
Contract
MasterDetailRowuses a native link by default. Pass alinkComponentacceptingMasterDetailLinkPropsfor router navigation. It receives the destination ashrefand the list search values separately assearch.- Pass a stable
tableIdtouseDataTableto remember visible columns on the device. Without an ID, column preferences last for the current visit. PermissionDecisionTablerenders permission labels and decisions supplied by the host. Provide a stable ID for each decision and localized column and status labels. The host obtains decisions through its authorized API.AttachmentVieweraccepts a URL or Blob from the caller'sloadSource. For PDFs, serve the PDF.js WASM decoders at/pdfjs/wasm/. The caller owns the download handler.
What it refuses to do
Application routes, loading, storage access for attachment sources, and product copy belong to the host application.
Third-party source notices identify the adapted components and helpers included in this package.