Status: source of truth for the v5 UI. Every view, component, and CSS change follows this document; when existing code diverges, this document wins and the fix belongs to epic #2911. Changes to the system itself start here (with recalculated contrast ratios), then reach the code.
Map-OS's design language reads like a well-lit workshop bench: dense, organized, and built for people who open dozens of service orders a day, with just enough personality to keep an operational tool from feeling like a spreadsheet. Entry and highlight surfaces — login, the client-area welcome, empty states — sit on a near-black violet midnight ({colors.surface-canvas-dark} / {colors.surface-night}) with a faint starfield texture and occasional sticker-style illustrations (tools, devices, delivery boxes) that lighten the mood. Headlines run in a chunky display sans where the most important keywords can be wrapped in lime-green highlight chips ({colors.accent-lime}), as if the copy itself had been marked with a highlighter.
The palette is deliberately narrow: deep midnight as the dominant dark canvas, a warm signal orange ({colors.primary}) as the default action color (users may choose a color theme, see Color Themes), electric lime as the keyword highlighter, hot pink ({colors.accent-pink}) as illustration-only punctuation, and a violet-mid ({colors.accent-violet-mid}) for tag chips and hairline strokes. White appears in two roles — as text on dark ({colors.on-dark}), and as the canvas for the operational screens (service orders, sales, finance, reports) where users scan dense tables. The single primary CTA keeps the same orange fill on both canvases: the orange has enough luminance to stand out on midnight and enough saturation to stand out on white, so the button never needs to flip polarity. Its label always runs in dark ink ({colors.on-primary}), because white on this orange falls below the WCAG AA threshold. Operational screens default to the light canvas; users can switch the whole panel to a dark mode built from the same midnight palette (see Panel Dark Mode).
Typography splits cleanly between three families: a chunky display sans for hero and section openers (near-condensed, slightly playful), Rubik for every UI text role (body, captions, eyebrow caps, button labels), and Monaco for code. Buttons and eyebrows almost always run in uppercase with a 0.2px tracking lift to give them a crisp, label-maker snap.
Key Characteristics:
- Two-polarity canvas system: deep violet midnight (
{colors.surface-canvas-dark}) for entry and highlight surfaces (login, client-area welcome, empty states), white ({colors.surface-canvas-light}) for the operational screens and dense reference content — the system never tries to blur the two. The optional dark panel mode switches the whole screen at once, never a single band. - Lime keyword highlight (
{colors.accent-lime}) treated as a typographic device, not a color swatch — it wraps single words inside the display headline like a highlighter stroke on the reading flow. - Sticker illustration system: floating illustrations from the repair-shop world (tools, devices, packages) with hand-drawn outlines, appearing at section junctions on entry surfaces, never inside cards or operational screens — they create rhythm and personality between dense info blocks.
- Uppercase eyebrow + button caps in
{typography.button-cap}and{typography.eyebrow}, with a consistent 0.2px tracking lift, give the brand its label-maker cadence. - Single-primary CTA hierarchy: every view has one filled
{colors.primary}button — orange by default, the theme color when the user picked a color theme — with its{colors.on-primary}label (ink on orange), on either canvas; inverted, outlined, and ghost variants are downgraded. - Card surfaces follow the canvas: dark sections nest dark cards (
{colors.ink-deep}with subtle hairline) and light sections nest white cards with{colors.hairline-cloud}borders — chrome stays consistent, only the polarity flips. - A tier-card color rhythm (plans, comparisons) of cream-white cards with one dark inverted "featured" card (
{colors.surface-night}), avoiding the typical accent-bordered featured pattern. - Status never borrows the action color: service-order states use their own semantic palette (success, warning, danger, info, progress, neutral), always as a labeled pill, so orange keeps meaning "act here".
Applies to: login and client-area entry surfaces (dark canvas); the admin panel and operational screens — service orders, sales, finance, reports (light canvas).
- Signal Orange (
{colors.primary}—#F37338): The default and brand action color; a user has exactly one action color at a time (orange unless they pick a color theme, see Color Themes). Fills primary buttons on both canvases, marks the active navigation item, and draws progress and selection states. Its luminance sits mid-scale — 2.87:1 against white, 6.00:1 against{colors.ink-deep}— so it always carries a dark ink label ({colors.on-primary}), never white. - Orange Pressed (
{colors.primary-pressed}—#DB6230): The pressed/active fill ofbutton-primary. Same hue, lower value; keeps the ink label at 4.75:1. - Orange Strong (
{colors.primary-strong}—#B34D1D): The same hue darkened for the two jobs the base orange can't do: orange text or links on light canvas, and the rare orange surface that must carry white text (5.26:1 against white, 4.65:1 against{colors.primary-tint}). - Orange Tint (
{colors.primary-tint}—#feeee7):{colors.primary}at 12% over white. The background of the active item in the sidebar, tab bar, and autocomplete lists — the second cue that always accompanies a thin orange indicator. Ink on it reads at 15.2:1. - Ink Violet (
{colors.ink-deep}—#1f1633): Slightly lifted from{colors.surface-night}, this is the dark entry-surface canvas and the default body-text color on light surfaces — a single token doing double duty as background and ink. - Electric Lime (
{colors.accent-lime}—#c2ef4e): The signature highlight color. Wrapped around individual headline keywords as a syntax-highlight chip ({rounded.xs}corner, no padding-y, 12px padding-x). Also used as the squiggly footer divider stroke. Never a button background. - Hot Pink (
{colors.accent-pink}—#fa7faa): Secondary punctuation color used for sticker outlines, chart points, and supporting accents — never on buttons, never on type at body size. - Violet Link (
{colors.accent-violet}—#6a5fc1): Inline link color when emphasis is needed beyond underline. - Deep Violet (
{colors.accent-violet-deep}—#422082): The select-dropdown fill on contact forms; also used on spotlight cards inside dark sections. - Mid Violet (
{colors.accent-violet-mid}—#79628c): Tag-chip fill and faint accent on dark surfaces.
- Dark Canvas (
{colors.surface-canvas-dark}—#1f1633): Login, client-area welcome, and highlight-band background. Carries the deepest atmospheric weight. - Night (
{colors.surface-night}—#150f23): The deepest surface tone — cards on dark canvas, code blocks, and the "featured" tier card. - Light Canvas (
{colors.surface-canvas-light}—#ffffff): Admin panel, operational screens, and dense-reference page background. - Surface Press Light (
{colors.surface-press-light}—#f0f0f0): The pressed/active fill of inverted buttons on dark surfaces, and the empty track of progress bars. - Surface Subtle (
{colors.surface-subtle}—#f6f5f9): Table headers, row hover, disabled fields, and icon-button hover on light canvas. - Hairline Violet (
{colors.hairline-violet}—#362d59): 1px borders on dark cards. - Hairline Input (
{colors.hairline-input}—#8a849c): 1px borders on form controls — text inputs, selects, unchecked checkboxes and radios, the off-state switch track. At 3.58:1 against white it meets the WCAG 3:1 minimum for the boundary that identifies a control. - Hairline Cool (
{colors.hairline-cool}—#cfcfdb): 1px borders that don't identify a control on their own — outline buttons (their label already does) and dividers inside forms. Never the only boundary of an input (1.54:1). - Hairline Cloud (
{colors.hairline-cloud}—#e5e7eb): Card borders, table dividers, and tier-card borders on light canvas.
- On Primary (
{colors.on-primary}—#1f1633): Labels on orange fills —button-primaryandbutton-primary-pressed. Same hex as{colors.ink}; white on{colors.primary}fails WCAG AA, so orange always carries ink. - On Dark (
{colors.on-dark}—#ffffff): All text on dark canvas, labels on dark fills, and the fill ofbutton-inverted. - Ink (
{colors.ink}—#1f1633): Body text on light canvas; identical hex to the dark canvas, repurposed as type. - Ink Muted (
{colors.ink-muted}—#5b5470): Secondary text on light canvas — captions, helper copy, table headers, inactive navigation items, equipment lines under a client name. 7.13:1 on white, 6.57:1 on{colors.surface-subtle}. - Text Disabled (
{colors.text-disabled}—#8a849c): Labels of disabled buttons and controls on light canvas. Disabled controls are exempt from WCAG contrast, but they must stay legible — never white on a light fill. - Ink Press (
{colors.ink-press}—#1a1a1a): Reserved for the pressed/active state of inverted buttons. - On Dark Muted (
{colors.on-dark-muted}—rgba(255,255,255,0.72)): Secondary text, captions, and table cell values on dark canvas. - On Dark Faint (
{colors.on-dark-faint}—rgba(255,255,255,0.18)): Translucent surface-on-dark — used for ghost button fills and dimmed nav items.
- Focus Ring (
{colors.ring-focus}—#3B82F6): Opaque blue focus ring, 3px — the only blue in the default theme outside the info status (the Azul theme adds a royal-blue action color, never this hex), reserved for keyboard focus on fields and buttons. It must reach the WCAG 1.4.11 minimum of 3:1 against the surface it sits on: 3.68:1 on white, 3.36:1 on{colors.surface-subtle}and 5.08:1 on the dark canvas. The earlier 50% translucent version measured about 1.8:1 on white and failed, so the ring is always drawn fully opaque.
Status colors. Each state has a base (icons, dots, fills such as button-danger), an -ink for text, and a -soft background (base at 12% over white). Pills and alerts always put -ink on -soft.
| State | Base token | Ink token | Soft token | Ink on soft | Used for |
|---|---|---|---|---|---|
| Success | {colors.success} #15803d |
{colors.success-ink} #136234 |
{colors.success-soft} #c9ecd5 |
5.82:1 | Aberta, pagamento confirmado |
| Warning | {colors.warning} #a16207 |
{colors.warning-ink} #8a5207 |
{colors.warning-soft} #f6e3bf |
5.06:1 | Negociação, aguardando peças, garantia vencendo |
| Danger | {colors.danger} #dc2626 |
{colors.danger-ink} #b31818 |
{colors.danger-soft} #f8d2d2 |
4.95:1 | Cancelada, erros, ações destrutivas |
| Info | {colors.info} #0369a1 |
{colors.info-ink} #0a5a86 |
{colors.info-soft} #cde4f6 |
5.68:1 | Aprovada, avisos do sistema |
| Progress | {colors.accent-violet} #6a5fc1 |
{colors.progress-ink} #443a93 |
{colors.progress-soft} #ddd8f7 |
6.71:1 | Em andamento |
| Neutral | {colors.accent-violet-mid} #79628c |
{colors.neutral-ink} #4b4560 |
{colors.neutral-soft} #e4ddec |
6.84:1 | Orçamento enviado, rascunho, contadores |
| Azul-escuro | {colors.azulescuro} #1e40af |
{colors.azulescuro-ink} #1e3a8a |
{colors.azulescuro-soft} #d3ddf5 |
7.61:1 | Finalizada |
| Roxo | {colors.roxo} #9333ea |
{colors.roxo-ink} #6b21a8 |
{colors.roxo-soft} #ecd9fb |
6.60:1 | Faturada |
Warning is a yellow amber (hue 35°) on purpose: the more common #b45309 sits at 26°, too close to {colors.primary} (19°) to be told apart. Status is never shown by color alone — every pill carries its label.
Per-status color (#3044). Some OS statuses get their own color for faster reading: Finalizada uses {colors.azulescuro}, Faturada {colors.roxo}, and Aberta moves to {colors.success} — so Finalizada and Faturada no longer share the green they used to. Negociação and Aguardando Peças both keep {colors.warning} (both are waiting states). No status uses the brand orange, so "orange means act here" still holds.
The operational screens default to the light canvas. Users can switch the whole panel to dark (Claro / Escuro / Sistema); the switch always applies to the entire screen, never to a single band, so the two-canvas rule still holds. The dark sidebar of a color theme in light mode is part of that theme (see Color Themes), not a band of a light screen: in dark mode the whole screen, sidebar included, is dark.
| Role | Light | Dark |
|---|---|---|
| App background | {colors.surface-canvas-light} |
{colors.surface-canvas-dark} #1f1633 |
| Sidebar, topbar, cards | {colors.surface-canvas-light} |
{colors.surface-night} #150f23, no shadow |
| Table header, row hover | {colors.surface-subtle} |
{colors.surface-subtle-dark} #1b1430 |
| Borders | {colors.hairline-cloud} |
{colors.hairline-violet} #362d59 |
| Input fill / border | white / {colors.hairline-input} |
{colors.surface-canvas-dark} / {colors.hairline-input-dark} #756d8a (3.83:1 on cards, 3.53:1 on the app background) |
| Text / secondary text | {colors.ink} / {colors.ink-muted} |
{colors.on-dark} / {colors.on-dark-muted} |
| Active item background | {colors.primary-tint} |
{colors.primary-tint-dark} #391f26 (orange 16% over night) |
| Disabled button | {colors.hairline-cloud} + {colors.text-disabled} |
rgba(255,255,255,0.08) + rgba(255,255,255,0.45) |
| Primary button | unchanged | unchanged in the default theme — {colors.primary} is 6.51:1 against night, label stays {colors.on-primary} |
Status in dark mode uses lighter bases that double as text, on a soft fill mixed over {colors.surface-night} (16%; 26% for progress and neutral):
| State | Dark token | On card | Dark soft | On soft |
|---|---|---|---|---|
| Success | {colors.success-dark} #4ade80 |
10.72:1 | #1d3032 |
7.92:1 |
| Warning | {colors.warning-dark} #facc15 |
12.19:1 | #3a2d21 |
8.69:1 |
| Danger | {colors.danger-dark} #f87171 |
6.75:1 | #391f2f |
5.38:1 |
| Info | {colors.info-dark} #38bdf8 |
8.72:1 | #1b2b45 |
6.63:1 |
| Progress | {colors.progress-dark} #b8b0f0 |
9.34:1 | #2b244c |
7.20:1 |
| Neutral | {colors.neutral-dark} #d6cfe0 |
12.33:1 | #2f253e |
9.53:1 |
button-danger keeps {colors.danger} with white text in both modes.
Orange is the default and the brand: a user who never opens the theme setting sees exactly the palette above. Each user may pick a color theme — Padrão (orange), Azul, Verde, Violeta or Grafite — saved per user like the color mode. Theme and mode are independent: five themes × Claro / Escuro / Sistema. A theme swaps the action color and, in light mode, the sidebar; it never touches status colors, inputs, muted text, disabled states, or the entry surfaces.
Light mode. Canvas, cards, borders, inputs, muted text and disabled states are the default light values ({colors.surface-canvas-light}, {colors.hairline-cloud}, {colors.hairline-input}, {colors.ink-muted}, {colors.text-disabled}). The theme sets the action color and a dark sidebar in the theme's color. The dark sidebar is part of the theme, not a single dark band added to a light screen: Padrão keeps the light sidebar, and the four themes define it as one coordinated palette with the action color. The sidebar's own text, muted text, hover, active item and focus ring are theme tokens (table below) so the sidebar never depends on the content tokens.
Dark mode. The whole screen stays on the violet midnight palette of Panel Dark Mode ({colors.surface-canvas-dark}, {colors.surface-night}), sidebar included. The theme only swaps the action color for a lighter version of its hue with an ink label ({colors.on-primary}) and recalculates {colors.primary-strong} and {colors.primary-tint} on night. Grafite is the exception: its dark mode is a neutral graphite palette (#171717 canvas, #1f1f1f cards, #27272a subtle, #fafafa text, #a1a1aa muted, #3f3f46 borders, input border #74747d) with orange action, still a full-screen switch.
Entry surfaces. Logins and the client-area welcome (.superficie-entrada) are always the brand palette, whatever the theme.
Rules.
- A theme's action color never equals a status color, the focus ring, or the link violet: Azul is an indigo-leaning royal blue (hue ~228°, away from
{colors.info}#0369a1and{colors.ring-focus}#3B82F6), Verde a teal-emerald (hue ~174°, away from{colors.success}#15803d), Violeta a purple (hue ~272°, away from{colors.accent-violet}#6a5fc1, which is Progress).scripts/contraste-temas.mjsfails on an exact match. - Status never uses the action hex, in any theme: states stay
pill-statuswith their word on the semantic palette, so the action color keeps meaning "act here" and a green or blue button never reads as success or info. - One filled
button-primaryper screen, in whatever the action color is. Labels follow the table: ink on orange and on every dark-mode action color, white on the light-mode Azul, Verde and Violeta (white on those is ≥ 4.5:1 in every state, hover and pressed included). - A thin action-color indicator keeps its second cue (weight 600 text and a background) in every theme.
- Dark sidebars (light mode) use a light focus ring
#93c5fdinstead of{colors.ring-focus}, which does not reach 3:1 on them; elsewhere the ring is unchanged. - Changing a theme value starts in
scripts/contraste-temas.mjs: the script exits with an error if any pair below fails, andtests/js/temas-tokens.test.mjsfails ifassets/src/tokens.cssdrifts from it. - The dark sidebars of light mode carry a sidebar accent (
--mapos-sidebar-accent), light enough to read at 3:1 on the sidebar: it draws the active-item bar and the logo square (label in{colors.ink}). The active item keeps its second cue (weight 600 and the active background). - Grafite dark has a neutral surface, so its status
-softfills are the status-inkat 14% over#1f1f1finstead of the violet-tinted fills of Panel Dark Mode: success#253a2d, warning#3e371e, danger#3d2a2a, info#23353d, progress#34333c, neutral#39383a; the-inkcolors are unchanged.
Tokens by theme. Light mode inherits canvas, cards, text, muted, borders and inputs from the default; dark mode inherits them from Panel Dark Mode (Grafite dark replaces them as described above). "Sidebar" is the dark sidebar background of light mode; active item is background / text.
| Theme | Mode | primary |
primary-hover |
primary-pressed |
on-primary |
primary-strong |
primary-tint |
Sidebar | Active item |
|---|---|---|---|---|---|---|---|---|---|
| Padrão | light | #f37338 |
#f47e48 |
#db6230 |
#1f1633 |
#b34d1d |
#feeee7 |
surface | tint / strong |
| Padrão | dark | #f37338 |
#f47e48 |
#db6230 |
#1f1633 |
#f37338 |
#391f26 |
surface | tint / strong |
| Azul | light | #2240b8 |
#2b4fd6 |
#1a3190 |
#ffffff |
#2240b8 |
#e9ecf8 |
#121a45 |
#2b4fd6 / #ffffff |
| Azul | dark | #7f98ff |
#93a9ff |
#6a85f2 |
#1f1633 |
#a3b4ff |
#262546 |
surface | tint / strong |
| Verde | light | #0b6b60 |
#0f7a6e |
#08524a |
#ffffff |
#0b6b60 |
#e7f0ef |
#0a3a35 |
#0f7a6e / #ffffff |
| Verde | dark | #2dd4bf |
#5eead4 |
#19b8a5 |
#1f1633 |
#5eead4 |
#192f3c |
surface | tint / strong |
| Violeta | light | #7424c4 |
#8230d6 |
#5f1da3 |
#ffffff |
#7424c4 |
#f1e9f9 |
#2b1257 |
#7424c4 / #ffffff |
| Violeta | dark | #cf86ff |
#da9dff |
#bd6ff0 |
#1f1633 |
#dcaaff |
#332246 |
surface | tint / strong |
| Grafite | light | #f37338 |
#f47e48 |
#db6230 |
#1f1633 |
#b34d1d |
#feeee7 |
#1c1c1f |
#f37338 / #1f1633 |
| Grafite | dark | #f97316 |
#fb8c3a |
#ea670c |
#171717 |
#fb923c |
#2a2015 |
surface | tint / strong |
Sidebar accent (active bar and logo) for the dark sidebars of light mode: Azul #a3b4ff, Verde #5eead4, Violeta #d5a6ff, Grafite #f37338. Sidebar text tokens for the same sidebars (text / muted / hover): Azul #eef1ff / #b7c0ea / #1c2762; Verde #e8fbf8 / #a9d9d2 / #0f4d46; Violeta #f6eeff / #cdb6ee / #3d1c78; Grafite #f4f4f5 / #b4b4bc / #2a2a2e.
Contrast, generated by node scripts/contraste-temas.mjs --md. Every cell meets its minimum: 4.5:1 for text pairs (on-primary on primary / hover / pressed, strong on canvas / surface / tint, muted on surface / subtle, sidebar text / muted / hover / active item, logo label on accent, and every status pill's ink on soft) and 3:1 for the input border, the focus ring (canvas and sidebar) and the sidebar accent. A dash means the pair does not apply (the sidebar accent exists only for the dark sidebars of light mode).
| Pair | Min | padrao light | padrao dark | azul light | azul dark | verde light | verde dark | violeta light | violeta dark | grafite light | grafite dark |
|---|---|---|---|---|---|---|---|---|---|---|---|
| on-primary on primary | 4.50 | 6.00 | 6.00 | 8.42 | 6.42 | 6.39 | 9.24 | 7.52 | 6.97 | 6.00 | 6.40 |
| on-primary on hover | 4.50 | 6.49 | 6.49 | 6.58 | 7.67 | 5.21 | 11.63 | 6.28 | 8.39 | 6.49 | 7.61 |
| on-primary on pressed | 4.50 | 4.75 | 4.75 | 11.13 | 5.12 | 9.07 | 6.91 | 9.58 | 5.48 | 4.75 | 5.50 |
| primary-strong on canvas | 4.50 | 5.26 | 6.00 | 8.42 | 8.63 | 6.39 | 11.63 | 7.52 | 9.20 | 5.26 | 7.92 |
| primary-strong on surface | 4.50 | 5.26 | 6.51 | 8.42 | 9.36 | 6.39 | 12.62 | 7.52 | 9.99 | 5.26 | 7.28 |
| primary-strong on primary-tint | 4.50 | 4.65 | 5.24 | 7.15 | 7.34 | 5.51 | 9.38 | 6.36 | 7.71 | 4.65 | 7.05 |
| muted on surface | 4.50 | 7.13 | 9.90 | 7.13 | 9.90 | 7.13 | 9.90 | 7.13 | 9.90 | 7.13 | 6.43 |
| muted on surface-subtle | 4.50 | 6.57 | 9.36 | 6.57 | 9.36 | 6.57 | 9.36 | 6.57 | 9.36 | 6.57 | 5.81 |
| input border on surface | 3.00 | 3.58 | 3.83 | 3.58 | 3.83 | 3.58 | 3.83 | 3.58 | 3.83 | 3.58 | 3.56 |
| input border on canvas | 3.00 | 3.58 | 3.53 | 3.58 | 3.53 | 3.58 | 3.53 | 3.58 | 3.53 | 3.58 | 3.87 |
| focus ring on canvas | 3.00 | 3.68 | 4.68 | 3.68 | 4.68 | 3.68 | 4.68 | 3.68 | 4.68 | 3.68 | 4.87 |
| focus ring on sidebar | 3.00 | 3.68 | 5.08 | 9.25 | 5.08 | 6.98 | 5.08 | 8.78 | 5.08 | 9.43 | 4.48 |
| sidebar: text | 4.50 | 17.20 | 18.68 | 14.82 | 18.68 | 11.73 | 18.68 | 14.01 | 18.68 | 15.47 | 15.79 |
| sidebar: text on hover | 4.50 | 15.85 | 17.66 | 12.31 | 17.66 | 9.02 | 17.66 | 11.37 | 17.66 | 13.00 | 14.27 |
| sidebar: muted | 4.50 | 7.13 | 9.90 | 9.32 | 9.90 | 8.11 | 9.90 | 8.68 | 9.90 | 8.25 | 6.43 |
| sidebar: accent bar/logo on sidebar | 3.00 | – | – | 8.36 | – | 8.50 | – | 8.09 | – | 5.93 | – |
| sidebar: logo label on accent | 4.50 | – | – | 8.63 | – | 11.63 | – | 8.79 | – | 6.00 | – |
| sidebar: active item | 4.50 | 4.65 | 5.24 | 6.58 | 7.34 | 5.21 | 9.38 | 7.52 | 7.71 | 6.00 | 7.05 |
| kpi success: label/caption (muted) no canto | 4.50 | 5.43 | 8.31 | 5.43 | 8.31 | 5.43 | 8.31 | 5.43 | 8.31 | 5.43 | 5.34 |
| kpi success: valor (text) no canto | 4.50 | 13.10 | 15.67 | 13.10 | 15.67 | 13.10 | 15.67 | 13.10 | 15.67 | 13.10 | 13.11 |
| kpi success: sparkline (ink) no canto | 3.00 | 5.66 | 9.00 | 5.66 | 9.00 | 5.66 | 9.00 | 5.66 | 9.00 | 5.66 | 7.85 |
| kpi success: ícone (ink on soft) | 4.50 | 5.82 | 7.92 | 5.82 | 7.92 | 5.82 | 7.92 | 5.82 | 7.92 | 5.82 | 7.00 |
| kpi warning: label/caption (muted) no canto | 4.50 | 5.47 | 8.21 | 5.47 | 8.21 | 5.47 | 8.21 | 5.47 | 8.21 | 5.47 | 5.29 |
| kpi warning: valor (text) no canto | 4.50 | 13.20 | 15.50 | 13.20 | 15.50 | 13.20 | 15.50 | 13.20 | 15.50 | 13.20 | 12.99 |
| kpi warning: sparkline (ink) no canto | 3.00 | 4.90 | 10.12 | 4.90 | 10.12 | 4.90 | 10.12 | 4.90 | 10.12 | 4.90 | 8.85 |
| kpi warning: ícone (ink on soft) | 4.50 | 5.06 | 8.69 | 5.06 | 8.69 | 5.06 | 8.69 | 5.06 | 8.69 | 5.06 | 7.75 |
| kpi info: label/caption (muted) no canto | 4.50 | 5.29 | 8.52 | 5.29 | 8.52 | 5.29 | 8.52 | 5.29 | 8.52 | 5.29 | 5.49 |
| kpi info: valor (text) no canto | 4.50 | 12.76 | 16.07 | 12.76 | 16.07 | 12.76 | 16.07 | 12.76 | 16.07 | 12.76 | 13.49 |
| kpi info: sparkline (ink) no canto | 3.00 | 5.52 | 7.50 | 5.52 | 7.50 | 5.52 | 7.50 | 5.52 | 7.50 | 5.52 | 6.57 |
| kpi info: ícone (ink on soft) | 4.50 | 5.68 | 6.63 | 5.68 | 6.63 | 5.68 | 6.63 | 5.68 | 6.63 | 5.68 | 5.95 |
| kpi progress: label/caption (muted) no canto | 4.50 | 5.45 | 8.18 | 5.45 | 8.18 | 5.45 | 8.18 | 5.45 | 8.18 | 5.45 | 5.29 |
| kpi progress: valor (text) no canto | 4.50 | 13.15 | 15.45 | 13.15 | 15.45 | 13.15 | 15.45 | 13.15 | 15.45 | 13.15 | 13.00 |
| kpi progress: sparkline (ink) no canto | 3.00 | 7.06 | 7.73 | 7.06 | 7.73 | 7.06 | 7.73 | 7.06 | 7.73 | 7.06 | 6.79 |
| kpi progress: ícone (ink on soft) | 4.50 | 6.71 | 7.20 | 6.71 | 7.20 | 6.71 | 7.20 | 6.71 | 7.20 | 6.71 | 6.24 |
| kpi tendência success: ink on soft | 4.50 | 5.82 | 7.92 | 5.82 | 7.92 | 5.82 | 7.92 | 5.82 | 7.92 | 5.82 | 7.00 |
| kpi tendência warning: ink on soft | 4.50 | 5.06 | 8.69 | 5.06 | 8.69 | 5.06 | 8.69 | 5.06 | 8.69 | 5.06 | 7.75 |
| kpi tendência neutral: ink on soft | 4.50 | 6.84 | 9.53 | 6.84 | 9.53 | 6.84 | 9.53 | 6.84 | 9.53 | 6.84 | 7.70 |
| pill success: ink on soft | 4.50 | 5.82 | 7.92 | 5.82 | 7.92 | 5.82 | 7.92 | 5.82 | 7.92 | 5.82 | 7.00 |
| pill warning: ink on soft | 4.50 | 5.06 | 8.69 | 5.06 | 8.69 | 5.06 | 8.69 | 5.06 | 8.69 | 5.06 | 7.75 |
| pill danger: ink on soft | 4.50 | 4.95 | 5.38 | 4.95 | 5.38 | 4.95 | 5.38 | 4.95 | 5.38 | 4.95 | 4.86 |
| pill info: ink on soft | 4.50 | 5.68 | 6.63 | 5.68 | 6.63 | 5.68 | 6.63 | 5.68 | 6.63 | 5.68 | 5.95 |
| pill progress: ink on soft | 4.50 | 6.71 | 7.20 | 6.71 | 7.20 | 6.71 | 7.20 | 6.71 | 7.20 | 6.71 | 6.24 |
| pill neutral: ink on soft | 4.50 | 6.84 | 9.53 | 6.84 | 9.53 | 6.84 | 9.53 | 6.84 | 9.53 | 6.84 | 7.70 |
| pill azulescuro: ink on soft | 4.50 | 7.61 | 7.92 | 7.61 | 7.92 | 7.61 | 7.92 | 7.61 | 7.92 | 7.61 | 6.32 |
| pill roxo: ink on soft | 4.50 | 6.60 | 8.99 | 6.60 | 8.99 | 6.60 | 8.99 | 6.60 | 8.99 | 6.60 | 7.02 |
The display tier is Space Grotesk at heavy weights (600–700) — chunky, near-condensed proportions with a slightly playful personality. When unavailable, fall back to Rubik at heavier weights for visual continuity.
The UI tier is Rubik — an open-source Hebrew/Latin sans on Google Fonts — with system fallbacks (-apple-system, system-ui, Segoe UI, Helvetica, Arial). Rubik handles every body, caption, button, and eyebrow role.
The code tier is Monaco with Menlo and Ubuntu Mono fallbacks — used in code blocks, install snippets, and inline tokens.
| Token | Size | Weight | Line Height | Letter Spacing | Use |
|---|---|---|---|---|---|
{typography.display-hero} |
88px | 700 | 1.2 | 0 | Entry-surface hero headline (login, client-area welcome) |
{typography.display-large} |
60px | 500 | 1.1 | 0 | Section openers on dark surfaces |
{typography.heading-xl} |
30px | 500 | 1.2 | 0 | Page titles on light surfaces (e.g., "Ordens de Serviço") |
{typography.heading-lg} |
27px | 500 | 1.25 | 0 | Sub-section headings, large card titles |
{typography.heading-md} |
24px | 500 | 1.25 | 0 | Card titles, in-page section headings |
{typography.heading-sm} |
20px | 600 | 1.25 | 0 | Compact card title, list-group title |
{typography.body-lg} |
16px | 400 | 2.0 | 0 | Entry-surface paragraph — the airy, two-line-leading variant used in hero subtext |
{typography.body-strong} |
16px | 600 | 1.5 | 0 | Emphasized body run, lead sentence |
{typography.body-md} |
16px | 400 | 1.5 | 0 | Default UI body, table cells, text typed into fields |
{typography.label-md} |
16px | 500 | 1.5 | 0 | Form labels, the primary name in a table row (client), list-item titles |
{typography.eyebrow} |
15px | 500 | 1.4 | 0 | Section eyebrow above large headings, all-caps |
{typography.button-cap} |
14px | 700 | 1.14 | 0.2px | Filled button labels (uppercase) |
{typography.button-cap-light} |
14px | 500 | 1.29 | 0.2px | Ghost / outline button labels (uppercase) |
{typography.caption} |
14px | 400 | 1.43 | 0 | Footer text, fine print, helper copy |
{typography.micro-cap} |
10px | 600 | 1.8 | 0.25px | Status labels, badge text, micro-eyebrow |
{typography.code} |
16px | 400 | 1.5 | 0 | Code block content |
{typography.code-strong} |
16px | 700 | 1.5 | 0 | Highlighted code keyword |
- Two leading worlds. Entry-surface copy uses 2.0 line-height on
{typography.body-lg}— extremely airy, generous breathing room. Operational UI copy uses 1.5 line-height on{typography.body-md}— denser, closer to a work-order form. The choice is deliberate: entry surfaces read like prose, operational screens read like a checklist. - Weight marks structure, not data. Data — table cells, values, dates, typed input text — runs at 400 in
{typography.body-md}. Weight 500 ({typography.label-md}) is for what names things: labels, the primary name in a row, navigation items. Weight 600 marks the active or selected state. Setting dense tables in 500 makes the whole screen read as bold. - Caps with tracking. All button labels and eyebrows are uppercase with 0.2px tracking. This is the brand's typographic signature — a label-maker cadence applied to UI affordances.
- Headlines as highlights. The hero display is structured so a single keyword can be wrapped in a
{colors.accent-lime}highlight chip without disrupting the reading order. Treat the lime chip as a glyph-level decoration, not a separate component.
Rubik and Space Grotesk are both open-source on Google Fonts. If Space Grotesk doesn't fit a context, Archivo (semi-condensed weights) or Hubot Sans (optical-size axis at heavier ends) carry the same chunky, near-condensed silhouette. Adjust line-height down by 0.05 when substituting at large display sizes.
- Base unit: 8px
- Tokens:
{spacing.xxs}2px ·{spacing.xs}4px ·{spacing.sm}8px ·{spacing.md}12px ·{spacing.lg}16px ·{spacing.xl}24px ·{spacing.xxl}32px ·{spacing.section}96px - Section padding:
{spacing.section}96px between major page bands on desktop, collapsing to{spacing.xxl}32px–48px on mobile. - Card internal padding:
{spacing.xxl}32px on pricing cards and large feature cards;{spacing.lg}16px on compact tag/badge groups. - Form field padding:
{spacing.sm}8px vertical,{spacing.md}12px horizontal — matches the text-input token directly.
- Pages use a wide centered container with generous outer gutters; max width sits around 1152px (one of the extracted breakpoints), with content inside flexing across 12 conceptual columns.
- Pricing splits into a 4-tier card row at desktop, collapsing to 2-up at mid widths and 1-up on mobile.
- The contact form uses a 2-column field layout (first/last name side-by-side) inside a single light-canvas panel.
- Breakpoints stair-step at 1440 → 1152 → 992 → 768 → 640 → 576 — see Responsive Behavior.
The dark canvas absorbs whitespace differently from light. On dark surfaces the brand stretches {spacing.section} generously between bands so floating illustrations and starfield textures have room to breathe. On light surfaces (the operational screens) the whitespace tightens — content density takes priority because users are scanning, comparing, and acting. Rule of thumb: hero and feature surfaces are spacious, transactional surfaces are dense.
| Level | Treatment | Use |
|---|---|---|
| 0 | Flat on canvas, no shadow | Default surface, dark or light |
| 1 | box-shadow: rgba(0,0,0,0.08) 0 2px 8px 0 |
Inverted buttons on dark canvas (light fill lifting off dark surface) |
| 2 | box-shadow: rgba(0,0,0,0.1) 0 10px 15px -3px, rgba(0,0,0,0.1) 0 4px 6px -4px |
Floating cards on light canvas, modals |
| 3 | box-shadow: rgb(21,15,35) 0 0 8px 6px |
Halo around the orange CTA on dark entry surfaces — {colors.surface-night} itself becomes the shadow, a vignette that makes the orange read brighter |
| 4 | box-shadow: rgba(0,0,0,0.18) 0 0.5rem 1.5rem |
Pressed inverted button on dark canvas |
On dark entry surfaces, depth doesn't come from drop shadows — it comes from the starfield texture on the hero canvas (subtle white-on-violet pinpricks at low opacity), the floating sticker illustrations (drawn with hand-rendered outlines and saturated fills, layered above the canvas with no shadow), and the lime squiggly divider above the footer. These illustrative elements do the work that shadow stacks do in flatter design systems — they tell the eye where one section ends and another begins. Operational screens on light canvas use the elevation levels above instead.
| Token | Value | Use |
|---|---|---|
{rounded.xs} |
4px | Badges, checkboxes, lime keyword highlight chips |
{rounded.sm} |
6px | Text inputs, search boxes |
{rounded.md} |
8px | Primary and inverted buttons, code blocks, select dropdowns |
{rounded.lg} |
10px | Generic divs, container blocks |
{rounded.xl} |
12px | Pricing cards, feature cards, navigation pill chrome |
{rounded.xxl} |
18px | Image containers, large hero illustrations |
{rounded.full} |
9999px | Avatars, circular icon buttons, status pills, counters |
Map-OS doesn't use traditional photography — it uses illustrated stickers and product UI screenshots in roughly equivalent geometric roles. Product UI mocks sit inside {rounded.xxl} 18px containers, often tilted slightly off-axis, against the dark canvas with no border. Sticker illustrations have no container at all — they are layered directly on canvas, often overlapping section boundaries to break the grid. User avatars without a photo show initials on a {rounded.full} circle.
States. Specs list Default and Pressed/Active, plus Focused, Error, and Disabled where the component has them; each variant is its own entry (
-pressed,-focused,-error,-disabled). Hover is a light shift only:button-primarymixes 8% white into{colors.primary}, and neutral controls (outline buttons, icon buttons, menu items, table rows) hover to{colors.surface-subtle}.
button-primary — the dominant CTA on both canvases.
- Background
{colors.primary}, text{colors.on-primary}(6.00:1), type{typography.button-cap}(uppercase, 14px / 700, 0.2px tracking), padding{spacing.md} {spacing.lg}(12px 16px), rounded{rounded.md}. On dark entry surfaces, add the level-3 halo for emphasis. - Pressed state lives in
button-primary-pressed: background darkens to{colors.primary-pressed}, text stays{colors.on-primary}(4.75:1). The hue never changes on press — only the value drops.
button-inverted — secondary CTA on dark canvas, placed beside button-primary when a view needs a second strong action.
- Background
{colors.on-dark}(white), text{colors.ink-deep}, same{typography.button-cap}, rounded{rounded.md}. - Pressed in
button-inverted-pressed: background drops to{colors.surface-press-light}, text to{colors.ink-press}.
button-ghost-on-dark — low-emphasis action on dark canvas (e.g., "Área do cliente" beside "Entrar" on the login screen).
- Translucent fill
{colors.on-dark-faint}, text{colors.on-dark}, type{typography.button-cap}, padding{spacing.sm}(8px), rounded{rounded.xl}. The translucent fill lets the canvas texture show through.
button-violet-token — pill-shaped tag/category button used inline in filters and section navs.
- Background
{colors.accent-violet-mid}, text{colors.on-dark}, type{typography.button-cap-light}, padding{spacing.sm} {spacing.lg}(8px 16px), rounded{rounded.xl}, 1px hairline border in a slightly deeper violet.
button-outline — secondary action on light canvas (e.g., "Cancelar", "Filtrar").
- Transparent fill, text
{colors.ink-deep}, 1px{colors.hairline-cool}border, type{typography.button-cap-light}, padding{spacing.md} {spacing.lg}, rounded{rounded.md}. Hover fills{colors.surface-subtle}. In dark panel mode the border becomes{colors.hairline-input-dark}and the text{colors.on-dark}.
button-danger — destructive actions only (excluir, cancelar OS), usually inside a confirmation modal.
- Background
{colors.danger}, text white (4.83:1), type{typography.button-cap}, same geometry asbutton-primary. Pressed darkens to{colors.danger-ink}. Never orange: destructive and primary actions must not look alike.
button-disabled
- Background
{colors.hairline-cloud}, text{colors.text-disabled}, otherwise identical tobutton-primary. In dark panel mode:rgba(255,255,255,0.08)fill withrgba(255,255,255,0.45)text. Prefer explaining why an action is unavailable (helper text or tooltip) over a silent disabled button.
card-pricing — the standard tier card (plans, service packages).
- Background
{colors.surface-canvas-light}, text{colors.ink-deep}, padding{spacing.xxl}32px, rounded{rounded.xl}12px, 1px{colors.hairline-cloud}border. Headline at top in{typography.heading-md}, price in{typography.display-large}, feature list in{typography.body-md}, primary CTA pinned to the bottom of the card.
card-pricing-featured — the dark inverted "featured" tier, reserved for the single option the view recommends.
- Background
{colors.surface-night}, text{colors.on-dark}, otherwise identical structure tocard-pricing. The inversion (rather than an accent-bordered light card) is the brand's distinctive choice — the featured tier reads as the brand's voice, not as decoration.
card-feature-dark — large feature-band card on dark surfaces, used to anchor feature explanations.
- Background
{colors.ink-deep}, text{colors.on-dark}, padding{spacing.xxl}32px, rounded{rounded.xxl}18px. Often holds a UI mock plus a 27px headline plus 16px body.
card-spotlight-violet — accent feature card with deeper violet fill, used for highlight bands that call out a key capability.
- Background
{colors.accent-violet-deep}, text{colors.on-dark}, padding{spacing.xxl}, rounded{rounded.xxl}. The deep violet reads as a feature highlight without breaking out of the brand's purple family — and leaves orange free to mean "act here".
code-block — code/install snippets.
- Background
{colors.surface-night}, text{colors.on-dark}rendered in{typography.code}. Padding{spacing.lg}16px, rounded{rounded.md}. On dark canvas the code block is barely lifted from canvas — only the slightly deeper fill differentiates it.
text-input — every text, number, date, and search field.
- Background
{colors.surface-canvas-light}, text{colors.ink-deep}, type{typography.body-md}(400), padding{spacing.sm} {spacing.md}(8px 12px), rounded{rounded.sm}6px, 1px{colors.hairline-input}border. Placeholder in{colors.ink-muted}. Label above in{typography.label-md}; helper text below in{typography.caption}{colors.ink-muted}. - Focus state in
text-input-focused: same fill, inset shadowrgba(0,0,0,0.15) 0 2px 10px insetto suggest depth pressed inward, plus a 3px{colors.ring-focus}ring. - Error state in
text-input-error: border{colors.danger}; below the field, an alert-circle icon and the message in{typography.caption}{colors.danger-ink}, linked witharia-describedby. The message says what to fix ("IMEI já cadastrado na OS #0981"), not just that something is wrong. - Disabled state in
text-input-disabled: fill{colors.surface-subtle}, text{colors.ink-muted}, not-allowed cursor; a helper line explains where the value comes from ("Calculado pelos produtos e serviços").
select — native or enhanced (autocomplete) dropdown on light canvas.
- Same box as
text-input, with a 16px chevron in{colors.ink-muted}12px from the right edge. The open list is a level-2 card; the highlighted option uses{colors.primary-tint}, and the typed match is set in weight 600 (lime stays reserved for headline chips). A footer row offers the create action ("Cadastrar novo cliente").
checkbox / radio / switch
- 20px box (
{rounded.xs}for checkbox, circle for radio) with a 1.5px{colors.hairline-input}border. Checked: fill{colors.primary}with an{colors.on-primary}check mark or dot — never a white mark (2.87:1). Switch: 40×24px track,{colors.hairline-input}when off,{colors.primary}when on, knob white off and{colors.on-primary}on. The label sits to the right in{typography.label-md}.
select-violet — the dropdown variant used inside dark contact panels.
- Background
{colors.accent-violet-deep}, text{colors.on-dark}, type{typography.body-md}, padding{spacing.sm} {spacing.lg}, rounded{rounded.md}. Distinctive because it doesn't mimic a plain text input — it reads as a deliberate brand surface. Reserved for entry surfaces; selects inside the dark panel mode useselectwith the dark-mode input tokens.
Second-cue rule. A thin orange indicator (a bar or underline of 3px or less) reads at only 2.87:1 on white, so it never marks a state alone. The active item always pairs it with weight 600 text in ink and, where the item has a surface, a
{colors.primary-tint}background.
sidebar — the primary navigation of the admin panel (the v5 layout).
- 252px wide, background
{colors.surface-canvas-light}, 1px{colors.hairline-cloud}right border. Header (64px) holds the logo — a 34px{colors.primary}rounded square with an{colors.on-primary}wrench glyph, the "Map-OS" wordmark in the display face, a version badge — and the collapse button. - Items are grouped (Operação / Financeiro / Sistema) under 11px / 600 uppercase group labels in
{colors.ink-muted}. Each item is 40px tall, rounded{rounded.md}, a 20px stroke icon (2px) plus the label at 15px / 500 in{colors.ink-muted}; hover goes to{colors.surface-subtle}and ink. - Active item: 3px
{colors.primary}bar on the left edge,{colors.primary-tint}background, label and icon in ink at weight 600 — never orange text. - Counters (e.g., open OS) use a neutral pill (
{colors.neutral-soft}/{colors.neutral-ink}), not orange. The footer holds the user card (initials avatar in{colors.accent-violet-mid}, name, role). - Collapsed variant
sidebar-collapsed: a 76px icon rail; labels move into tooltips andaria-labels, the active bar stays.
topbar — the 64px bar above the content.
- Background
{colors.surface-canvas-light}, 1px{colors.hairline-cloud}bottom border. Left: the global search as atext-inputwith a search icon and aCtrl Khint. Right: theme toggle, notifications (unread dot in{colors.danger}), initials avatar, and — when the view has a creation action such as "Nova OS" — the screen's singlebutton-primary.
Top Nav (dark variant) — used on dark entry surfaces and on the client area at desktop widths; logo on the left, links in {colors.on-dark-muted}, sitting on {colors.surface-canvas-dark}. The primary CTA stays button-primary orange; secondary actions become button-inverted or button-ghost-on-dark.
tabs — section tabs inside a page (e.g., Detalhes / Produtos / Serviços / Anexos on an OS).
- Labels at 15px / 500 in
{colors.ink-muted}with optional neutral counters; a 1px{colors.hairline-cloud}baseline. Active tab: label in ink at weight 600 plus a 2px{colors.primary}underline. - Overflow: when the tabs don't fit, the strip scrolls horizontally and its edges fade where a tab is hidden. With JavaScript the active tab is centered on load, the mouse wheel scrolls the strip, and a
button-ghosticon button (chevron,{colors.ink-muted}) sits on the edge with a hidden tab, over a{colors.surface-canvas-light}fade, and scrolls about one page. The arrows are pointer aids, out of the tab order and hidden from assistive tech, since keyboard users reach every tab with Tab. No new colors: the contrast ratios are those of the existing{colors.ink-muted}label.
tabbar-mobile — bottom navigation of the client area on phones.
- Four items (Início, Minhas OS, Compras, Conta), white background, 1px
{colors.hairline-cloud}top border, 24px icon over a 12px label in{colors.ink-muted}. Active item: label and icon in ink at weight 600 with a 28×3px{colors.primary}indicator at the top edge.
Mobile nav — below 1024px (the lg breakpoint of the v5 layout) the sidebar becomes an off-canvas drawer opened by a menu button in the topbar; the topbar keeps search, notifications, and the primary action, which shrinks to its icon on small phones.
data-table — the list screens (OS, clientes, vendas, lançamentos).
- Sits inside a white card (
{rounded.xl}, 1px{colors.hairline-cloud}). Header row on{colors.surface-subtle}: 12px / 600 uppercase, 0.35px tracking,{colors.ink-muted}. Cells in{typography.body-md}(400) with 14px / 16px padding and{colors.hairline-cloud}row dividers; the primary name in{typography.label-md}with a secondary line (equipment, document) in{typography.caption}{colors.ink-muted}. - Numbers and currency are right-aligned with tabular figures; status, technician, and date columns don't wrap. Row actions are 36px icon buttons with
aria-labels. Row hover uses{colors.surface-subtle}. - Footer: record count on the left, pagination on the right — 36px items, the current page filled
{colors.primary}with{colors.on-primary}at weight 700.
kpi-card — summary cards on the dashboard and above lists.
- Card on
{colors.surface}({rounded.xl}, 1px{colors.hairline-cloud}, 16px 20px padding): label at 14px / 500{colors.ink-muted}, the value in the display face at about 30px / 500, an optional trend pill and a caption line (it may carry a status-colored phrase, e.g. warning ink for "2 há mais de 5 dias"). A 56px icon tile sits on the right. - Accent by status.
accentis one ofsuccess,warning,info,progressorneutral(default; anything else falls back toneutral). It colors the icon tile (-inkon-soft) and gives the card a gradient plus a 3px side bar: the status base color mixed at 20% over{colors.surface}at the top-left corner, fading out by 62% of the diagonal, with the border and bar tinted by the same base.primaryanddangerare not accents: orange means "act here" and red is only for errors and destructive actions, so a card that merely needs attention useswarning. Mapping: Receitassuccess, Despesaswarning, Saldo previsto and Orçamentosinfo, Vencidoswarning, OS em andamentoprogress, Vendas em abertosuccess. - Contrast. The corner is the worst point of the gradient. Checked in
scripts/contraste-temas.mjsfor the five themes in light and dark:{colors.ink-muted}label and caption at least 5.29:1 (4.5:1 required), the value at least 12.76:1, the status-inkof the sparkline at least 5.26:1 (3:1 required), the tile and trend pill-inkon-softat least 5.85:1. If a theme ever fails, lower the 20% mix, not the text colors. - Trend (
tendenciaKpi): a fully rounded pill with an arrow (↑ ↓ →) and the percentage, next to the value, with the full sentence ("+12% vs. período anterior") in itstitle. A good variation issuccess-inkonsuccess-soft; a bad one iswarning-inkonwarning-soft(never red); a stable one isneutral-inkonneutral-soft. Spending going up is the bad direction for Despesas. The arrow and the percentage are always present, so color is never the only cue. - Sparkline: a 28px line of the last values under the caption, in the accent's
-ink(muted whenneutral), decorative (aria-hidden). - Clickable card: with
hrefthe card is an<a>that lifts 2px with a deeper shadow on hover (no lift underprefers-reduced-motion), keeps its side bar, and shows the 3px{colors.ring-focus}outline with a 2px offset on keyboard focus. - Money on the dashboard (
sensitive: the value and caption of "Saldo do mês" with its trend pill and sparkline, which disappear with them, the balance chart, the "Lançamentos a vencer" amounts) can be hidden with abutton-ghosteye toggle in the page header ("Ocultar valores" / "Mostrar valores",eye-off/eye; only the possible action is shown). Hidden values become•••••in{colors.ink-muted}(same contrast as a caption, on{colors.surface}in light and dark) and the chart is replaced by "Valores ocultos." The choice is per browser (localStoragemapos:valores-ocultos), a display preference and not access control.
pill-status — the state of an OS, sale, or charge.
- Fully rounded, 2px 10px padding, 13px / 600, a 6px dot in the same color before the label; text
-inkon-softfrom the status table (dark-mode tokens in Panel Dark Mode). Always shows the word, never just the color.
alert-success / alert-warning / alert-danger / alert-info — inline messages.
{rounded.lg}, 14px 16px padding, 20px icon, title at weight 600 and body at 15px / 400, text in the state's-inkon its-soft, 1px border in the same ink at 28% opacity.
toast — confirmation after an action ("OS #1042 salva").
- A level-2 card at the top right of the content, 340px max, success icon, title at 600 and a
{colors.ink-muted}line, close button. It disappears on its own; errors usealert-dangerinline instead of a toast.
modal-confirm — destructive confirmation.
- Level-2 card up to 340px on a
rgba(21,15,35,0.55)backdrop, a danger-soft icon circle, title at 18px / 600, consequences spelled out in the body, andbutton-outline"Cancelar" besidebutton-danger.
pill-neutral-dark — small category / version pill on dark entry surfaces (for states, use pill-status).
- Background
{colors.surface-night}, text{colors.on-dark}, type{typography.caption}12px, padding{spacing.xs} {spacing.sm}(4px 8px), rounded{rounded.xs}4px.
chip-lime-keyword — the signature inline highlight wrapping single words inside the hero display headline.
- Background
{colors.accent-lime}, text{colors.ink-deep}, type matches the surrounding{typography.display-hero}, rounded{rounded.xs}4px, padding0 {spacing.md}(12px horizontal, 0 vertical so the chip hugs the cap-height).
Sticker Illustration Layer — illustrated stickers from the repair-shop world (tools, phones and laptops, delivery boxes, a friendly technician) drawn with hand-rendered outlines and saturated {colors.accent-pink} / {colors.accent-lime} fills — never {colors.primary}, which stays reserved for actions. Stickers are placed at section junctions on entry surfaces, often overlapping section boundaries by 30–40% of their height, with no container or shadow. They function as decorative section markers and brand personality carriers — never inside cards, never as buttons, never on operational screens.
Lime Squiggly Footer Divider — a hand-drawn {colors.accent-lime} squiggle line, ~3px stroke, sitting above the footer at full container width. Replaces what would otherwise be a 1px hairline divider with a personality-laden flourish.
Starfield Hero Texture — a faint white-on-violet pinprick pattern overlaid on the hero canvas at very low opacity. Adds atmospheric depth to the dark canvas without visible decoration. Implemented as a background image, not as repeating CSS.
Window-Chrome UI Mock — product UI screenshots framed in {rounded.xxl} containers, often tilted ±2–3 degrees off axis, positioned overlapping section boundaries on the dark feature pages. The chrome itself is just a rounded image with a subtle hairline; the content is the actual product UI.
link-on-dark — inline links in body copy on dark surfaces. Default text is {colors.on-dark} rendered in {typography.body-md} with a persistent underline; the underline is the entire affordance, no color change. Sits flush in copy with no padding, no rounded corners beyond the inherited {rounded.xs}.
link-on-light — inline links in body copy on light surfaces. Same shape contract as link-on-dark, but text is {colors.ink-deep}. When a link needs color emphasis, use {colors.primary-strong} — never the base {colors.primary}, which fails contrast as text on white. Used across the operational screens.
footer-light — site-wide footer on the light-canvas template (admin panel and operational screens).
- Background
{colors.surface-canvas-light}, text{colors.ink-deep}, type{typography.caption}, padding{spacing.xxl} {spacing.xl}(32px 24px). Topped by the lime squiggly divider — see Signature Components. Holds three to four columns of link groups, social icons in a horizontal strip at the bottom right, and a small legal/copyright row at the very bottom in{typography.caption}.
- Reserve
{colors.accent-lime}for keyword-highlight chips inside display headlines and the footer squiggle divider — never use it as a button background, never as body text. - Keep
{colors.primary}for actions and active states only — one filled orange button per view, so the eye always finds the next step. - Pair every thin orange indicator (sidebar bar, tab underline, tab-bar mark) with weight 600 text and, where there is a surface,
{colors.primary-tint}— the state must survive without color. - Show every status as a
pill-statuswith its word, in the semantic palette; keep the table cells around it at weight 400. - Pair every
button-primarywith{typography.button-cap}in uppercase with 0.2px tracking — the cadence is part of the brand, not a stylistic option. - Treat the dark canvas (
{colors.surface-canvas-dark}) and light canvas ({colors.surface-canvas-light}) as two complete worlds — let one own entry and highlight surfaces and the other own the operational screens, with no half-measures. - Use sticker illustrations to break section boundaries on entry surfaces — let them overlap, tilt, and float; constraining them inside cards drains their personality.
- Use
card-pricing-featured(dark inverted tier) instead of an accent-bordered light tier for the featured column. - Default body line-height to 1.5 on operational screens and 2.0 on entry surfaces — the difference is intentional.
- Offer the dark panel mode as a whole-screen preference (Claro / Escuro / Sistema), using the Panel Dark Mode tokens — never a dark band inside a light screen.
- Don't introduce accents beyond
{colors.primary}(or the user's theme color),{colors.accent-lime}, and{colors.accent-pink}— and keep their jobs apart: orange acts, lime highlights words, pink decorates illustrations. Adding teal, yellow, or a second orange shade dilutes the hierarchy. - Don't put white text on the orange
{colors.primary}— it measures 2.87:1, below WCAG AA. Labels on orange always use{colors.on-primary}; when orange has to sit behind white text or work as text on light canvas, switch to{colors.primary-strong}. - Don't use
{colors.primary}for warning or error states — orange already means "act here"; status messages use the semantic status colors. - Don't use
{colors.danger}for anything but errors and destructive actions, and don't make a destructive button orange. - Don't use
{colors.hairline-cool}as the only border of a form control — it measures 1.54:1; inputs use{colors.hairline-input}. - Don't set table cells, values, or typed input text at weight 500 — data runs at 400; 500 is for labels and names.
- Don't apply drop shadows to cards on dark canvas — depth comes from texture and illustration, not from light-on-dark shadows that would muddy the violet.
- Don't use
{typography.display-hero}(88px) for anything except the entry-surface hero — even sub-pages cap at{typography.display-large}(60px). - Don't put body text in
{colors.accent-lime}— it's a chip color, not a type color, and breaks contrast at body sizes. - Don't put illustrations inside cards or constrained containers — their job is to break grid, not occupy it.
| Name | Width | Key Changes |
|---|---|---|
| 4K / Wide | ≥ 1440px | Full 4-tier pricing row, hero illustration sits beside headline at full scale |
| Desktop | 1152–1440px | Default content max-width sits at 1152px, all 4-tier patterns hold |
| Laptop | 992–1151px | Tier cards collapse to 2-up; below 1024px the sidebar becomes an off-canvas drawer |
| Tablet | 768–991px | 2-column feature grids and form grids collapse to 1-up; KPI cards run 2-up |
| Mobile Large | 640–767px | Hero display drops from 88px to ~56px; filters stack |
| Mobile | 576–639px | Single-column layout (KPI cards stay 2-up); tables become card lists; section padding 32–48px |
| Small Mobile | 1–575px | Compact mode; sticker illustrations shrink or hide to preserve content priority |
- Primary buttons hit a minimum 44×44px on mobile (12px vertical padding × 16px font + line-height = ~44px). Maintains WCAG AAA touch-target spec.
- Pill tags and badges in nav and feature surfaces stay above 32×32px even at small mobile breakpoints; they enlarge if necessary rather than shrink.
- Form fields and buttons stay at the 44px minimum height on mobile.
- Hero display headline drops from 88px → 60px → 48px across the breakpoint stair; the lime keyword chip preserves padding and corner radius at every step.
- Pricing tiers stair-step from 4-up → 2-up → 1-up. The featured dark tier always remains visually distinguished — it never loses its inversion at any breakpoint.
- Sticker illustrations are progressively de-emphasized: at desktop they overlap section boundaries; at tablet they shift to inline within section padding; at small mobile most are hidden via
display: noneto keep the content scan-able. - Sidebar becomes an off-canvas drawer below 1024px, opened from the topbar menu button; it keeps the canvas polarity of the screen (light, or dark in the dark panel mode). The entry-surface top nav collapses to a menu button below 768px, and the client area switches to
tabbar-mobileon phones. - Data tables become card lists below 640px: number and status on the first line, client and equipment below, value and row actions at the bottom; secondary columns (technician, date) move to the detail view.
- Code blocks preserve 16px Monaco at every breakpoint — they never scale down — but switch to horizontal scroll on overflow rather than wrap.
- Product UI mocks scale proportionally; on small mobile they often anchor to one edge with horizontal overflow rather than shrink to illegibility.
- Sticker illustrations scale by 50–70% at mobile breakpoints, preserving their personality but ceding screen space to content.
- The lime footer squiggle scales the SVG to container width while keeping stroke width visually consistent.
- Focus on ONE component at a time. Don't rebuild the system — extend it.
- Reference component names and tokens directly (
{colors.accent-lime},{button-primary}-pressed,{rounded.xxl}) — do not paraphrase. - Run
npx @google/design.md lint DESIGN.mdafter edits —broken-ref,contrast-ratio, andorphaned-tokenswarnings flag issues automatically. - Add new variants as separate component entries (
-pressed,-disabled,-focused) — do not bury them inside prose. - Default to
{typography.body-md}(400) for operational UI body and data,{typography.label-md}(500) for labels and names, and{typography.body-lg}for entry-surface prose — the leading and weight differences are intentional and load-bearing. - Keep
{colors.accent-lime}scarce — one lime element per viewport. The signature only works because it's rare. - Before adding anything orange, confirm it is an action or an active state. If it isn't, it probably wants
{colors.accent-violet-mid}or a neutral. - When polarizing a new surface, choose one canvas (
{colors.surface-canvas-dark}or{colors.surface-canvas-light}) and commit to it; don't blend the two on a single page band.