Appearance
Design tokens — Soft Periwinkle
Chỉ light baseline (không dark mode). Hướng: pastel primary Soft Periwinkle với dark ink trên fill pastel (AQ-001 / ADR-004).
Quy tắc
- Fill primary / accent dùng ink
*-foregroundtối — không mặc định chữ pastel trên pastel. - Soft surface:
muted,card,secondary. - Touch:
--size-touch-min: 44px(FR-008). - Focus:
--color-ring/--focus-ring-*phải còn nhìn thấy trên pastel UI. - Focus policy (ship trong
focus-chrome.css): form field dùng:focus(tap WebView vào field); button / tab / disclosure chỉ:focus-visible(không sticky tap ring trên Accordion header, v.v.). - Elevation: shadow soft có tint periwinkle; card ưu tiên shadow không border mặc định.
- Overlay scrim dùng
--color-overlay(Tailwindbg-overlay) — không dùng rawblack/80.
CSS entrypoint (@minap/ui)
| Import | Vai trò |
|---|---|
@minap/ui/styles.css | Soft Periwinkle :root mặc định + focus chrome + native-temporal |
@minap/ui/themes.css | Multi-theme runtime (data-minap-theme) + native-temporal |
@minap/ui/soft-*.css | Đổi single-theme tùy chọn (cũng gồm focus chrome + native-temporal) |
Ưu tiên @import "@minap/ui/styles.css" trong app. Map utility qua @minap/ui/tailwind-preset (minapUiPreset).
Giá trị cốt lõi
| Token | Value |
|---|---|
--color-background | hsl(210 40% 99%) |
--color-foreground | hsl(229 32% 16%) |
--color-primary | hsl(234 48% 78%) |
--color-primary-foreground | hsl(234 40% 18%) |
--color-primary-soft | hsl(234 48% 90%) |
--color-secondary | hsl(230 35% 94%) |
--color-muted | hsl(226 30% 95%) |
--color-accent | hsl(234 40% 92%) |
--color-destructive | hsl(0 72% 51%) |
--color-success | hsl(142 55% 36%) |
--color-warning | hsl(38 92% 42%) |
--color-info | hsl(210 70% 45%) |
--color-border | hsl(228 22% 90%) |
--color-input | hsl(228 22% 88%) |
--color-ring | hsl(234 45% 45%) |
--size-touch-min | 44px |
Radius / elevation (Mobile-First)
| Token | Value | Dùng cho |
|---|---|---|
--radius-sm | 0.375rem | Chip chặt |
--radius-md | 0.75rem | Button / input (~12px) → Tailwind rounded-md |
--radius-lg | 1rem | Panel lớn hơn |
--radius-xl / --radius-2xl | 1.25rem / 1.5rem | Surface lớn (rounded-xl / rounded-2xl) |
--radius-sheet | var(--radius-2xl) | Góc Drawer / Sheet → rounded-t-sheet / rounded-b-sheet |
--shadow-sm / --shadow / --shadow-md / --shadow-lg | Soft periwinkle-tinted | Tailwind shadow-sm … shadow-lg |
--color-overlay | hsl(229 32% 16% / 0.45) | Scrim Sheet / Drawer → bg-overlay |
--color-card-border | hsl(228 22% 94%) | Hairline tùy chọn → border-card-border |
Primary vẫn Soft Periwinkle pastel với dark ink (không violet bão hòa + chữ trắng).
Default component tiêu thụ các token này
| Control | Chrome mặc định (kit) |
|---|---|
| Card | rounded-xl shadow — không border; thêm border border-card-border nếu cần |
| Drawer | Scrim bg-overlay; content rounded-t-sheet shadow-lg + drag handle |
| Sheet | Scrim bg-overlay; bottom/top dùng rounded-*-sheet |
| Badge | variant="soft" (fill pastel *-soft) mặc định |
| Button | rounded-md, h-touch, solid primary = pastel + dark ink |
| DatePicker / TimeField / DateTimePicker | Native path: ẩn chrome calendar/clock UA qua native-temporal.css |
Prop color dùng chung (industry): primary | success | warning | destructive | info. Bỏ color → primary Soft Periwinkle (không có giá trị color="default"). Button/Badge còn variant: Button solid | outline | ghost | link | secondary; Badge soft (mặc định) | solid | outline | secondary. Alert / Toast / Badge soft dùng pastel *-soft. Đồng nghĩa: danger ≡ destructive.
Theme thay thế (tùy chọn)
Mặc định vẫn Soft Periwinkle (styles.css). Đổi (hoặc override :root) bằng:
| Import | Theme |
|---|---|
@minap/ui/soft-periwinkle-light.css | Soft Periwinkle Light |
@minap/ui/soft-sage-mist.css | Soft Sage Mist |
@minap/ui/soft-enterprise.css | Soft Enterprise |
Không import theme thay thế và styles.css trừ khi cố ý để theme thay thế override mặc định (load theme thay thế sau cùng).
So sánh realtime (playground): import @minap/ui/themes.css, set document.documentElement.dataset.minapTheme, mở /samples/work-board.
Showcase
Route playground /tokens — review ~375px width. Theme lab: /samples/work-board.