@webdevarif/dashui
v1.8.0
Published
Universal dashboard UI component library — forms, inputs, media, tables, layouts. Modular categories: primitives, forms, dashboard, media, data, editors, ecommerce, cms.
Maintainers
Readme
@webdevarif/dashui
Universal dashboard UI component library with a 3-layer CSS token system.
Used across all webdevarif projects.
Install
npm install @webdevarif/dashuiSetup
// 1. Import tokens (in your root layout)
import '@webdevarif/dashui/tokens'
// 2. Set theme on <html>
<html data-dashui-theme="light"> {/* or "dark" */}
// 3. Use components
import { Button, Card, DataTable, AppShell } from '@webdevarif/dashui'Token System (3 Layers)
| Layer | File | Purpose |
|---|---|---|
| 1 — Primitives | tokens/primitives.css | Raw values (colors, spacing, radii) |
| 2 — Semantic | tokens/semantic-light/dark.css | Meaningful aliases for components |
| 3 — Storefront | tokens/storefront-schemes.css | Per-section color schemes |
Dashboard Theming
<!-- Light mode (default) -->
<html data-dashui-theme="light">
<!-- Dark mode -->
<html data-dashui-theme="dark">Storefront Color Schemes
<!-- Each section uses a scheme -->
<section class="color-scheme-1">Light section</section>
<section class="color-scheme-2">Dark section</section>
<section class="color-scheme-3">Brand/accent section</section>Dynamic schemes (user-defined) are generated server-side via:
GET /api/theme/{storeId}/styles.cssComponents
Primitives
Button Badge Card Input Select Textarea Checkbox Switch Dialog Tabs Tooltip Skeleton Separator Label Popover DropdownMenu
Layout
AppShell Sidebar TopBar Page PageSection
Data
DataTable Stats Pagination EmptyState
Form
FormField FormLayout FormSection
Feedback
Alert ConfirmDialog LoadingSpinner
Used In
- Builify CMS — dashboard + storefront
- webdevarif portfolio — admin panel
- SeoHub — (planned)
License
MIT © webdevarif
