Skip to content
wdj
Account

Blocks

Reusable page compositions for Django, HTMX and Alpine.js.

PageHeader, ResourceListPage and DeleteResource adapt the Kumo block patterns. The additional blocks below are wdj compositions.

Page header

Breadcrumbs, title, description, local or URL tabs and action slots.

View 12 working examples for Page header

SettingsSection

wdj

Responsive settings section with form content and optional footer.

View 3 working examples for SettingsSection

StatsGrid

wdj

Responsive metric cards with labels, values and semantic trends.

View 3 working examples for StatsGrid

FilterBar

wdj

Composable GET search form for server-owned filters and actions.

View 3 working examples for FilterBar

DetailList

wdj

Resource metadata with semantic definition lists and optional links.

View 3 working examples for DetailList

ActionCard

wdj

Guidance card with caller-owned navigation or local actions.

View 3 working examples for ActionCard

ResourceListPage

Resource list with usage guidance, additional content and pagination.

View 3 working examples for ResourceListPage

DeleteResource

Type-to-confirm dialog with error and pending states; POST integration for real resources.

View 4 working examples for DeleteResource

Getting started

Overview
Install
Components and blocks
Interaction guide

Design

Design skill
Colors
Control dimensions
Accessibility
Design resources

Components

Components overview
AutocompleteFree-form input with local or HTMX-filtered suggestions.
BadgeSolid, tinted, outline and dot status labels.
BannerInline message bar with variants and optional action.
BreadcrumbsTrail navigation in two sizes.
ButtonVariants, sizes, shapes, icons and loading state.
ButtonGroupJoins a small set of tightly-coupled buttons into a single control (split buttons).
CheckboxSingle checkbox and indeterminate state.
ClipboardTextRead-only text field with a one-click copy-to-clipboard button.
Code / CodeHighlightedEscaped Pygments grammar highlighting, multiline tokens, line numbers, highlighted lines and localized copying.
CollapsibleComposable disclosure component for showing and hiding content.
Combobox / AutocompleteKumo-styled input/button triggers, search inside the popup, grouped local choices and debounced HTMX search.
CommandPaletteAccessible spotlight search overlay with Cmd+K keyboard shortcut.
DatePickerKumo-styled date and datetime popups; inline single, multiple and range calendars with bounds/presets.
DateRangePickerStyled popup or inline range calendar with bounds, presets and separately named form values.
DialogNative <dialog> modal with focus management.
DrawerEdge-anchored modal panel. LayerDialog has its own layered component.
DropdownMenuNative details menu with delegated keyboard navigation and dismissal.
EmptyEmpty-state placeholder with icon and action.
FieldLabel + description + error wrapper. Built into each control.
FlowDirected diagrams with branches, SVG connectors, custom anchors and responsive local scrolling.
GridResponsive CSS grid layout container with preset column configurations.
InlineCopyTextCompact borderless copy control for IDs and short values.
InputText field with label, description, leading/trailing icons.
InputAreaMulti-line textarea with auto-resize option.
InputGroupInput field with seamless prefix, suffix, and addon attachments.
LabelForm field label, optional marker and tooltip.
LayerCardCompound surface card with distinct primary and secondary layers.
LayerDialogLayered native modal with actions, forms, nested dialogs and pending states.
LinkInline, current and plain text links.
LoaderAnimated spinner in three sizes.
MenuBarCompact view selector using native radio semantics.
MeterProgress bar showing a measured value within a known range.
PaginationA page navigation component for navigating through paginated content.
PopoverAnchored popup with interactive content.
RadioRadio group, vertical and horizontal.
SelectKumo-styled Alpine dropdown with groups, rich options and multiple selection; native form values and fallback.
SensitiveInputPassword/secret input with reveal toggle and copy button.
SeparatorHorizontal / vertical rules with optional label.
SidebarRecursive navigation groups, account/zone views, search, loading, resize and full-screen mobile breadcrumbs.
SkeletonShimmer placeholder.
SliderInset single/range selection with vertical grips, value badges, endpoint labels and native keyboard/form behavior.
SurfaceBordered surface panel with header slot.
SwitchOn/off toggle in three sizes.
TableServer-driven table: sort, filter, select and paginate the full dataset.
Table of contentsPage section navigation tree with active link indicator.
TabsSegmented and underline tabs with a sliding indicator, responsive overflow and local Alpine or URL/HTMX state.
TagInputMulti-value badge input for tags and recipients.
TextHeading, body, secondary, success, error and mono text.
ToastyExpandable notification stack with variants, paused expiry and a live region.
ToolbarCompact grouped controls with shared borders, composed filters and keyboard arrow navigation.
TooltipHover and focus tooltip with grouped delays, Escape dismissal and viewport bounds.

Charts

Charts overview
Chart colors
TimeseriesServer-built Apache ECharts (line, area, bar, donut) themed to wdj tokens.
Chart legendLarge and compact legend items with loading states and real ECharts series toggles.
Custom chartsCustom ECharts options and trusted HTML tooltip templates.
MapsOffline SVG bubble/country maps and a draggable globe; projection and tooltips differ from Kumo.
SankeyServer-built flow charts with weighted links and themed labels.
SparklineCompact line and bar charts for inline metrics.

Blocks

Blocks overview
ActionCardGuidance card with caller-owned navigation or local actions.
DeleteResourceType-to-confirm dialog with error and pending states; POST integration for real resources.
DetailListResource metadata with semantic definition lists and optional links.
FilterBarComposable GET search form for server-owned filters and actions.
Page headerBreadcrumbs, title, description, local or URL tabs and action slots.
ResourceListPageResource list with usage guidance, additional content and pagination.
SettingsSectionResponsive settings section with form content and optional footer.
StatsGridResponsive metric cards with labels, values and semantic trends.

Integration

Advanced integration
Server fragments
Resource dashboard

Development

Registry
Build commands
Contributing
Changelog
↑ ↓ Navigate ↵ Select