An open-source, self-hostable PaaS alternative to Vercel, Heroku & Netlify that lets you easily deploy static sites, databases, full-stack applications and 360+ one-click services on your own servers.
PHP coolifydatabasesdeploymentdockerdocker-composeinertiajslaravelmariadbmysqlnextjsnodejsphppostgresredisself-hostedself-hostingserverstatic-sitesveltesvelte5
docs(design): migrate design system from .ai/ to DESIGN.md
Andras Bacsaiec6407a71f72
diff --git a/.ai/design-system.md b/.ai/design-system.mddeleted file mode 100644index d22adf3c69..0000000000--- a/.ai/design-system.md+++ /dev/null@@ -1,1666 +0,0 @@-# Coolify Design System--> **Purpose**: AI/LLM-consumable reference for replicating Coolify's visual design in new applications. Contains design tokens, component styles, and interactive states — with both Tailwind CSS classes and plain CSS equivalents.-------## 1. Design Tokens--### 1.1 Colors--#### Brand / Accent--| Token | Hex | Usage |-|---|---|---|-| `coollabs` | `#6b16ed` | Primary accent (light mode) |-| `coollabs-50` | `#f5f0ff` | Highlighted button bg (light) |-| `coollabs-100` | `#7317ff` | Highlighted button hover (dark) |-| `coollabs-200` | `#5a12c7` | Highlighted button text (light) |-| `coollabs-300` | `#4a0fa3` | Deepest brand shade |-| `warning` / `warning-400` | `#fcd452` | Primary accent (dark mode) |--#### Warning Scale (used for dark-mode accent + callouts)--| Token | Hex |-|---|---|-| `warning-50` | `#fefce8` |-| `warning-100` | `#fef9c3` |-| `warning-200` | `#fef08a` |-| `warning-300` | `#fde047` |-| `warning-400` | `#fcd452` |-| `warning-500` | `#facc15` |-| `warning-600` | `#ca8a04` |-| `warning-700` | `#a16207` |-| `warning-800` | `#854d0e` |-| `warning-900` | `#713f12` |--#### Neutral Grays (dark mode backgrounds)--| Token | Hex | Usage |-|---|---|---|-| `base` | `#101010` | Page background (dark) |-| `coolgray-100` | `#181818` | Component background (dark) |-| `coolgray-200` | `#202020` | Elevated surface / borders (dark) |-| `coolgray-300` | `#242424` | Input border shadow / hover (dark) |-| `coolgray-400` | `#282828` | Tooltip background (dark) |-| `coolgray-500` | `#323232` | Subtle hover overlays (dark) |--#### Semantic--| Token | Hex | Usage |-|---|---|---|-| `success` | `#22C55E` | Running status, success alerts |-| `error` | `#dc2626` | Stopped status, danger actions, error alerts |--#### Light Mode Defaults--| Element | Color |-|---|---|-| Page background | `gray-50` (`#f9fafb`) |-| Component background | `white` (`#ffffff`) |-| Borders | `neutral-200` (`#e5e5e5`) |-| Primary text | `black` (`#000000`) |-| Muted text | `neutral-500` (`#737373`) |-| Placeholder text | `neutral-300` (`#d4d4d4`) |--### 1.2 Typography--**Font family**: Inter, sans-serif (weights 100–900, woff2, `font-display: swap`)--#### Heading Hierarchy--> **CRITICAL**: All headings and titles (h1–h4, card titles, modal titles) MUST be `white` (`#fff`) in dark mode. The default body text color is `neutral-400` (`#a3a3a3`) — headings must override this to white or they will be nearly invisible on dark backgrounds.--| Element | Tailwind | Plain CSS (light) | Plain CSS (dark) |-|---|---|---|---|-| `h1` | `text-3xl font-bold dark:text-white` | `font-size: 1.875rem; font-weight: 700; color: #000;` | `color: #fff;` |-| `h2` | `text-xl font-bold dark:text-white` | `font-size: 1.25rem; font-weight: 700; color: #000;` | `color: #fff;` |-| `h3` | `text-lg font-bold dark:text-white` | `font-size: 1.125rem; font-weight: 700; color: #000;` | `color: #fff;` |-| `h4` | `text-base font-bold dark:text-white` | `font-size: 1rem; font-weight: 700; color: #000;` | `color: #fff;` |--#### Body Text--| Context | Tailwind | Plain CSS |-|---|---|---|-| Body default | `text-sm antialiased` | `font-size: 0.875rem; line-height: 1.25rem; -webkit-font-smoothing: antialiased;` |-| Labels | `text-sm font-medium` | `font-size: 0.875rem; font-weight: 500;` |-| Badge/status text | `text-xs font-bold` | `font-size: 0.75rem; line-height: 1rem; font-weight: 700;` |-| Box description | `text-xs font-bold text-neutral-500` | `font-size: 0.75rem; font-weight: 700; color: #737373;` |--### 1.3 Spacing Patterns--| Context | Value | CSS |-|---|---|---|-| Component internal padding | `p-2` | `padding: 0.5rem;` |-| Callout padding | `p-4` | `padding: 1rem;` |-| Input vertical padding | `py-1.5` | `padding-top: 0.375rem; padding-bottom: 0.375rem;` |-| Button height | `h-8` | `height: 2rem;` |-| Button horizontal padding | `px-2` | `padding-left: 0.5rem; padding-right: 0.5rem;` |-| Button gap | `gap-2` | `gap: 0.5rem;` |-| Menu item padding | `px-2 py-1` | `padding: 0.25rem 0.5rem;` |-| Menu item gap | `gap-3` | `gap: 0.75rem;` |-| Section margin | `mb-12` | `margin-bottom: 3rem;` |-| Card min-height | `min-h-[4rem]` | `min-height: 4rem;` |--### 1.4 Border Radius--| Context | Tailwind | Plain CSS |-|---|---|---|-| Default (inputs, buttons, cards, modals) | `rounded-sm` | `border-radius: 0.125rem;` |-| Callouts | `rounded-lg` | `border-radius: 0.5rem;` |-| Badges | `rounded-full` | `border-radius: 9999px;` |-| Cards (coolbox variant) | `rounded` | `border-radius: 0.25rem;` |--### 1.5 Shadows--#### Input / Select Box-Shadow System--Coolify uses **inset box-shadows instead of borders** for inputs and selects. This enables a unique "dirty indicator" — a colored left-edge bar.--```css-/* Default state */-box-shadow: inset 4px 0 0 transparent, inset 0 0 0 2px #e5e5e5;--/* Default state (dark) */-box-shadow: inset 4px 0 0 transparent, inset 0 0 0 2px #242424;--/* Focus state (light) — purple left bar */-box-shadow: inset 4px 0 0 #6b16ed, inset 0 0 0 2px #e5e5e5;--/* Focus state (dark) — yellow left bar */-box-shadow: inset 4px 0 0 #fcd452, inset 0 0 0 2px #242424;--/* Dirty (modified) state — same as focus */-box-shadow: inset 4px 0 0 #6b16ed, inset 0 0 0 2px #e5e5e5; /* light */-box-shadow: inset 4px 0 0 #fcd452, inset 0 0 0 2px #242424; /* dark */--/* Disabled / Readonly */-box-shadow: none;-```--#### Input-Sticky Variant (thinner border)--```css-/* Uses 1px border instead of 2px */-box-shadow: inset 4px 0 0 transparent, inset 0 0 0 1px #e5e5e5;-```--### 1.6 Focus Ring System--All interactive elements (buttons, links, checkboxes) share this focus pattern:--**Tailwind:**-```-focus-visible:outline-none focus-visible:ring-2 focus-visible:ring-coollabs dark:focus-visible:ring-warning focus-visible:ring-offset-2 dark:focus-visible:ring-offset-base-```--**Plain CSS:**-```css-:focus-visible {- outline: none;- box-shadow: 0 0 0 2px #101010, 0 0 0 4px #6b16ed; /* light */-}--/* dark mode */-.dark :focus-visible {- box-shadow: 0 0 0 2px #101010, 0 0 0 4px #fcd452;-}-```--> **Note**: Inputs use the inset box-shadow system (section 1.5) instead of the ring system.-------## 2. Dark Mode Strategy--- **Toggle method**: Class-based — `.dark` class on `<html>` element-- **CSS variant**: `@custom-variant dark (&:where(.dark, .dark *));`-- **Default border override**: All elements default to `border-color: var(--color-coolgray-200)` (`#202020`) instead of `currentcolor`--### Accent Color Swap--| Context | Light | Dark |-|---|---|---|-| Primary accent | `coollabs` (`#6b16ed`) | `warning` (`#fcd452`) |-| Focus ring | `ring-coollabs` | `ring-warning` |-| Input focus bar | `#6b16ed` (purple) | `#fcd452` (yellow) |-| Active nav text | `text-black` | `text-warning` |-| Helper/highlight text | `text-coollabs` | `text-warning` |-| Loading spinner | `text-coollabs` | `text-warning` |-| Scrollbar thumb | `coollabs-100` | `coollabs-100` |--### Background Hierarchy (dark)--```-#101010 (base) — page background- └─ #181818 (coolgray-100) — cards, inputs, components- └─ #202020 (coolgray-200) — elevated surfaces, borders, nav active- └─ #242424 (coolgray-300) — input borders (via box-shadow), button borders- └─ #282828 (coolgray-400) — tooltips, hover states- └─ #323232 (coolgray-500) — subtle overlays-```--### Background Hierarchy (light)--```-#f9fafb (gray-50) — page background- └─ #ffffff (white) — cards, inputs, components- └─ #e5e5e5 (neutral-200) — borders- └─ #f5f5f5 (neutral-100) — hover backgrounds- └─ #d4d4d4 (neutral-300) — deeper hover, nav active-```-------## 3. Component Catalog--### 3.1 Button--#### Default--**Tailwind:**-```-flex gap-2 justify-center items-center px-2 h-8 text-sm text-black normal-case rounded-sm-border-2 outline-0 cursor-pointer font-medium bg-white border-neutral-200 hover:bg-neutral-100-dark:bg-coolgray-100 dark:text-white dark:hover:text-white dark:hover:bg-coolgray-200-dark:border-coolgray-300 hover:text-black disabled:cursor-not-allowed min-w-fit-dark:disabled:text-neutral-600 disabled:border-transparent disabled:hover:bg-transparent-disabled:bg-transparent disabled:text-neutral-300-focus-visible:outline-none focus-visible:ring-2 focus-visible:ring-coollabs-dark:focus-visible:ring-warning focus-visible:ring-offset-2 dark:focus-visible:ring-offset-base-```--**Plain CSS:**-```css-.button {- display: flex;- gap: 0.5rem;- justify-content: center;- align-items: center;- padding: 0 0.5rem;- height: 2rem;- font-size: 0.875rem;- font-weight: 500;- text-transform: none;- color: #000;- background: #fff;- border: 2px solid #e5e5e5;- border-radius: 0.125rem;- outline: 0;- cursor: pointer;- min-width: fit-content;-}-.button:hover { background: #f5f5f5; }--/* Dark */-.dark .button {- background: #181818;- color: #fff;- border-color: #242424;-}-.dark .button:hover {- background: #202020;- color: #fff;-}--/* Disabled */-.button:disabled {- cursor: not-allowed;- border-color: transparent;- background: transparent;- color: #d4d4d4;-}-.dark .button:disabled { color: #525252; }-```--#### Highlighted (Primary Action)--**Tailwind** (via `isHighlighted` attribute):-```-text-coollabs-200 dark:text-white bg-coollabs-50 dark:bg-coollabs/20-border-coollabs dark:border-coollabs-100 hover:bg-coollabs hover:text-white-dark:hover:bg-coollabs-100 dark:hover:text-white-```--**Plain CSS:**-```css-.button-highlighted {- color: #5a12c7;- background: #f5f0ff;- border-color: #6b16ed;-}-.button-highlighted:hover {- background: #6b16ed;- color: #fff;-}-.dark .button-highlighted {- color: #fff;- background: rgba(107, 22, 237, 0.2);- border-color: #7317ff;-}-.dark .button-highlighted:hover {- background: #7317ff;- color: #fff;-}-```--#### Error / Danger--**Tailwind** (via `isError` attribute):-```-text-red-800 dark:text-red-300 bg-red-50 dark:bg-red-900/30-border-red-300 dark:border-red-800 hover:bg-red-300 hover:text-white-dark:hover:bg-red-800 dark:hover:text-white-```--**Plain CSS:**-```css-.button-error {- color: #991b1b;- background: #fef2f2;- border-color: #fca5a5;-}-.button-error:hover {- background: #fca5a5;- color: #fff;-}-.dark .button-error {- color: #fca5a5;- background: rgba(127, 29, 29, 0.3);- border-color: #991b1b;-}-.dark .button-error:hover {- background: #991b1b;- color: #fff;-}-```--#### Loading Indicator--Buttons automatically show a spinner (SVG with `animate-spin`) next to their content during async operations. The spinner uses the accent color (`text-coollabs` / `text-warning`).-------### 3.2 Input--**Tailwind:**-```-block py-1.5 w-full text-sm text-black rounded-sm border-0-dark:bg-coolgray-100 dark:text-white-disabled:bg-neutral-200 disabled:text-neutral-500 dark:disabled:bg-coolgray-100/40-dark:read-only:text-neutral-500 dark:read-only:bg-coolgray-100/40-placeholder:text-neutral-300 dark:placeholder:text-neutral-700-read-only:text-neutral-500 read-only:bg-neutral-200-focus-visible:outline-none-```--**Plain CSS:**-```css-.input {- display: block;- padding: 0.375rem 0.5rem;- width: 100%;- font-size: 0.875rem;- color: #000;- background: #fff;- border: 0;- border-radius: 0.125rem;- box-shadow: inset 4px 0 0 transparent, inset 0 0 0 2px #e5e5e5;-}-.input:focus-visible {- outline: none;- box-shadow: inset 4px 0 0 #6b16ed, inset 0 0 0 2px #e5e5e5;-}-.input::placeholder { color: #d4d4d4; }-.input:disabled { background: #e5e5e5; color: #737373; box-shadow: none; }-.input:read-only { color: #737373; background: #e5e5e5; box-shadow: none; }-.input[type="password"] { padding-right: 2.4rem; }--/* Dark */-.dark .input {- background: #181818;- color: #fff;- box-shadow: inset 4px 0 0 transparent, inset 0 0 0 2px #242424;-}-.dark .input:focus-visible {- box-shadow: inset 4px 0 0 #fcd452, inset 0 0 0 2px #242424;-}-.dark .input::placeholder { color: #404040; }-.dark .input:disabled { background: rgba(24, 24, 24, 0.4); box-shadow: none; }-.dark .input:read-only { color: #737373; background: rgba(24, 24, 24, 0.4); box-shadow: none; }-```--#### Dirty (Modified) State--When an input value has been changed but not saved, a 4px colored left bar appears via box-shadow — same colors as focus state. This provides a visual indicator that the field has unsaved changes.-------### 3.3 Select--Same base styles as Input, plus a custom dropdown arrow SVG:--**Tailwind:**-```-w-full block py-1.5 text-sm text-black rounded-sm border-0-dark:bg-coolgray-100 dark:text-white-disabled:bg-neutral-200 disabled:text-neutral-500 dark:disabled:bg-coolgray-100/40-focus-visible:outline-none-```--**Additional plain CSS for the dropdown arrow:**-```css-.select {- /* ...same as .input base... */- background-image: url("data:image/svg+xml,%3csvg xmlns='http://www.w3.org/2000/svg' fill='none' viewBox='0 0 24 24' stroke-width='1.5' stroke='%23000000'%3e%3cpath stroke-linecap='round' stroke-linejoin='round' d='M8.25 15L12 18.75 15.75 15m-7.5-6L12 5.25 15.75 9'/%3e%3c/svg%3e");- background-position: right 0.5rem center;- background-repeat: no-repeat;- background-size: 1rem 1rem;- padding-right: 2.5rem;- appearance: none;-}--/* Dark mode: white stroke arrow */-.dark .select {- background-image: url("data:image/svg+xml,%3csvg xmlns='http://www.w3.org/2000/svg' fill='none' viewBox='0 0 24 24' stroke-width='1.5' stroke='%23ffffff'%3e%3cpath stroke-linecap='round' stroke-linejoin='round' d='M8.25 15L12 18.75 15.75 15m-7.5-6L12 5.25 15.75 9'/%3e%3c/svg%3e");-}-```-------### 3.4 Checkbox--**Tailwind:**-```-dark:border-neutral-700 text-coolgray-400 dark:bg-coolgray-100 rounded-sm cursor-pointer-dark:disabled:bg-base dark:disabled:cursor-not-allowed-focus-visible:outline-none focus-visible:ring-2 focus-visible:ring-coollabs-dark:focus-visible:ring-warning focus-visible:ring-offset-2 dark:focus-visible:ring-offset-base-```--**Container:**-```-flex flex-row items-center gap-4 pr-2 py-1 form-control min-w-fit-dark:hover:bg-coolgray-100 cursor-pointer-```--**Plain CSS:**-```css-.checkbox {- border-color: #404040;- color: #282828;- background: #181818;- border-radius: 0.125rem;- cursor: pointer;-}-.checkbox:focus-visible {- outline: none;- box-shadow: 0 0 0 2px #101010, 0 0 0 4px #fcd452;-}--.checkbox-container {- display: flex;- flex-direction: row;- align-items: center;- gap: 1rem;- padding: 0.25rem 0.5rem 0.25rem 0;- min-width: fit-content;- cursor: pointer;-}-.dark .checkbox-container:hover { background: #181818; }-```-------### 3.5 Textarea--Uses `font-mono` for monospace text. Supports tab key insertion (2 spaces).--**Important**: Large/multiline textareas should NOT use the inset box-shadow left-border system from `.input`. Use a simple border instead:--**Tailwind:**-```-block w-full text-sm text-black rounded-sm border border-neutral-200-dark:bg-coolgray-100 dark:text-white dark:border-coolgray-300-font-mono focus-visible:outline-none focus-visible:ring-2-focus-visible:ring-coollabs dark:focus-visible:ring-warning-focus-visible:ring-offset-2 dark:focus-visible:ring-offset-base-```--**Plain CSS:**-```css-.textarea {- display: block;- width: 100%;- font-size: 0.875rem;- font-family: ui-monospace, SFMono-Regular, Menlo, Monaco, Consolas, monospace;- color: #000;- background: #fff;- border: 1px solid #e5e5e5;- border-radius: 0.125rem;-}-.textarea:focus-visible {- outline: none;- box-shadow: 0 0 0 2px #fff, 0 0 0 4px #6b16ed;-}-.dark .textarea {- background: #181818;- color: #fff;- border-color: #242424;-}-.dark .textarea:focus-visible {- box-shadow: 0 0 0 2px #101010, 0 0 0 4px #fcd452;-}-```--> **Note**: The 4px inset left-border (dirty/focus indicator) is only for single-line inputs and selects, not textareas.-------### 3.6 Box / Card--#### Standard Box--**Tailwind:**-```-relative flex lg:flex-row flex-col p-2 transition-colors cursor-pointer min-h-[4rem]-dark:bg-coolgray-100 shadow-sm bg-white border text-black dark:text-white hover:text-black-border-neutral-200 dark:border-coolgray-300 hover:bg-neutral-100-dark:hover:bg-coollabs-100 dark:hover:text-white hover:no-underline rounded-sm-```--**Plain CSS:**-```css-.box {- position: relative;- display: flex;- flex-direction: column;- padding: 0.5rem;- min-height: 4rem;- background: #fff;- border: 1px solid #e5e5e5;- border-radius: 0.125rem;- box-shadow: 0 1px 2px 0 rgba(0, 0, 0, 0.05);- color: #000;- cursor: pointer;- transition: background-color 150ms, color 150ms;- text-decoration: none;-}-.box:hover { background: #f5f5f5; color: #000; }--.dark .box {- background: #181818;- border-color: #242424;- color: #fff;-}-.dark .box:hover {- background: #7317ff;- color: #fff;-}--/* IMPORTANT: child text must also turn white/black on hover,- since description text (#737373) is invisible on purple bg */-.box:hover .box-title { color: #000; }-.box:hover .box-description { color: #000; }-.dark .box:hover .box-title { color: #fff; }-.dark .box:hover .box-description { color: #fff; }--/* Desktop: row layout */-@media (min-width: 1024px) {- .box { flex-direction: row; }-}-```--#### Coolbox (Ring Hover)--**Tailwind:**-```-relative flex transition-all duration-150 dark:bg-coolgray-100 bg-white p-2 rounded-border border-neutral-200 dark:border-coolgray-400 hover:ring-2-dark:hover:ring-warning hover:ring-coollabs cursor-pointer min-h-[4rem]-```--**Plain CSS:**-```css-.coolbox {- position: relative;- display: flex;- padding: 0.5rem;- min-height: 4rem;- background: #fff;- border: 1px solid #e5e5e5;- border-radius: 0.25rem;- cursor: pointer;- transition: all 150ms;-}-.coolbox:hover { box-shadow: 0 0 0 2px #6b16ed; }--.dark .coolbox {- background: #181818;- border-color: #282828;-}-.dark .coolbox:hover { box-shadow: 0 0 0 2px #fcd452; }-```--#### Box Text--> **IMPORTANT — Dark mode titles**: Card/box titles MUST be `#fff` (white) in dark mode, not the default body text color (`#a3a3a3` / neutral-400). A black or grey title is nearly invisible on dark backgrounds (`#181818`). This applies to all heading-level text inside cards.--```css-.box-title {- font-weight: 700;- color: #000; /* light mode: black */-}-.dark .box-title {- color: #fff; /* dark mode: MUST be white, not grey */-}--.box-description {- font-size: 0.75rem;- font-weight: 700;- color: #737373;-}-/* On hover: description must become visible against colored bg */-.box:hover .box-description { color: #000; }-.dark .box:hover .box-description { color: #fff; }-```-------### 3.7 Badge / Status Indicator--**Tailwind:**-```-inline-block w-3 h-3 text-xs font-bold rounded-full leading-none-border border-neutral-200 dark:border-black-```--**Variants**: `badge-success` (`bg-success`), `badge-warning` (`bg-warning`), `badge-error` (`bg-error`)--**Plain CSS:**-```css-.badge {- display: inline-block;- width: 0.75rem;- height: 0.75rem;- border-radius: 9999px;- border: 1px solid #e5e5e5;-}-.dark .badge { border-color: #000; }--.badge-success { background: #22C55E; }-.badge-warning { background: #fcd452; }-.badge-error { background: #dc2626; }-```--#### Status Text Pattern--Status indicators combine a badge dot with text:--```html-<div style="display: flex; align-items: center;">- <div class="badge badge-success"></div>- <div style="padding-left: 0.5rem; font-size: 0.75rem; font-weight: 700; color: #22C55E;">- Running- </div>-</div>-```--| Status | Badge Class | Text Color |-|---|---|---|-| Running | `badge-success` | `text-success` (`#22C55E`) |-| Stopped | `badge-error` | `text-error` (`#dc2626`) |-| Degraded | `badge-warning` | `dark:text-warning` (`#fcd452`) |-| Restarting | `badge-warning` | `dark:text-warning` (`#fcd452`) |-------### 3.8 Dropdown--**Container Tailwind:**-```-p-1 mt-1 bg-white border rounded-sm shadow-sm-dark:bg-coolgray-200 dark:border-coolgray-300 border-neutral-300-```--**Item Tailwind:**-```-flex relative gap-2 justify-start items-center py-1 pr-4 pl-2 w-full text-xs-transition-colors cursor-pointer select-none dark:text-white-hover:bg-neutral-100 dark:hover:bg-coollabs-outline-none focus-visible:bg-neutral-100 dark:focus-visible:bg-coollabs-```--**Plain CSS:**-```css-.dropdown {- padding: 0.25rem;- margin-top: 0.25rem;- background: #fff;- border: 1px solid #d4d4d4;- border-radius: 0.125rem;- box-shadow: 0 1px 2px 0 rgba(0, 0, 0, 0.05);-}-.dark .dropdown {- background: #202020;- border-color: #242424;-}--.dropdown-item {- display: flex;- position: relative;- gap: 0.5rem;- justify-content: flex-start;- align-items: center;- padding: 0.25rem 1rem 0.25rem 0.5rem;- width: 100%;- font-size: 0.75rem;- cursor: pointer;- user-select: none;- transition: background-color 150ms;-}-.dropdown-item:hover { background: #f5f5f5; }-.dark .dropdown-item { color: #fff; }-.dark .dropdown-item:hover { background: #6b16ed; }-```-------### 3.9 Sidebar / Navigation--#### Sidebar Container + Page Layout--The navbar is a **fixed left sidebar** (14rem / 224px wide on desktop), with main content offset to the right.--**Tailwind (sidebar wrapper — desktop):**-```-hidden lg:fixed lg:inset-y-0 lg:z-50 lg:flex lg:w-56 lg:flex-col min-w-0-```--**Tailwind (sidebar inner — scrollable):**-```-flex flex-col overflow-y-auto grow gap-y-5 scrollbar min-w-0-```--**Tailwind (nav element):**-```-flex flex-col flex-1 px-2 bg-white border-r dark:border-coolgray-200 border-neutral-300 dark:bg-base-```--**Tailwind (main content area):**-```-lg:pl-56-```--**Tailwind (main content padding):**-```-p-4 sm:px-6 lg:px-8 lg:py-6-```--**Tailwind (mobile top bar — shown on small screens, hidden on lg+):**-```-sticky top-0 z-40 flex items-center justify-between px-4 py-4 gap-x-6 sm:px-6 lg:hidden-bg-white/95 dark:bg-base/95 backdrop-blur-sm border-b border-neutral-300/50 dark:border-coolgray-200/50-```--**Tailwind (mobile hamburger icon):**-```--m-2.5 p-2.5 dark:text-warning-```--**Plain CSS:**-```css-/* Sidebar — desktop only */-.sidebar {- display: none;-}-@media (min-width: 1024px) {- .sidebar {- display: flex;- flex-direction: column;- position: fixed;- top: 0;- bottom: 0;- left: 0;- z-index: 50;- width: 14rem; /* 224px */- min-width: 0;- }-}--.sidebar-inner {- display: flex;- flex-direction: column;- flex-grow: 1;- overflow-y: auto;- gap: 1.25rem;- min-width: 0;-}--/* Nav element */-.sidebar-nav {- display: flex;- flex-direction: column;- flex: 1;- padding: 0 0.5rem;- background: #fff;- border-right: 1px solid #d4d4d4;-}-.dark .sidebar-nav {- background: #101010;- border-right-color: #202020;-}--/* Main content offset */-@media (min-width: 1024px) {- .main-content { padding-left: 14rem; }-}--.main-content-inner {- padding: 1rem;-}-@media (min-width: 640px) {- .main-content-inner { padding: 1rem 1.5rem; }-}-@media (min-width: 1024px) {- .main-content-inner { padding: 1.5rem 2rem; }-}--/* Mobile top bar — visible below lg breakpoint */-.mobile-topbar {- position: sticky;- top: 0;- z-index: 40;- display: flex;- align-items: center;- justify-content: space-between;- padding: 1rem;- gap: 1.5rem;- background: rgba(255, 255, 255, 0.95);- backdrop-filter: blur(12px);- border-bottom: 1px solid rgba(212, 212, 212, 0.5);-}-.dark .mobile-topbar {- background: rgba(16, 16, 16, 0.95);- border-bottom-color: rgba(32, 32, 32, 0.5);-}-@media (min-width: 1024px) {- .mobile-topbar { display: none; }-}--/* Mobile sidebar overlay (shown when hamburger is tapped) */-.sidebar-mobile {- position: relative;- display: flex;- flex: 1;- width: 100%;- max-width: 14rem;- min-width: 0;-}-.sidebar-mobile-scroll {- display: flex;- flex-direction: column;- padding-bottom: 0.5rem;- overflow-y: auto;- min-width: 14rem;- gap: 1.25rem;- min-width: 0;-}-.dark .sidebar-mobile-scroll { background: #181818; }-```--#### Sidebar Header (Logo + Search)--**Tailwind:**-```-flex lg:pt-6 pt-4 pb-4 pl-2-```--**Logo:**-```-text-2xl font-bold tracking-wide dark:text-white hover:opacity-80 transition-opacity-```--**Search button:**-```-flex items-center gap-1.5 px-2.5 py-1.5-bg-neutral-100 dark:bg-coolgray-100-border border-neutral-300 dark:border-coolgray-200-rounded-md hover:bg-neutral-200 dark:hover:bg-coolgray-200 transition-colors-```--**Search kbd hint:**-```-px-1 py-0.5 text-xs font-semibold-text-neutral-500 dark:text-neutral-400-bg-neutral-200 dark:bg-coolgray-200 rounded-```--**Plain CSS:**-```css-.sidebar-header {- display: flex;- padding: 1rem 0 1rem 0.5rem;-}-@media (min-width: 1024px) {- .sidebar-header { padding-top: 1.5rem; }-}--.sidebar-logo {- font-size: 1.5rem;- font-weight: 700;- letter-spacing: 0.025em;- color: #000;- text-decoration: none;-}-.dark .sidebar-logo { color: #fff; }-.sidebar-logo:hover { opacity: 0.8; }--.sidebar-search-btn {- display: flex;- align-items: center;- gap: 0.375rem;- padding: 0.375rem 0.625rem;- background: #f5f5f5;- border: 1px solid #d4d4d4;- border-radius: 0.375rem;- cursor: pointer;- transition: background-color 150ms;-}-.sidebar-search-btn:hover { background: #e5e5e5; }-.dark .sidebar-search-btn {- background: #181818;- border-color: #202020;-}-.dark .sidebar-search-btn:hover { background: #202020; }--.sidebar-search-kbd {- padding: 0.125rem 0.25rem;- font-size: 0.75rem;- font-weight: 600;- color: #737373;- background: #e5e5e5;- border-radius: 0.25rem;-}-.dark .sidebar-search-kbd {- color: #a3a3a3;- background: #202020;-}-```--#### Menu Item List--**Tailwind (list container):**-```-flex flex-col flex-1 gap-y-7-```--**Tailwind (inner list):**-```-flex flex-col h-full space-y-1.5-```--**Plain CSS:**-```css-.menu-list {- display: flex;- flex-direction: column;- flex: 1;- gap: 1.75rem;- list-style: none;- padding: 0;- margin: 0;-}--.menu-list-inner {- display: flex;- flex-direction: column;- height: 100%;- gap: 0.375rem;- list-style: none;- padding: 0;- margin: 0;-}-```--#### Menu Item--**Tailwind:**-```-flex gap-3 items-center px-2 py-1 w-full text-sm-dark:hover:bg-coolgray-100 dark:hover:text-white hover:bg-neutral-300 rounded-sm truncate min-w-0-```--#### Menu Item Active--**Tailwind:**-```-text-black rounded-sm dark:bg-coolgray-200 dark:text-warning bg-neutral-200 overflow-hidden-```--#### Menu Item Icon / Label--```-/* Icon */ flex-shrink-0 w-6 h-6 dark:hover:text-white-/* Label */ min-w-0 flex-1 truncate-```--**Plain CSS:**-```css-.menu-item {- display: flex;- gap: 0.75rem;- align-items: center;- padding: 0.25rem 0.5rem;- width: 100%;- font-size: 0.875rem;- border-radius: 0.125rem;- overflow: hidden;- text-overflow: ellipsis;- white-space: nowrap;-}-.menu-item:hover { background: #d4d4d4; }-.dark .menu-item:hover { background: #181818; color: #fff; }--.menu-item-active {- color: #000;- background: #e5e5e5;- border-radius: 0.125rem;-}-.dark .menu-item-active {- background: #202020;- color: #fcd452;-}--.menu-item-icon {- flex-shrink: 0;- width: 1.5rem;- height: 1.5rem;-}--.menu-item-label {- min-width: 0;- flex: 1;- overflow: hidden;- text-overflow: ellipsis;- white-space: nowrap;-}-```--#### Sub-Menu Item--```css-.sub-menu-item {- /* Same as menu-item but with gap: 0.5rem and icon size 1rem */- display: flex;- gap: 0.5rem;- align-items: center;- padding: 0.25rem 0.5rem;- width: 100%;- font-size: 0.875rem;- border-radius: 0.125rem;-}-.sub-menu-item-icon { flex-shrink: 0; width: 1rem; height: 1rem; }-```-------### 3.10 Callout / Alert--Four types: `warning`, `danger`, `info`, `success`.--**Structure:**-```html-<div class="callout callout-{type}">- <div class="callout-icon"><!-- SVG --></div>- <div class="callout-body">- <div class="callout-title">Title</div>- <div class="callout-text">Content</div>- </div>-</div>-```--**Base Tailwind:**-```-relative p-4 border rounded-lg-```--**Type Colors:**--| Type | Background | Border | Title Text | Body Text |-|---|---|---|---|---|-| **warning** | `bg-warning-50 dark:bg-warning-900/30` | `border-warning-300 dark:border-warning-800` | `text-warning-800 dark:text-warning-300` | `text-warning-700 dark:text-warning-200` |-| **danger** | `bg-red-50 dark:bg-red-900/30` | `border-red-300 dark:border-red-800` | `text-red-800 dark:text-red-300` | `text-red-700 dark:text-red-200` |-| **info** | `bg-blue-50 dark:bg-blue-900/30` | `border-blue-300 dark:border-blue-800` | `text-blue-800 dark:text-blue-300` | `text-blue-700 dark:text-blue-200` |-| **success** | `bg-green-50 dark:bg-green-900/30` | `border-green-300 dark:border-green-800` | `text-green-800 dark:text-green-300` | `text-green-700 dark:text-green-200` |--**Plain CSS (warning example):**-```css-.callout {- position: relative;- padding: 1rem;- border: 1px solid;- border-radius: 0.5rem;-}--.callout-warning {- background: #fefce8;- border-color: #fde047;-}-.dark .callout-warning {- background: rgba(113, 63, 18, 0.3);- border-color: #854d0e;-}--.callout-title {- font-size: 1rem;- font-weight: 700;-}-.callout-warning .callout-title { color: #854d0e; }-.dark .callout-warning .callout-title { color: #fde047; }--.callout-text {- margin-top: 0.5rem;- font-size: 0.875rem;-}-.callout-warning .callout-text { color: #a16207; }-.dark .callout-warning .callout-text { color: #fef08a; }-```--**Icon colors per type:**-- Warning: `text-warning-600 dark:text-warning-400` (`#ca8a04` / `#fcd452`)-- Danger: `text-red-600 dark:text-red-400` (`#dc2626` / `#f87171`)-- Info: `text-blue-600 dark:text-blue-400` (`#2563eb` / `#60a5fa`)-- Success: `text-green-600 dark:text-green-400` (`#16a34a` / `#4ade80`)-------### 3.11 Toast / Notification--**Container Tailwind:**-```-relative flex flex-col items-start-shadow-[0_5px_15px_-3px_rgb(0_0_0_/_0.08)]-w-full transition-all duration-100 ease-out-dark:bg-coolgray-100 bg-white-dark:border dark:border-coolgray-200-rounded-sm sm:max-w-xs-```--**Plain CSS:**-```css-.toast {- position: relative;- display: flex;- flex-direction: column;- align-items: flex-start;- width: 100%;- max-width: 20rem;- background: #fff;- border-radius: 0.125rem;- box-shadow: 0 5px 15px -3px rgba(0, 0, 0, 0.08);- transition: all 100ms ease-out;-}-.dark .toast {- background: #181818;- border: 1px solid #202020;-}-```--**Icon colors per toast type:**--| Type | Color | Hex |-|---|---|---|-| Success | `text-green-500` | `#22c55e` |-| Info | `text-blue-500` | `#3b82f6` |-| Warning | `text-orange-400` | `#fb923c` |-| Danger | `text-red-500` | `#ef4444` |--**Behavior**: Stacks up to 4 toasts, auto-dismisses after 4 seconds, positioned bottom-right.-------### 3.12 Modal--**Tailwind (dialog-based):**-```-rounded-sm modal-box max-h-[calc(100vh-5rem)] flex flex-col-```--**Modal Input variant container:**-```-relative w-full lg:w-auto lg:min-w-2xl lg:max-w-4xl-border rounded-sm drop-shadow-sm-bg-white border-neutral-200-dark:bg-base dark:border-coolgray-300-flex flex-col-```--**Modal Confirmation container:**-```-relative w-full border rounded-sm-min-w-full lg:min-w-[36rem] max-w-[48rem]-max-h-[calc(100vh-2rem)]-bg-neutral-100 border-neutral-400-dark:bg-base dark:border-coolgray-300-flex flex-col-```--**Plain CSS:**-```css-.modal-box {- border-radius: 0.125rem;- max-height: calc(100vh - 5rem);- display: flex;- flex-direction: column;-}--.modal-input {- position: relative;- width: 100%;- border: 1px solid #e5e5e5;- border-radius: 0.125rem;- filter: drop-shadow(0 1px 1px rgba(0, 0, 0, 0.05));- background: #fff;- display: flex;- flex-direction: column;-}-.dark .modal-input {- background: #101010;- border-color: #242424;-}--/* Desktop sizing */-@media (min-width: 1024px) {- .modal-input {- width: auto;- min-width: 42rem;- max-width: 56rem;- }-}-```--**Modal header:**-```css-.modal-header {- display: flex;- align-items: center;- justify-content: space-between;- padding: 1.5rem;- flex-shrink: 0;-}-.modal-header h3 {- font-size: 1.5rem;- font-weight: 700;-}-```--**Close button:**-```css-.modal-close {- width: 2rem;- height: 2rem;- border-radius: 9999px;- color: #fff;-}-.modal-close:hover { background: #242424; }-```-------### 3.13 Slide-Over Panel--**Tailwind:**-```-fixed inset-y-0 right-0 flex max-w-full pl-10-```--**Inner panel:**-```-max-w-xl w-screen-flex flex-col h-full py-6-border-l shadow-lg-bg-neutral-50 dark:bg-base-dark:border-neutral-800 border-neutral-200-```--**Plain CSS:**-```css-.slide-over {- position: fixed;- top: 0;- bottom: 0;- right: 0;- display: flex;- max-width: 100%;- padding-left: 2.5rem;-}--.slide-over-panel {- max-width: 36rem;- width: 100vw;- display: flex;- flex-direction: column;- height: 100%;- padding: 1.5rem 0;- border-left: 1px solid #e5e5e5;- box-shadow: -10px 0 15px -3px rgba(0, 0, 0, 0.1);- background: #fafafa;-}-.dark .slide-over-panel {- background: #101010;- border-color: #262626;-}-```-------### 3.14 Tag--**Tailwind:**-```-px-2 py-1 cursor-pointer text-xs font-bold text-neutral-500-dark:bg-coolgray-100 dark:hover:bg-coolgray-300 bg-neutral-100 hover:bg-neutral-200-```--**Plain CSS:**-```css-.tag {- padding: 0.25rem 0.5rem;- font-size: 0.75rem;- font-weight: 700;- color: #737373;- background: #f5f5f5;- cursor: pointer;-}-.tag:hover { background: #e5e5e5; }-.dark .tag { background: #181818; }-.dark .tag:hover { background: #242424; }-```-------### 3.15 Loading Spinner--**Tailwind:**-```-w-4 h-4 text-coollabs dark:text-warning animate-spin-```--**Plain CSS + SVG:**-```css-.loading-spinner {- width: 1rem;- height: 1rem;- color: #6b16ed;- animation: spin 1s linear infinite;-}-.dark .loading-spinner { color: #fcd452; }--@keyframes spin {- from { transform: rotate(0deg); }- to { transform: rotate(360deg); }-}-```--**SVG structure:**-```html-<svg class="loading-spinner" viewBox="0 0 24 24" fill="none">- <circle cx="12" cy="12" r="10" stroke="currentColor" stroke-width="4" opacity="0.25"/>- <path fill="currentColor" opacity="0.75" d="M4 12a8 8 0 018-8V0C5.373 0 0 5.373 0 12h4z"/>-</svg>-```-------### 3.16 Helper / Tooltip--**Tailwind (trigger icon):**-```-cursor-pointer text-coollabs dark:text-warning-```--**Tailwind (popup):**-```-hidden absolute z-40 text-xs rounded-sm text-neutral-700 group-hover:block-dark:border-coolgray-500 border-neutral-900 dark:bg-coolgray-400 bg-neutral-200-dark:text-neutral-300 max-w-sm whitespace-normal break-words-```--**Plain CSS:**-```css-.helper-icon {- cursor: pointer;- color: #6b16ed;-}-.dark .helper-icon { color: #fcd452; }--.helper-popup {- display: none;- position: absolute;- z-index: 40;- font-size: 0.75rem;- border-radius: 0.125rem;- color: #404040;- background: #e5e5e5;- max-width: 24rem;- white-space: normal;- word-break: break-word;- padding: 1rem;-}-.dark .helper-popup {- background: #282828;- color: #d4d4d4;- border: 1px solid #323232;-}--/* Show on parent hover */-.helper:hover .helper-popup { display: block; }-```-------### 3.17 Highlighted Text--**Tailwind:**-```-inline-block font-bold text-coollabs dark:text-warning-```--**Plain CSS:**-```css-.text-highlight {- display: inline-block;- font-weight: 700;- color: #6b16ed;-}-.dark .text-highlight { color: #fcd452; }-```-------### 3.18 Scrollbar--**Tailwind:**-```-scrollbar-thumb-coollabs-100 scrollbar-track-neutral-200-dark:scrollbar-track-coolgray-200 scrollbar-thin-```--**Plain CSS:**-```css-::-webkit-scrollbar { width: 6px; height: 6px; }-::-webkit-scrollbar-track { background: #e5e5e5; }-::-webkit-scrollbar-thumb { background: #7317ff; }-.dark ::-webkit-scrollbar-track { background: #202020; }-```-------### 3.19 Table--**Plain CSS:**-```css-table { min-width: 100%; border-collapse: separate; }-table, tbody { border-bottom: 1px solid #d4d4d4; }-.dark table, .dark tbody { border-color: #202020; }--thead { text-transform: uppercase; }--tr { color: #000; }-tr:hover { background: #e5e5e5; }-.dark tr { color: #a3a3a3; }-.dark tr:hover { background: #000; }--th {- padding: 0.875rem 0.75rem;- text-align: left;- color: #000;-}-.dark th { color: #fff; }-th:first-child { padding-left: 1.5rem; }--td { padding: 1rem 0.75rem; white-space: nowrap; }-td:first-child { padding-left: 1.5rem; font-weight: 700; }-```-------### 3.20 Keyboard Shortcut Indicator--**Tailwind:**-```-px-2 text-xs rounded-sm border border-dashed border-neutral-700 dark:text-warning-```--**Plain CSS:**-```css-.kbd {- padding: 0 0.5rem;- font-size: 0.75rem;- border-radius: 0.125rem;- border: 1px dashed #404040;-}-.dark .kbd { color: #fcd452; }-```-------## 4. Base Element Styles--These global styles are applied to all HTML elements:--```css-/* Page */-html, body {- width: 100%;- min-height: 100%;- background: #f9fafb;- font-family: Inter, sans-serif;-}-.dark html, .dark body {- background: #101010;- color: #a3a3a3;-}--body {- min-height: 100vh;- font-size: 0.875rem;- -webkit-font-smoothing: antialiased;- overflow-x: hidden;-}--/* Links */-a:hover { color: #000; }-.dark a:hover { color: #fff; }--/* Labels */-.dark label { color: #a3a3a3; }--/* Sections */-section { margin-bottom: 3rem; }--/* Default border color override */-*, ::after, ::before, ::backdrop {- border-color: #202020; /* coolgray-200 */-}--/* Select options */-.dark option {- color: #fff;- background: #181818;-}-```-------## 5. Interactive State Reference--### Focus--| Element Type | Mechanism | Light | Dark |-|---|---|---|---|-| Buttons, links, checkboxes | `ring-2` offset | Purple `#6b16ed` | Yellow `#fcd452` |-| Inputs, selects, textareas | Inset box-shadow (4px left bar) | Purple `#6b16ed` | Yellow `#fcd452` |-| Dropdown items | Background change | `bg-neutral-100` | `bg-coollabs` (`#6b16ed`) |--### Hover--| Element | Light | Dark |-|---|---|---|-| Button (default) | `bg-neutral-100` | `bg-coolgray-200` |-| Button (highlighted) | `bg-coollabs` (`#6b16ed`) | `bg-coollabs-100` (`#7317ff`) |-| Button (error) | `bg-red-300` | `bg-red-800` |-| Box card | `bg-neutral-100` + all child text `#000` | `bg-coollabs-100` (`#7317ff`) + all child text `#fff` |-| Coolbox card | Ring: `ring-coollabs` | Ring: `ring-warning` |-| Menu item | `bg-neutral-300` | `bg-coolgray-100` |-| Dropdown item | `bg-neutral-100` | `bg-coollabs` |-| Table row | `bg-neutral-200` | `bg-black` |-| Link | `text-black` | `text-white` |-| Checkbox container | — | `bg-coolgray-100` |--### Disabled--```css-/* Universal disabled pattern */-:disabled {- cursor: not-allowed;- color: #d4d4d4; /* neutral-300 */- background: transparent;- border-color: transparent;-}-.dark :disabled {- color: #525252; /* neutral-600 */-}--/* Input-specific */-.input:disabled {- background: #e5e5e5; /* neutral-200 */- color: #737373; /* neutral-500 */- box-shadow: none;-}-.dark .input:disabled {- background: rgba(24, 24, 24, 0.4);- box-shadow: none;-}-```--### Readonly--```css-.input:read-only {- color: #737373;- background: #e5e5e5;- box-shadow: none;-}-.dark .input:read-only {- color: #737373;- background: rgba(24, 24, 24, 0.4);- box-shadow: none;-}-```-------## 6. CSS Custom Properties (Theme Tokens)--For use in any CSS framework or plain CSS:--```css-:root {- /* Font */- --font-sans: Inter, sans-serif;-- /* Brand */- --color-base: #101010;- --color-coollabs: #6b16ed;- --color-coollabs-50: #f5f0ff;- --color-coollabs-100: #7317ff;- --color-coollabs-200: #5a12c7;- --color-coollabs-300: #4a0fa3;-- /* Neutral grays (dark backgrounds) */- --color-coolgray-100: #181818;- --color-coolgray-200: #202020;- --color-coolgray-300: #242424;- --color-coolgray-400: #282828;- --color-coolgray-500: #323232;-- /* Warning / dark accent */- --color-warning: #fcd452;- --color-warning-50: #fefce8;- --color-warning-100: #fef9c3;- --color-warning-200: #fef08a;- --color-warning-300: #fde047;- --color-warning-400: #fcd452;- --color-warning-500: #facc15;- --color-warning-600: #ca8a04;- --color-warning-700: #a16207;- --color-warning-800: #854d0e;- --color-warning-900: #713f12;-- /* Semantic */- --color-success: #22C55E;- --color-error: #dc2626;-}-```diff --git a/DESIGN.md b/DESIGN.mdnew file mode 100644index 0000000000..9520fdf232--- /dev/null+++ b/DESIGN.md@@ -0,0 +1,752 @@+---+version: alpha+name: Coolify+description: Self-hosted PaaS. Dark-first utilitarian UI. Purple (light) / yellow (dark) accent swap. Sharp 2px radii. Inset box-shadow inputs with 4px dirty-bar indicator.+colors:+ # Brand+ coollabs: "#6b16ed"+ coollabs-50: "#f5f0ff"+ coollabs-100: "#7317ff"+ coollabs-200: "#5a12c7"+ coollabs-300: "#4a0fa3"+ # Dark-mode accent (warning scale)+ warning: "#fcd452"+ warning-50: "#fefce8"+ warning-100: "#fef9c3"+ warning-200: "#fef08a"+ warning-300: "#fde047"+ warning-400: "#fcd452"+ warning-500: "#facc15"+ warning-600: "#ca8a04"+ warning-700: "#a16207"+ warning-800: "#854d0e"+ warning-900: "#713f12"+ # Dark surfaces+ base: "#101010"+ coolgray-100: "#181818"+ coolgray-200: "#202020"+ coolgray-300: "#242424"+ coolgray-400: "#282828"+ coolgray-500: "#323232"+ # Light surfaces (Tailwind neutrals)+ surface: "#ffffff"+ background: "#f9fafb"+ border: "#e5e5e5"+ text: "#000000"+ text-muted: "#737373"+ text-placeholder: "#d4d4d4"+ # Semantic+ success: "#22C55E"+ error: "#dc2626"+ primary: "{colors.coollabs}"+typography:+ h1:+ fontFamily: "'Geist Sans', Inter, sans-serif"+ fontSize: 1.875rem+ fontWeight: 700+ lineHeight: 1.2+ h2:+ fontFamily: "'Geist Sans', Inter, sans-serif"+ fontSize: 1.25rem+ fontWeight: 700+ h3:+ fontFamily: "'Geist Sans', Inter, sans-serif"+ fontSize: 1.125rem+ fontWeight: 700+ h4:+ fontFamily: "'Geist Sans', Inter, sans-serif"+ fontSize: 1rem+ fontWeight: 700+ body-md:+ fontFamily: "'Geist Sans', Inter, sans-serif"+ fontSize: 0.875rem+ fontWeight: 400+ lineHeight: 1.25rem+ label-md:+ fontFamily: "'Geist Sans', Inter, sans-serif"+ fontSize: 0.875rem+ fontWeight: 500+ label-sm:+ fontFamily: "'Geist Sans', Inter, sans-serif"+ fontSize: 0.75rem+ fontWeight: 700+ lineHeight: 1rem+ mono:+ fontFamily: "'Geist Mono', SFMono-Regular, Consolas, 'Liberation Mono', Menlo, monospace"+ fontSize: 0.875rem+ fontWeight: 400+rounded:+ sm: 0.125rem # default — inputs, buttons, cards, modals+ md: 0.25rem # coolbox+ lg: 0.5rem # callouts+ full: 9999px # badges, pills+spacing:+ xs: 0.25rem+ sm: 0.5rem+ md: 1rem+ lg: 1.5rem+ xl: 2rem+ section: 3rem+ sidebar-width: 14rem+ button-height: 2rem+ card-min-height: 4rem+ input-py: 0.375rem+components:+ button:+ backgroundColor: "{colors.surface}"+ textColor: "{colors.text}"+ rounded: "{rounded.sm}"+ height: "{spacing.button-height}"+ padding: 0 0.5rem+ button-dark:+ backgroundColor: "{colors.coolgray-100}"+ textColor: "#ffffff"+ button-hover:+ backgroundColor: "#f5f5f5"+ button-hover-dark:+ backgroundColor: "{colors.coolgray-200}"+ button-highlighted:+ backgroundColor: "{colors.coollabs-50}"+ textColor: "{colors.coollabs-200}"+ button-highlighted-hover:+ backgroundColor: "{colors.coollabs}"+ textColor: "#ffffff"+ button-error:+ backgroundColor: "#fef2f2"+ textColor: "#991b1b"+ button-error-hover:+ backgroundColor: "#fca5a5"+ textColor: "#ffffff"+ input:+ backgroundColor: "{colors.surface}"+ textColor: "{colors.text}"+ rounded: "{rounded.sm}"+ padding: 0.375rem 0.5rem+ input-dark:+ backgroundColor: "{colors.coolgray-100}"+ textColor: "#ffffff"+ textarea:+ typography: "{typography.mono}"+ backgroundColor: "{colors.surface}"+ rounded: "{rounded.sm}"+ box:+ backgroundColor: "{colors.surface}"+ textColor: "{colors.text}"+ rounded: "{rounded.sm}"+ padding: "{spacing.sm}"+ height: "{spacing.card-min-height}"+ box-dark:+ backgroundColor: "{colors.coolgray-100}"+ textColor: "#ffffff"+ box-hover:+ backgroundColor: "#f5f5f5"+ box-hover-dark:+ backgroundColor: "{colors.coollabs-100}"+ textColor: "#ffffff"+ coolbox:+ backgroundColor: "{colors.surface}"+ rounded: "{rounded.md}"+ padding: "{spacing.sm}"+ height: "{spacing.card-min-height}"+ badge-success:+ backgroundColor: "{colors.success}"+ size: 0.75rem+ rounded: "{rounded.full}"+ badge-warning:+ backgroundColor: "{colors.warning}"+ size: 0.75rem+ rounded: "{rounded.full}"+ badge-error:+ backgroundColor: "{colors.error}"+ size: 0.75rem+ rounded: "{rounded.full}"+ deprecated-badge:+ backgroundColor: "rgba(252, 212, 82, 0.15)"+ textColor: "{colors.warning}"+ rounded: "{rounded.full}"+ padding: 0.125rem 0.5rem+ callout-warning:+ backgroundColor: "{colors.warning-50}"+ textColor: "{colors.warning-800}"+ rounded: "{rounded.lg}"+ padding: "{spacing.md}"+ callout-danger:+ backgroundColor: "#fef2f2"+ textColor: "#991b1b"+ rounded: "{rounded.lg}"+ padding: "{spacing.md}"+ callout-info:+ backgroundColor: "#eff6ff"+ textColor: "#1e40af"+ rounded: "{rounded.lg}"+ padding: "{spacing.md}"+ callout-success:+ backgroundColor: "#f0fdf4"+ textColor: "#166534"+ rounded: "{rounded.lg}"+ padding: "{spacing.md}"+ dropdown:+ backgroundColor: "{colors.surface}"+ rounded: "{rounded.sm}"+ padding: "{spacing.xs}"+ dropdown-dark:+ backgroundColor: "{colors.coolgray-200}"+ dropdown-item-hover:+ backgroundColor: "#f5f5f5"+ dropdown-item-hover-dark:+ backgroundColor: "{colors.coollabs}"+ textColor: "#ffffff"+ menu-item-active:+ backgroundColor: "#e5e5e5"+ textColor: "{colors.text}"+ rounded: "{rounded.sm}"+ menu-item-active-dark:+ backgroundColor: "{colors.coolgray-200}"+ textColor: "{colors.warning}"+ tag:+ backgroundColor: "#f5f5f5"+ textColor: "{colors.text-muted}"+ padding: 0.25rem 0.5rem+ kbd:+ rounded: "{rounded.sm}"+ padding: 0 0.5rem+ toast:+ backgroundColor: "{colors.surface}"+ rounded: "{rounded.sm}"+ padding: "{spacing.md}"+ width: 20rem+ modal-input:+ backgroundColor: "{colors.surface}"+ rounded: "{rounded.sm}"+ modal-input-dark:+ backgroundColor: "{colors.base}"+ modal-confirmation:+ backgroundColor: "#f5f5f5"+ rounded: "{rounded.sm}"+ modal-confirmation-dark:+ backgroundColor: "{colors.base}"+---++# Coolify Design System++## Overview++Coolify is a self-hosted PaaS (Heroku/Netlify/Vercel alternative) built with Laravel 12, Livewire 3, and Tailwind CSS v4. UI is **dark-first, dense, utilitarian** — operators want information density over whitespace.++Brand personality: precise, engineered, no-nonsense. No flourish. No gradients outside a single branded upsell. Flat surfaces differentiated by tonal depth, not shadow.++Two signature traits define the system:++1. **Purple/Yellow accent swap.** Light mode uses `coollabs` purple `#6b16ed`. Dark mode swaps to `warning` yellow `#fcd452` for focus rings, active nav items, helper icons, loading spinners, highlighted text, helper links. Never use purple as an accent in dark mode.+2. **Inset box-shadow inputs with a 4px "dirty bar".** Inputs and selects have no border — they use `box-shadow: inset 4px 0 0 transparent, inset 0 0 0 2px <border>`. When the field is focused or has unsaved changes (`wire:dirty`), the left 4px becomes the accent color — a live visual indicator of modified state. This is the single most distinctive UI detail in Coolify.++Sharp geometry everywhere: 2px corner radius by default (`rounded-sm`). 8px only on callouts. Shadows used sparingly — one `shadow-sm` on boxes, one drop-shadow on toasts. The rest is flat tonal layers.++## Colors++Source of truth: `resources/css/app.css` `@theme` block (Tailwind v4).++### Palettes++- **Primary / Coollabs (`#6b16ed`)** — brand purple. Light-mode accent. Used for focus rings, active states, highlighted buttons, spinners, scrollbar thumb. Scale: `coollabs-50 #f5f0ff` (backgrounds), `coollabs #6b16ed` (base), `coollabs-100 #7317ff` (dark-mode button hover), `coollabs-200 #5a12c7` (light-mode text), `coollabs-300 #4a0fa3` (deepest).+- **Warning (`#fcd452`)** — dark-mode accent + callout palette. Full yellow scale `warning-50` through `warning-900`. Swaps in for coollabs under `.dark`.+- **Coolgray (dark surface ladder)** — five shades building dark-mode depth: `base #101010` (page) → `coolgray-100 #181818` (components) → `-200 #202020` (elevated / active nav) → `-300 #242424` (input borders, button borders) → `-400 #282828` (tooltips) → `-500 #323232` (subtle overlays).+- **Semantic** — `success #22C55E` for running/healthy, `error #dc2626` for stopped/danger.+- **Light surfaces** — `gray-50 #f9fafb` (page), `white` (components), `neutral-200 #e5e5e5` (borders), `neutral-500 #737373` (muted text), `neutral-300 #d4d4d4` (placeholders).++### Dark-mode heading rule (critical)++Body default text in dark mode is `neutral-400 #a3a3a3`. Headings and card titles MUST explicitly force `text-white` — otherwise they render near-invisible on `coolgray-100 #181818`. This is enforced globally: `h1–h4` all have `dark:text-white` in `app.css`.++### Default border override++Tailwind v4 defaults `border-color` to `currentcolor`. Coolify overrides it in `@layer base`:++```css+*, ::after, ::before, ::backdrop, ::file-selector-button {+ border-color: var(--color-coolgray-200, currentcolor);+}+```++So any `border` utility without an explicit color gets `coolgray-200 #202020` in dark mode.++## Typography++Fonts loaded in `resources/css/fonts.css` (all `woff2`, `font-display: swap`):++- **Geist Sans** — primary UI font. Variable weight `100 900`. Inter as fallback (static weights 100–900).+- **Geist Mono** — monospace for code, logs, textareas. Variable weight `100 900`.++Applied via `@theme`:++```css+--font-sans: 'Geist Sans', Inter, sans-serif;+--font-mono: 'Geist Mono', 'SFMono-Regular', Consolas, 'Liberation Mono', Menlo, monospace;+--font-logs: 'Geist Mono', 'SFMono-Regular', Consolas, 'Liberation Mono', Menlo, monospace;+```++### Heading hierarchy (Tailwind utilities)++| Element | Utility |+|---|---|+| `h1` | `text-3xl font-bold dark:text-white` |+| `h2` | `text-xl font-bold dark:text-white` |+| `h3` | `text-lg font-bold dark:text-white` |+| `h4` | `text-base font-bold dark:text-white` |++### Body++| Context | Utility |+|---|---|+| Body default | `text-sm font-sans antialiased` |+| Label | `text-sm font-medium` |+| Badge / status text | `text-xs font-bold` |+| Box description | `text-xs font-bold text-neutral-500` |+| Caption / kbd | `text-xs` |++## Layout++Fixed left sidebar layout on desktop. Mobile collapses to a sticky top bar with hamburger menu overlay.++### Structure++- **Sidebar** — fixed, `w-56` (14rem / 224px), `hidden lg:flex`. Inner `flex flex-col overflow-y-auto gap-y-5 scrollbar`. Nav `bg-white dark:bg-base border-r`.+- **Main content** — `lg:pl-56` offset. Inner padding `p-4 sm:px-6 lg:px-8 lg:py-6`.+- **Mobile top bar** — `sticky top-0 z-40 lg:hidden` with `bg-white/95 dark:bg-base/95 backdrop-blur-sm`.++### Spacing scale++| Token | Value | Use |+|---|---|---|+| `p-2` | 0.5rem | Component internal padding |+| `p-4` | 1rem | Callout padding |+| `py-1.5` | 0.375rem | Input vertical padding |+| `h-8` | 2rem | Button height |+| `px-2` | 0.5rem | Button horizontal padding |+| `gap-2` | 0.5rem | Button gap |+| `px-2 py-1` | 0.25rem / 0.5rem | Menu item padding |+| `gap-3` | 0.75rem | Menu item gap |+| `mb-12` | 3rem | Section margin |+| `min-h-[4rem]` | 4rem | Card min-height |++No grid system — flex layouts everywhere.++## Elevation & Depth++**Flat + tonal.** Hierarchy comes from background color, not shadows.++### Dark tonal ladder++```+#101010 (base) page background+ #181818 (coolgray-100) cards, inputs, components+ #202020 (coolgray-200) elevated surfaces, borders, nav active+ #242424 (coolgray-300) input borders, button borders+ #282828 (coolgray-400) tooltips, hover states+ #323232 (coolgray-500) subtle overlays+```++### Light tonal ladder++```+#f9fafb (gray-50) page background+ #ffffff (white) cards, inputs, components+ #e5e5e5 (neutral-200) borders+ #f5f5f5 (neutral-100) hover backgrounds+ #d4d4d4 (neutral-300) deeper hover, nav active+```++### Shadows (used sparingly)++- Boxes: `shadow-sm` (`0 1px 2px 0 rgba(0,0,0,0.05)`)+- Toasts: `shadow-[0_5px_15px_-3px_rgb(0_0_0_/_0.08)]`+- Slide-over: `shadow-lg`+- Modal-input: `drop-shadow-sm`++### Input inset box-shadow system (distinctive)++Inputs and selects use `box-shadow` instead of `border` — this enables the 4px left dirty-bar indicator:++```css+/* default */ box-shadow: inset 4px 0 0 transparent, inset 0 0 0 2px #e5e5e5;+/* default dark */ inset 4px 0 0 transparent, inset 0 0 0 2px #242424;+/* focus light */ inset 4px 0 0 #6b16ed, inset 0 0 0 2px #e5e5e5;+/* focus dark */ inset 4px 0 0 #fcd452, inset 0 0 0 2px #242424;+/* dirty (same as focus) — set via wire:dirty.class */+/* disabled / readonly */ box-shadow: none;+```++Variant `input-sticky` uses `1px` outer shadow instead of `2px`.++### Focus ring (buttons, links, checkboxes, non-input)++`focus-visible:outline-none focus-visible:ring-2 focus-visible:ring-coollabs dark:focus-visible:ring-warning focus-visible:ring-offset-2 dark:focus-visible:ring-offset-base`++## Shapes++- **Default** — `rounded-sm` (2px). Everything: inputs, buttons, cards, modals, toasts, dropdowns.+- **Coolbox** — `rounded` (4px). Alternate card style with ring-hover.+- **Callouts** — `rounded-lg` (8px). Only exception to the sharp rule.+- **Badges / deprecated badge / pills / avatars** — `rounded-full`.++Never mix radii within the same view.++## Components++All component classes live in `resources/css/utilities.css` as `@utility` blocks, consumed by Blade components under `resources/views/components/`.++### Forms++#### Button++Utility `.button` (`resources/css/utilities.css`):++```+flex gap-2 justify-center items-center px-2 h-8 text-sm text-black normal-case rounded-sm border-2 outline-0 cursor-pointer font-medium bg-white border-neutral-200 hover:bg-neutral-100 dark:bg-coolgray-100 dark:text-white dark:hover:text-white dark:hover:bg-coolgray-200 dark:border-coolgray-300 hover:text-black disabled:cursor-not-allowed min-w-fit dark:disabled:text-neutral-600 disabled:border-transparent disabled:hover:bg-transparent disabled:bg-transparent disabled:text-neutral-300 focus-visible:outline-none focus-visible:ring-2 focus-visible:ring-coollabs dark:focus-visible:ring-warning focus-visible:ring-offset-2 dark:focus-visible:ring-offset-base+```++Attribute variants (in `app.css`):++- `button[isHighlighted]` → `text-coollabs-200 dark:text-white bg-coollabs-50 dark:bg-coollabs/20 border-coollabs dark:border-coollabs-100 hover:bg-coollabs hover:text-white dark:hover:bg-coollabs-100 dark:hover:text-white`+- `button[isError]` → `text-red-800 dark:text-red-300 bg-red-50 dark:bg-red-900/30 border-red-300 dark:border-red-800 hover:bg-red-300 hover:text-white dark:hover:bg-red-800 dark:hover:text-white`++Loading: `<x-loading-on-button>` — inline `w-4 h-4 dark:text-warning animate-spin` SVG.++#### Input++Utility chain `.input-select` → `.input`:++```+block py-1.5 w-full text-sm text-black rounded-sm border-0 dark:bg-coolgray-100 dark:text-white disabled:bg-neutral-200 disabled:text-neutral-500 dark:disabled:bg-coolgray-100/40 placeholder:text-neutral-300 dark:placeholder:text-neutral-700 read-only:text-neutral-500 read-only:bg-neutral-200 dark:read-only:text-neutral-500 dark:read-only:bg-coolgray-100/40 focus-visible:outline-none+```++Plus the inset box-shadow system (see Elevation). Password variant: `.input[type="password"]` gets `pr-[2.4rem]` for the eye icon.++**Dirty indicator.** Livewire sets the focus-colored shadow via `wire:dirty.class`:++```blade+wire:dirty.class="[box-shadow:inset_4px_0_0_#6b16ed,inset_0_0_0_2px_#e5e5e5] dark:[box-shadow:inset_4px_0_0_#fcd452,inset_0_0_0_2px_#242424]"+```++Variant `.input-sticky` — same shape, `1px` outer shadow (thinner border).++#### Select++Extends `.input-select` + custom SVG dropdown arrow:++```css+background-image: url("data:image/svg+xml,...stroke='%23000000'...");+padding-right: 2.5rem;+```++Dark mode swaps the SVG stroke to `%23ffffff`.++#### Checkbox++Input class:+```+dark:border-neutral-700 text-coolgray-400 dark:bg-coolgray-100 rounded-sm cursor-pointer dark:disabled:bg-base dark:disabled:cursor-not-allowed focus-visible:outline-none focus-visible:ring-2 focus-visible:ring-coollabs dark:focus-visible:ring-warning focus-visible:ring-offset-2 dark:focus-visible:ring-offset-base+```++Container:+```+form-control flex max-w-full flex-row items-center gap-4 py-1 pr-2 dark:hover:bg-coolgray-100 cursor-pointer+```++#### Textarea++Uses the same `input` utility + `font-mono` + dirty-bar via `wire:dirty.class` (identical to input). Optional `@keydown.tab=handleKeydown` inserts 2 spaces on Tab.++#### Copy-Button++`resources/views/components/forms/copy-button.blade.php` — readonly `.input` with an absolute-positioned copy icon right-side. Copied state shows a green check (`text-green-500`) for 1 second. Only renders in secure contexts (`window.isSecureContext`).++### Containers++#### Box++Utility `.box`:+```+relative flex lg:flex-row flex-col p-2 transition-colors cursor-pointer min-h-[4rem] dark:bg-coolgray-100 shadow-sm bg-white border text-black dark:text-white hover:text-black border-neutral-200 dark:border-coolgray-300 hover:bg-neutral-100 dark:hover:bg-coollabs-100 dark:hover:text-white hover:no-underline rounded-sm+```++**Critical child text rule.** On dark hover, background becomes purple `#7317ff` — description text `#737373` disappears. Utilities `.box-title` and `.box-description` include `dark:group-hover:text-white group-hover:text-black` to flip text contrast.++Variants: `.box-boarding`, `.box-without-bg`, `.box-without-bg-without-border`.++#### Coolbox++Utility `.coolbox`:+```+relative flex transition-all duration-150 dark:bg-coolgray-100 bg-white p-2 rounded border border-neutral-200 dark:border-coolgray-400 hover:ring-2 dark:hover:ring-warning hover:ring-coollabs cursor-pointer min-h-[4rem]+```++Distinguished by `rounded` (4px, not 2px) and **ring-hover** instead of background change.++### Status & Badges++#### Badge base++```+inline-block w-3 h-3 text-xs font-bold rounded-full leading-none border border-neutral-200 dark:border-black+```++Fill utilities: `.badge-success` (`bg-success`), `.badge-warning` (`bg-warning`), `.badge-error` (`bg-error`). Dashboard variant `.badge-dashboard` is `absolute top-1 right-1 w-2.5 h-2.5`.++#### Status indicator pattern++Badge + label side-by-side. Components in `resources/views/components/status/`:++| Component | Badge | Text color | Loading? |+|---|---|---|---|+| `status/running` | `badge-success` | `text-success` (`#22C55E`) | Swaps to `badge-warning` while checking proxy |+| `status/degraded` | `badge-warning` | `dark:text-warning` (`#fcd452`) | `<x-loading>` + `wire:loading.delay.longer` |+| `status/restarting` | `badge-warning` | `dark:text-warning` | `<x-loading>` |+| `status/stopped` | `badge-error` | `text-error` (`#dc2626`) | `<x-loading>` |++Layout: `<div class="flex items-center">` → badge → `<div class="pl-2 pr-1 text-xs font-bold {color}">{label}</div>` → optional `({health})` in same color.++#### Deprecated Badge++`resources/views/components/deprecated-badge.blade.php`:+```+px-2 py-0.5 text-xs font-medium leading-normal rounded-full bg-warning/15 text-warning border border-warning/30+```++#### Tag++Utility `.tag`:+```+px-2 py-1 cursor-pointer box-description dark:bg-coolgray-100 dark:hover:bg-coolgray-300 bg-neutral-100 hover:bg-neutral-200+```++### Overlays++#### Callout++Four types (`warning`, `danger`, `info`, `success`). Base: `relative p-4 border rounded-lg`.++| Type | Background | Border | Title text | Body text |+|---|---|---|---|---|+| warning | `bg-warning-50 dark:bg-warning-900/30` | `border-warning-300 dark:border-warning-800` | `text-warning-800 dark:text-warning-300` | `text-warning-700 dark:text-warning-200` |+| danger | `bg-red-50 dark:bg-red-900/30` | `border-red-300 dark:border-red-800` | `text-red-800 dark:text-red-300` | `text-red-700 dark:text-red-200` |+| info | `bg-blue-50 dark:bg-blue-900/30` | `border-blue-300 dark:border-blue-800` | `text-blue-800 dark:text-blue-300` | `text-blue-700 dark:text-blue-200` |+| success | `bg-green-50 dark:bg-green-900/30` | `border-green-300 dark:border-green-800` | `text-green-800 dark:text-green-300` | `text-green-700 dark:text-green-200` |++Icon colors (600 light / 400 dark) match type.++#### Modal (input variant)++`resources/views/components/modal.blade.php`:+```+relative w-full lg:w-auto lg:min-w-2xl lg:max-w-4xl border rounded-sm drop-shadow-sm bg-white border-neutral-200 dark:bg-base dark:border-coolgray-300 flex flex-col+```++Backdrop: `bg-black/20 backdrop-blur-xs`. Close button: `w-8 h-8 rounded-full hover:bg-neutral-100 dark:hover:bg-coolgray-300` top-right, 24px `stroke-width=1.5` X icon.++#### Modal Confirmation++`resources/views/components/modal-confirmation.blade.php` — destructive-action 2-or-3-step wizard (checkboxes → confirm text → password):+```+relative w-full border rounded-none sm:rounded-sm min-w-full lg:min-w-[36rem] max-w-full sm:max-w-[48rem] h-screen sm:h-auto max-h-screen sm:max-h-[calc(100vh-2rem)] bg-neutral-100 border-neutral-400 dark:bg-base dark:border-coolgray-300 flex flex-col+```++Uses `<x-callout type="danger">` for warning. Password step hidden for OAuth users.++#### Confirm Modal++`resources/views/components/confirm-modal.blade.php` — Livewire-bound simpler confirm dialog.++#### Popup / Popup-Small++Fixed bottom-right notification card with title / description / action button. `bg-white dark:bg-coolgray-100 border dark:border-coolgray-300 shadow-lg sm:rounded-sm`. Popup is responsive max-w-4xl, Popup-Small is `max-w-[46rem]`.++#### Slide-Over++`resources/views/components/slide-over.blade.php`:++Outer: `fixed inset-y-0 right-0 flex max-w-full pl-10`++Panel: `max-w-xl w-screen flex flex-col h-full py-6 overflow-hidden border-l shadow-lg bg-neutral-50 dark:bg-base dark:border-neutral-800 border-neutral-200`++#### Toast++`resources/views/components/toast.blade.php` — Alpine-powered stacked toast system.++- Container: `fixed ... sm:max-w-xs z-9999`, positioned via `position` param (`top-right` / `top-left` / `top-center` / `bottom-right` / `bottom-left` / `bottom-center`).+- Toast shell: `relative flex flex-col items-start shadow-[0_5px_15px_-3px_rgb(0_0_0_/_0.08)] w-full dark:bg-coolgray-100 bg-white dark:border dark:border-coolgray-200 rounded-sm sm:max-w-xs`.+- Stacks up to 4 (oldest gets scale 82% then burns).+- Auto-dismiss after 4 s. Hover on container pauses dismissal and expands stack.+- HTML payload sanitized via `window.sanitizeHTML` (XSS guard).+- Per-toast copy-to-clipboard + close buttons.++Icon colors:++| Type | Class |+|---|---|+| success | `text-green-500` |+| info | `text-blue-500` |+| warning | `text-orange-400` |+| danger | `text-red-500` |+| default | `text-gray-800` |++#### Helper / Tooltip++`resources/views/components/helper.blade.php`. Icon utility `.info-helper`:+```+cursor-pointer text-coollabs dark:text-warning+```++Popup utility `.info-helper-popup`:+```+hidden absolute z-40 text-xs rounded-sm text-neutral-700 group-hover:block dark:border-coolgray-500 border-neutral-900 dark:bg-coolgray-400 bg-neutral-200 dark:text-neutral-300 max-w-sm whitespace-normal break-words+```++Shown on parent `.group:hover`. Supports rich HTML (links colored `text-coollabs dark:text-warning underline`).++### Navigation++#### Sidebar / Navbar++Component: `resources/views/components/navbar.blade.php`.++Root nav: `flex flex-col flex-1 px-2 bg-white border-r dark:border-coolgray-200 border-neutral-300 dark:bg-base`++Menu list: `flex flex-col flex-1 gap-y-7` → inner `flex flex-col h-full space-y-1.5`.++Utility `.menu-item`:+```+flex gap-3 items-center px-2 py-1 w-full text-sm dark:hover:bg-coolgray-100 dark:hover:text-white hover:bg-neutral-300 rounded-sm truncate min-w-0+```++Utility `.menu-item-active`:+```+text-black rounded-sm dark:bg-coolgray-200 dark:text-warning bg-neutral-200 overflow-hidden+```++Icon `.menu-item-icon`: `flex-shrink-0 w-6 h-6 dark:hover:text-white`. Sub-items use `gap-2` + `w-4 h-4` icons.++#### Breadcrumbs++`resources/views/components/resources/breadcrumbs.blade.php` — project → environment → resource trail. Desktop: `<ol class="hidden flex-wrap items-center gap-y-1 md:flex">`. Each link `text-xs lg:text-sm hover:text-warning`. Chevron buttons `text-warning`. Dropdowns `absolute ... bg-white dark:bg-coolgray-100 rounded-md shadow-lg border`. Active item `dark:text-warning font-semibold`.++#### External-Link++Mini icon — `inline-flex w-3 h-3 dark:text-neutral-400 text-black` with arrow-out-of-box SVG. Appended to external anchors.++#### Internal-Link++Arrow SVG — `inline-flex w-4 h-4 text-black dark:text-white`. Used in CTA links ("go to deployment" etc).++#### Banner++`resources/views/components/banner.blade.php` — dismissible top bar:+```+relative z-999 w-full py-2 mx-auto duration-100 ease-out shadow-xs bg-coolgray-100 sm:py-0 sm:h-14+```++Close button: `w-6 h-6 rounded-full hover:bg-coolgray-500 text-neutral-200`. Reveals via Alpine `x-transition` after 100ms delay.++### Feedback++#### Loading Spinner++`resources/views/components/loading.blade.php` — inline flex with optional text + spinning SVG:+```+w-4 h-4 mx-1 ml-3 text-coollabs dark:text-warning animate-spin+```++SVG has two paths at `opacity-25` (track) + `opacity-75` (arc).++Utility `.loading`: `w-4 dark:text-warning text-coollabs`.++#### Loading-On-Button++`resources/views/components/loading-on-button.blade.php` — same SVG but **no light-mode color** (`w-4 h-4 mx-1 ml-3 dark:text-warning animate-spin`), meant to inherit button text color.++#### Page-Loading++Full-page loader overlay (variant of `loading` component, fills viewport).++### Text++#### Highlighted text++`resources/views/components/highlighted.blade.php` / utility `.text-helper`:+```+inline-block font-bold text-coollabs dark:text-warning+```++Also used for required-field asterisks via `<x-highlighted text="*" />`.++#### Kbd++Utility `.kbd-custom`:+```+px-2 text-xs rounded-sm border border-dashed border-neutral-700 dark:text-warning+```++### Chrome++#### Scrollbar++Utility `.scrollbar` (uses `tailwind-scrollbar` plugin):+```+scrollbar-thumb-coollabs-100 scrollbar-track-neutral-200 dark:scrollbar-track-coolgray-200 scrollbar-thin+```++Applied globally to `<body>` in `app.css`.++#### Table++Styled via base element rules in `app.css` (not a reusable component):++```css+table { @apply min-w-full divide-y dark:divide-coolgray-200 divide-neutral-300; }+thead { @apply uppercase; }+tbody { @apply divide-y dark:divide-coolgray-200 divide-neutral-300; }+tr { @apply text-black dark:text-neutral-400 dark:hover:bg-coolgray-300 hover:bg-neutral-100; }+tr th { @apply px-3 py-3.5 text-left text-black dark:text-white; }+tr th:first-child { @apply py-3.5 pr-3 pl-4 sm:pl-6; }+tr td { @apply px-3 py-4 whitespace-nowrap; }+tr td:first-child { @apply pr-3 pl-4 font-bold sm:pl-6; }+```++#### Dropdown++`resources/views/components/dropdown.blade.php`. Container:+```+border border-neutral-300 bg-white p-1 shadow-sm dark:border-coolgray-300 dark:bg-coolgray-200+```++Utility `.dropdown-item`:+```+flex relative gap-2 justify-start items-center py-1 pr-4 pl-2 w-full text-xs transition-colors cursor-pointer select-none dark:text-white hover:bg-neutral-100 dark:hover:bg-coollabs outline-none data-disabled:pointer-events-none data-disabled:opacity-50 focus-visible:bg-neutral-100 dark:focus-visible:bg-coollabs+```++Touch variant adds `min-h-10 px-3 py-2 text-sm`.++## Do's and Don'ts++- **Do** force `dark:text-white` on h1–h4 and card titles. Default body text `#a3a3a3` is unreadable on `coolgray-100`.+- **Do** swap the accent: `coollabs` in light, `warning` in dark. For focus rings, active nav, helpers, spinners, highlighted text, scrollbar thumb, helper links.+- **Do** use the inset box-shadow system on inputs, selects, and textareas — not a border. It enables the 4px left dirty-bar.+- **Do** wire the dirty indicator via `wire:dirty.class` so Livewire flips the bar color on modified state.+- **Do** flip `.box-title` and `.box-description` to the contrast color on hover. On dark hover the card goes purple `#7317ff`; `text-neutral-500` description becomes invisible.+- **Do** maintain WCAG AA contrast (4.5:1 for normal text).+- **Do** sanitize HTML passed into toasts via `window.sanitizeHTML`.+- **Do** use `<x-loading>` for in-button spinners and as `wire:loading.delay.longer` indicators in status components.+- **Don't** use purple `coollabs` as the dark-mode accent. Always use yellow `warning` in dark.+- **Don't** mix corner radii — 2px everywhere except callouts (8px) and pills (full).+- **Don't** use shadows for elevation in dark mode. Use tonal layers from the coolgray ladder.+- **Don't** set `border` utilities without expecting `coolgray-200` in dark (default override in base layer).+- **Don't** add gradients. The one exception is the `.bg-coollabs-gradient` upsell strip.+- **Don't** use more than two font weights on a single screen (typically 400 body + 700 bold).++---++Source files:+- Theme tokens: `resources/css/app.css` (`@theme` block)+- Fonts: `resources/css/fonts.css`+- Component utilities: `resources/css/utilities.css`+- Blade components: `resources/views/components/**/*.blade.php`