DESIGN.md@src/tools/paw-tools-presentation/assets/kinetic_insight_colour_template · git:20260402.41bd44f · 2026-04-02 · sha256 c3b6019987995e9d

DESIGN.md@src/tools/paw-tools-presentation/assets/kinetic_insight_colour_template git:20260402.41bd44fA

Immutable. This exact content never changes and is served at /api/v1/blob/c3b6019987995e9d.

# Design System Specification: The Executive Editorial

## 1. Overview & Creative North Star
**Creative North Star: "The Architectural Brief"**

This design system is engineered to move beyond the "corporate template" and into the realm of high-end editorial intelligence. Inspired by the rigorous clarity of top-tier management consultancy, the system avoids decorative fluff in favor of **Structural Authority**. 

We achieve a premium feel through "The Architectural Brief" philosophy: 
*   **Intentional Asymmetry:** Breaking the expected 12-column grid with wide "logic margins" (using `spacing-24` for hero offsets) to allow content to breathe.
*   **Typographic Gravity:** Using extreme scale shifts between `display-lg` and `body-md` to signal importance without needing bold colors.
*   **Layered Analytical Depth:** Moving away from flat 2D layouts toward a system of "stacked intelligence" where information is nested in tonal containers.

## 2. Colors: The Tonal Authority
The palette is anchored in `primary` (#001e40) and `primary-container` (#003366), evoking deep-sea stability and intellectual rigor.

### The "No-Line" Rule
To maintain a high-end editorial feel, **1px solid borders are prohibited for sectioning.** Boundaries must be defined solely through background color shifts. 
*   Place a `surface-container-lowest` card on a `surface-container-low` background to create a "soft edge."
*   Use `surface-bright` for the main canvas to ensure the "white space" feels intentional and premium rather than empty.

### Surface Hierarchy & Nesting
Treat the UI as a series of physical layers of fine stationery. 
*   **Base:** `surface` (#f8f9fa)
*   **Sectioning:** `surface-container-low` (#f3f4f5)
*   **Active Content/Cards:** `surface-container-lowest` (#ffffff)
*   **Secondary Context:** `surface-container-high` (#e7e8e9)

### The Glass & Gradient Rule
While the brand is minimalist, pure flat colors can feel "default." 
*   **CTAs:** Use a subtle linear gradient from `primary` to `primary-container` (135-degree angle) to add a microscopic sense of curvature and "soul."
*   **Floating Navigation:** Apply `surface-container-lowest` with 80% opacity and a `20px` backdrop-blur to create a "frosted glass" effect that allows background data to peek through, maintaining the analytical context.

## 3. Typography: The Voice of Reason
The typography utilizes a tripartite sans-serif strategy to balance authority with modern readability.

*   **Display & Headlines (Manrope):** Chosen for its geometric precision. Use `display-lg` for key insights. Letter-spacing should be set to `-0.02em` for headlines to create a "tight," authoritative lockup.
*   **Title & Body (Public Sans):** A neutral, "workhorse" typeface that disappears to let the data speak. Use `title-lg` for section headers and `body-lg` for executive summaries.
*   **Labels (Inter):** Reserved for micro-data, captions, and UI controls. Inter’s high x-height ensures readability even at the `label-sm` (0.6875rem) scale.

## 4. Elevation & Depth
In this design system, depth is a function of **Tonal Layering**, not physical shadows.

*   **The Layering Principle:** Avoid "Drop Shadows." Instead, stack `surface-container-lowest` on `surface-container-low`. The 2% difference in hex value provides a sophisticated, "barely-there" lift.
*   **Ambient Shadows:** If a floating modal is required, use an ultra-diffused shadow: `box-shadow: 0 20px 50px rgba(0, 30, 64, 0.05);`. Note the use of a `primary` tint in the shadow rather than pure black.
*   **The "Ghost Border" Fallback:** If accessibility requires a container edge (e.g., on a white-on-white edge), use `outline-variant` at **15% opacity**. This creates a "hairline" guide that guides the eye without cluttering the interface.

## 5. Components

### Buttons (The "Precision Trigger")
*   **Primary:** Solid `primary` background. Corner radius is strictly `0px` (Square). High-contrast `on-primary` text in `label-md`.
*   **Secondary:** `surface-container-highest` background. No border.
*   **Tertiary:** Text-only in `primary` color. Use `spacing-1` for underline offset if required.

### Cards & Lists
*   **Constraint:** Forbid all divider lines.
*   **Implementation:** Use `spacing-8` to `spacing-12` of vertical white space to separate list items. Use a `surface-container-low` background on hover to define the interactive area.
*   **Data Cards:** Must use `surface-container-lowest` with a "Ghost Border" top-accent in `primary` (2px height) to denote importance.

### Analytical Data Chips
*   **Style:** Small, square-edged containers using `secondary-container`. Text in `on-secondary-container`. Use these for tagging report sectors or data types.

### Input Fields
*   **Style:** Minimalist "Underline" style. A 1px line in `outline-variant` that transitions to 2px `primary` on focus. No background fill, utilizing the natural `surface` color to maintain transparency.

## 6. Do's and Don'ts

### Do:
*   **Embrace Asymmetry:** Align the main body text to a 6-column center-right grid, leaving the left for "Executive Summaries" or "Key Stats."
*   **Use High-Scale Contrasts:** Pair a `display-lg` metric with a `body-sm` caption immediately below it.
*   **Mind the Gutters:** Use `spacing-6` (2rem) as your minimum margin between unrelated logical blocks.

### Don't:
*   **No Rounded Corners:** `0px` is the standard. Rounding suggests "consumer-friendly" softness; square edges suggest "corporate-grade" precision.
*   **No Pure Black:** Never use `#000000`. Use `on-surface` (#191c1d) for text to maintain a high-end ink-on-paper feel.
*   **No 1px Borders:** Unless it is a "Ghost Border" at <20% opacity, avoid it. Use white space or tonal shifts instead.