- Stage
- Contacted
- City
- Rishon LeZion
Complete component library and design tokens
Use a collapsible panel for optional filters or supporting details. Use an accordion for related sections. These examples use the Bootstrap Collapse plugin already loaded by the base template.
Starts collapsed. Closing the panel preserves its field values; it does not clear or apply filters. This example does not filter production data.
One section can be open at a time. The first section starts expanded; all sections may be closed.
aria-controls, and match the initial aria-expanded value to its .show state. Bootstrap maintains the expanded state after interaction..collapse element, so height transitions work correctly.data-bs-parent to allow several accordion sections open together. Keep required fields, validation errors, and critical actions visible when users need them.<button type="button" data-bs-toggle="collapse" data-bs-target="#optionalDetails"
aria-expanded="false" aria-controls="optionalDetails">Details</button>
<div class="collapse" id="optionalDetails">
<div class="p-3">Optional content</div>
</div>
Compose admin pages with shared ui.css classes. Examples below use synthetic data; controls never save to production.
| Name | Stage | City |
|---|---|---|
| Example Electrical | Contacted | Rishon LeZion |
| Example Plumbing | New | Tel Aviv |
Standard lists switch to cards below 768px. Dense project lists use .ui-has-cards-tablet below 1200px; Projects uses two columns at 768โ1199px and one on phones. Keep all data and actions available in both views.
<div class="ui-header">Title + .ui-header-actions</div>
<div class="ui-list ui-has-cards">
.ui-toolbar + .ui-table-wrap + .ui-cards + .ui-pager
</div>
Keep tasks in the main column and summary metadata alongside. Stack the summary below tasks on phones. Use .ui-header for admin workspaces; .page-header remains the portal title/subtitle pattern.
Header โ List/Board toggle โ shared filters โ horizontally scrolling stage columns. Keep filters consistent between views and preserve them when switching. See Drag & Drop for a working board.
Based on the subcontractor pipeline. Drag a card between columns, or use its stage selector with keyboard or touch. This demo changes only local page state.
Electrical ยท Rishon LeZion
Ready. No changes saved.
Production styling uses .upload-area and .upload-hint, with initDropZone() for drag feedback and file selection. These examples validate locally; file contents are never read or uploaded.
No files selected.
No files selected.
Tab to the drop zone and press Enter or Space to browse. Mobile users can tap it. A new selection replaces the previous selection. Invalid selections are cleared so users can select the same file again.
<div class="upload-area" id="fileZone">
<span id="fileLabel">Drop a file here, or browse</span>
<div class="upload-hint">PDF ยท maximum 5 MiB</div>
</div>
<input type="file" id="fileInput" accept=".pdf" hidden>
const control = initDropZone('fileZone', 'fileInput', 'fileLabel');
// Add click/keyboard browsing, change validation, and upload handling.
// control.reset() clears the selection and restores the prompt.
For production uploads, validate file count, size, and actual content on the server too. Show real upload progress, success, and retry feedback; prevent duplicate submission while uploading. The helper handles selection only, not validation or network requests.
The highlighted states are a proposed shared convention. Existing board and task drag styles remain page-specific; the guide scopes its demonstration styles with sg-.
Use the Bootstrap Icons font already loaded by the base templates. Pass the bare name to render_button(icon='plus-lg'); raw markup uses bi bi-plus-lg.
Use a consistent 16px action icon and 20px section icon. Let icons inherit text color. Decorative icons use aria-hidden="true"; icon-only buttons need an accessible label and a title. Use logical spacing for RTL; mirror directional navigation only when its meaning changes with direction.
<button type="button" class="btn btn-outline-secondary" aria-label="Refresh" title="Refresh">
<i class="bi bi-arrow-clockwise" aria-hidden="true"></i>
</button>
One primary action per action group. Use outline secondary for supporting actions and danger for destructive actions. Header controls use --control-h (36px); phone controls use --touch-target (44px). Dense desktop row actions use .act-btn; cards enlarge them for touch. Tab through this page to inspect focus outlines. Loading controls keep a text label and disable duplicate submission.
{{ render_button('New item', 'primary', icon='plus-lg') }}
Size order: standard > Small (.btn-sm, dense desktop, ~28px) > XS (.btn-xs).
Page-header actions use --control-h (36px); mobile actions use --touch-target (44px).
Primary
Secondary
Ghost
Danger
This is a standard card component with title, subtitle, and content area.
This card has a footer section with action buttons.
| Name | Role | Status | |
|---|---|---|---|
| Alice Johnson | alice@example.com | Admin | Active |
| Bob Smith | bob@example.com | Manager | Active |
| Charlie Brown | charlie@example.com | Client | Pending |
| Name | Status | Created | Actions |
|---|---|---|---|
| Fire pump set โ very long product name that wraps on narrow screens | Active | 2026-10-20 | |
| ืืฉืืืช ืืืื ืืืืื | On Hold | 2026-01-05 | |
| Sprinkler controller | Cancelled | 2025-12-31 |
.ui-has-cards-tablet to keep cards below 1200px..act-btn chips with aria-label + title; 28px on desktop, 44px on cards.formatDate(); date-only values never shift day; timestamps show in Asia/Jerusalem.| API value | formatDate() | formatDateTime() |
|---|
Used for page titles and main headings
Used for section headings
Used for subsection headings
This is a paragraph with standard body text. It uses the default font size of 14px and line-height optimized for readability.
This is smaller text (12px) used for captions and metadata.
Monospace font for code snippets