Apply Mantel Styles

Rules For Applying Mantel Brand Styles

When creating visual diagrams or frontend components, you can apply the following style guidelines to ensure consistency with the Mantel brand identity.

Colour Scheme

• You should aim to use the following primary colours from the Mantel brand palette.
• You _may_ also use tints and shades of these colours as needed, but avoid introducing non-brand colours.

Palette

Extended Palette — Brand Ramps (50 lightest → 900 darkest)

Use these tokens for tints, shades, hover states, borders, and surfaces without introducing non-brand colours. Prefer the core step (bold) for each brand colour; reach for neighbouring steps when you need contrast adjustment.

Ocean — core 500

 50  #E8F2F8      500  #1E5E82   ← core
100  #C5DCEA      600  #174E6E
200  #9DC3D8      700  #103D57
300  #6AA5C3      800  #0A2D40
400  #3D89AF      900  #042031

Flamingo — core 500

 50  #FAEEF2      500  #D86E89   ← core
100  #F4D1DA      600  #C25079
200  #EDB0BE      700  #9E3456
300  #E690A2      800  #7A1E3D
400  #DE7F92      900  #550E28

Sky — core 400 (Sky's brand anchor sits at 400, not 500)

 50  #F0FAFD      400  #81CCEA   ← core
100  #D9F1F9      500  #59BAE2
200  #B8E5F5      600  #329DD3
300  #95D6EF      700  #1B7EAD
                  800  #0E5F85
                  900  #064260

Neutral — greys for text, borders, dividers on light surfaces

 50  #F5F7F9      500  #8A99AB
100  #DDE3EA      600  #5C6A7A
200  #C5CED9      700  #3E4F5E
300  #A8B5C4      800  #293C49
400  #B2BECC      900  #161C21

Anchor Tokens (fixed, not on a ramp)

Semantic Status Colours

Use these for success / warning / error / attention states. Do not substitute brand colours — overloading Flamingo for errors breaks the semantic contract users rely on.

---

General Design Principles

Colour Hierarchy

1. Primary Actions/Elements: Ocean (#1E5E82) 2. Secondary/Supporting: Sky Blue (#81CCEA) 3. Emphasis/Accent: Flamingo (#D86E89) 4. Foundation/Authority: Deep Ocean (#002A41) 5. Background/Neutral: Cloud (#EEF9FD)

• Light backgrounds use Cloud (#EEF9FD) or white (#FFFFFF).
• Dark backgrounds use Deep Ocean (#002A41). Never use pure black (#000000).
• Primary text on light backgrounds is Deep Ocean. On dark backgrounds, use white.
• Accent elements (borders, icons, highlights) use Ocean, Flamingo, or Sky Blue.

Semantic Usage

• Use Ocean for primary actions, main navigation, and brand-level emphasis
• Use Sky Blue for interactive elements, information, and secondary actions
• Use Flamingo sparingly for CTAs and brand highlights (not for errors — use Kylo)
• Use Deep Ocean for text, borders, authoritative elements
• Use Cloud for backgrounds, subtle dividers, inactive states
• Use the semantic status colours (Yoda / BB8 / Kylo / Pyre) for success / warning / error / attention — never substitute brand colours for these
• Default to light / day mode colour schemes

Consistency Rules

• Avoid mixing colour schemes from other brands
• Maintain consistent colour meanings across all diagrams in a project
• When transparency is needed, use rgba values of the brand colours
• For hover/pressed states, step one rung on the brand ramp (e.g. ocean-500 → ocean-600 on hover, flamingo-500 → flamingo-600 on press). Only fall back to percentage darken/lighten if no ramp token fits

---

Frontend Component Styles

Component Guidelines

Buttons

Primary:

• Background: Ocean (#1E5E82)
• Text: Cloud (#EEF9FD)
• Hover: Deep Ocean (#002A41)
• Border: none or Ocean

Secondary:

• Background: Sky Blue (#81CCEA)
• Text: Deep Ocean (#002A41)
• Hover: Ocean (#1E5E82) with Cloud text
• Border: Ocean (#1E5E82)

Accent/CTA:

• Background: Flamingo 500 (#D86E89)
• Text: White (#FFFFFF)
• Hover: Flamingo 600 (#C25079)
• Border: none

Ghost/Outline:

• Background: transparent
• Text: Ocean (#1E5E82)
• Hover: Cloud (#EEF9FD) background
• Border: Ocean (#1E5E82)

Navigation

Header:

• Background: Deep Ocean (#002A41)
• Text: Cloud (#EEF9FD)
• Active: Sky Blue (#81CCEA)
• Hover: Ocean (#1E5E82) background

Sidebar:

• Background: Cloud (#EEF9FD)
• Text: Deep Ocean (#002A41)
• Active: Ocean (#1E5E82) with Cloud text
• Hover: Sky Blue (#81CCEA) background

Forms

Input Fields:

• Background: White (#FFFFFF)
• Border: Sky Blue (#81CCEA)
• Focus Border: Ocean (#1E5E82)
• Text: Deep Ocean (#002A41)
• Placeholder: Sky Blue (#81CCEA)
• Error Border: Kylo 600 (#D91544)

Labels:

• Colour: Ocean (#1E5E82)
• Required Indicator: Flamingo (#D86E89)

Cards and Surfaces

Standard Card:

• Background: White (#FFFFFF)
• Border: Cloud (#EEF9FD)
• Shadow: rgba(0, 42, 65, 0.1)

Highlighted Card:

• Background: Cloud (#EEF9FD)
• Border: Sky Blue (#81CCEA)
• Shadow: rgba(30, 94, 130, 0.15)

Alerts and Messages

Use the semantic status colours — do not overload Flamingo for errors/warnings or Ocean for success.

Error:

• Background: Kylo 600 (#D91544) at 10% opacity
• Border: Kylo 600 (#D91544)
• Text: Deep Ocean (#002A41)
• Icon: Kylo 600 (#D91544)

Warning:

• Background: BB8 600 (#E87400) at 10% opacity
• Border: BB8 600 (#E87400)
• Text: Deep Ocean (#002A41)
• Icon: BB8 600 (#E87400)

Success:

• Background: Yoda 600 (#07883D) at 10% opacity
• Border: Yoda 600 (#07883D)
• Text: Deep Ocean (#002A41)
• Icon: Yoda 600 (#07883D)

Info:

• Background: Sky Blue (#81CCEA) at 10% opacity
• Border: Sky Blue (#81CCEA)
• Text: Deep Ocean (#002A41)
• Icon: Sky Blue (#81CCEA)

Data Visualisation (Charts)

• Primary Series: Ocean (#1E5E82)
• Secondary Series: Sky Blue (#81CCEA)
• Tertiary Series: Deep Ocean (#002A41)
• Highlight/Accent: Flamingo (#D86E89)
• Background: Cloud (#EEF9FD)
• Grid Lines: Sky Blue (#81CCEA) at 20% opacity
• Text: Deep Ocean (#002A41)

CSS Variables

:root {
   /* Core brand (anchor steps) */
   --brand-ocean: #1E5E82;        /* ocean-500 */
   --brand-flamingo: #D86E89;     /* flamingo-500 */
   --brand-sky-blue: #81CCEA;     /* sky-400 */
   --brand-deep-ocean: #002A41;
   --brand-cloud: #EEF9FD;

   /* Ocean ramp */
   --ocean-50:  #E8F2F8; --ocean-100: #C5DCEA; --ocean-200: #9DC3D8;
   --ocean-300: #6AA5C3; --ocean-400: #3D89AF; --ocean-500: #1E5E82;
   --ocean-600: #174E6E; --ocean-700: #103D57; --ocean-800: #0A2D40;
   --ocean-900: #042031;

   /* Flamingo ramp */
   --flamingo-50:  #FAEEF2; --flamingo-100: #F4D1DA; --flamingo-200: #EDB0BE;
   --flamingo-300: #E690A2; --flamingo-400: #DE7F92; --flamingo-500: #D86E89;
   --flamingo-600: #C25079; --flamingo-700: #9E3456; --flamingo-800: #7A1E3D;
   --flamingo-900: #550E28;

   /* Sky ramp */
   --sky-50:  #F0FAFD; --sky-100: #D9F1F9; --sky-200: #B8E5F5;
   --sky-300: #95D6EF; --sky-400: #81CCEA; --sky-500: #59BAE2;
   --sky-600: #329DD3; --sky-700: #1B7EAD; --sky-800: #0E5F85;
   --sky-900: #064260;

   /* Neutral greys */
   --neutral-50:  #F5F7F9; --neutral-100: #DDE3EA; --neutral-200: #C5CED9;
   --neutral-300: #A8B5C4; --neutral-400: #B2BECC; --neutral-500: #8A99AB;
   --neutral-600: #5C6A7A; --neutral-700: #3E4F5E; --neutral-800: #293C49;
   --neutral-900: #161C21;

   /* Dark surfaces */
   --skywalker-950: #001421; --skywalker-900: #001E2F; --skywalker-800: #042D44;
   --skywalker-700: #073B58; --skywalker-600: #0C4F74;

   /* Semantic status */
   --yoda-600: #07883D;  /* success */
   --bb8-600:  #E87400;  /* warning */
   --kylo-600: #D91544;  /* error */
   --pyre-300: #FFD60A;  /* highlight */

   /* Semantic mappings */
   --colour-primary: var(--brand-ocean);
   --colour-primary-dark: var(--brand-deep-ocean);
   --colour-secondary: var(--brand-sky-blue);
   --colour-accent: var(--brand-flamingo);
   --colour-background: var(--brand-cloud);
   --colour-surface: #FFFFFF;

   /* Text */
   --text-primary: var(--brand-deep-ocean);
   --text-secondary: var(--brand-ocean);
   --text-on-primary: var(--brand-cloud);
   --text-on-accent: #FFFFFF;

   /* State (semantic status — do not substitute brand colours) */
   --colour-error: var(--kylo-600);
   --colour-warning: var(--bb8-600);
   --colour-success: var(--yoda-600);
   --colour-info: var(--brand-sky-blue);
   --colour-highlight: var(--pyre-300);

   /* Shadows and overlays */
   --shadow-colour: rgba(0, 42, 65, 0.1);
   --overlay-light: rgba(238, 249, 253, 0.9);
   --overlay-dark: rgba(0, 42, 65, 0.8);
}

Tailwind Configuration

Tailwind's config key is colors (American spelling) — this is required by the framework regardless of project-wide spelling conventions.

module.exports = {
   theme: {
      extend: {
         colors: {
            brand: {
               ocean: '#1E5E82',
               flamingo: '#D86E89',
               'sky-blue': '#81CCEA',
               'deep-ocean': '#002A41',
               cloud: '#EEF9FD',
            },
            ocean: {
               50: '#E8F2F8', 100: '#C5DCEA', 200: '#9DC3D8',
               300: '#6AA5C3', 400: '#3D89AF', 500: '#1E5E82',
               600: '#174E6E', 700: '#103D57', 800: '#0A2D40',
               900: '#042031',
            },
            flamingo: {
               50: '#FAEEF2', 100: '#F4D1DA', 200: '#EDB0BE',
               300: '#E690A2', 400: '#DE7F92', 500: '#D86E89',
               600: '#C25079', 700: '#9E3456', 800: '#7A1E3D',
               900: '#550E28',
            },
            sky: {
               50: '#F0FAFD', 100: '#D9F1F9', 200: '#B8E5F5',
               300: '#95D6EF', 400: '#81CCEA', 500: '#59BAE2',
               600: '#329DD3', 700: '#1B7EAD', 800: '#0E5F85',
               900: '#064260',
            },
            neutral: {
               50: '#F5F7F9', 100: '#DDE3EA', 200: '#C5CED9',
               300: '#A8B5C4', 400: '#B2BECC', 500: '#8A99AB',
               600: '#5C6A7A', 700: '#3E4F5E', 800: '#293C49',
               900: '#161C21',
            },
            skywalker: {
               600: '#0C4F74', 700: '#073B58', 800: '#042D44',
               900: '#001E2F', 950: '#001421',
            },
            // Semantic status (single-step anchors)
            yoda: '#07883D',   // success
            bb8:  '#E87400',   // warning
            kylo: '#D91544',   // error
            pyre: '#FFD60A',   // highlight
         }
      }
   }
}

---

Fonts & Typography

• Where applicable, the 'Inter' typeface is used for headlines, subheadings, and body copy.
• Favour bundling the font for offline use over relying on CDNs.

Inter CDN Fallback

If bundling is not possible, use this CDN:

<!-- HTML in your document's head -->
<link rel="preconnect" href="https://rsms.me/">
<link rel="stylesheet" href="https://rsms.me/inter/inter.css">

:root {
  font-family: Inter, sans-serif;
  font-feature-settings: 'liga' 1, 'calt' 1; /* fix for Chrome */
}
@supports (font-variation-settings: normal) {
  :root { font-family: InterVariable, sans-serif; }
}

---

Logo System

Logo Variants

The skill bundles all logo files in assets/. Selection guide:

Logo Rules (critical — violations are immediately visible)

1. Never stretch or distort. Logo aspect ratio is approximately 4.67:1. Icon is approximately 1.5:1. Always preserve proportions. 2. Never change logo colours. Use only the provided variants — never recolour the icon or wordmark. 3. Never crop the logo. All elements must be fully visible. 4. Minimum clear space around the logo equals the height and width of the icon portion. 5. Minimum sizes: Logo 80px / 21mm wide. Icon 44px / 12mm wide. 6. Light logo on light background = wrong. Dark logo on dark background = wrong. Always use the variant that contrasts with the background. 7. Preferred for client-facing materials: Use the full-colour Negative logo on Deep Ocean backgrounds. This is the most common and branded combination. 8. Never add a coloured border around the logo — the brand guide explicitly prohibits this.

---

Resources

If you are creating diagrams you MUST also read in ./resources/diagrams.md

---

This information should help you maintain visual consistency with the Mantel brand across diagrams and frontend components.

Mantel Branding - Diagrams

Mermaid Styles

Example Mermaid class definitions to apply Mantel brand styles to diagrams

Mermaid Theme Class Definitions

Primary elements (Ocean with Cloud fill for readability)

classDef process fill:#EEF9FD,stroke:#1E5E82,stroke-width:2px,color:#002A41
classDef components fill:#EEF9FD,stroke:#1E5E82,stroke-width:2px,color:#002A41
classDef subprocess fill:#EEF9FD,stroke:#1E5E82,stroke-width:1px,color:#002A41,stroke-dasharray:5 5

Interactive/Input elements (Sky Blue)

classDef inputOutput fill:#81CCEA,stroke:#1E5E82,stroke-width:2px,color:#002A41
classDef api fill:#81CCEA,stroke:#002A41,stroke-width:2px,color:#002A41
classDef user fill:#81CCEA,stroke:#002A41,stroke-width:2px,color:#002A41
classDef external fill:#81CCEA,stroke:#002A41,stroke-width:2px,color:#002A41,stroke-dasharray:3 3

Decision points and important elements (Flamingo)

classDef decision fill:#D86E89,stroke:#002A41,stroke-width:2px,color:#FFFFFF
classDef critical fill:#D86E89,stroke:#002A41,stroke-width:2px,color:#FFFFFF
classDef error fill:#D86E89,stroke:#002A41,stroke-width:3px,color:#FFFFFF
classDef warning fill:#D86E8955,stroke:#D86E89,stroke-width:2px,color:#002A41
classDef security fill:#D86E89,stroke:#002A41,stroke-width:3px,color:#FFFFFF,stroke-dasharray:2 1

Data and storage (Deep Ocean)

classDef data fill:#002A41,stroke:#1E5E82,stroke-width:2px,color:#EEF9FD
classDef storage fill:#002A41,stroke:#1E5E82,stroke-width:2px,color:#EEF9FD
classDef database fill:#002A41,stroke:#1E5E82,stroke-width:2px,color:#EEF9FD
classDef cache fill:#002A4166,stroke:#1E5E82,stroke-width:2px,color:#002A41

State classes

classDef start fill:#1E5E82,stroke:#002A41,stroke-width:3px,color:#EEF9FD
classDef end fill:#002A41,stroke:#1E5E82,stroke-width:3px,color:#EEF9FD
classDef success fill:#1E5E8233,stroke:#1E5E82,stroke-width:2px,color:#002A41
classDef pending fill:#81CCEA55,stroke:#81CCEA,stroke-width:2px,color:#002A41,stroke-dasharray:5 5
classDef active fill:#1E5E82,stroke:#002A41,stroke-width:2px,color:#EEF9FD
classDef complete fill:#1E5E8255,stroke:#1E5E82,stroke-width:2px,color:#002A41
classDef disabled fill:#EEF9FD,stroke:#81CCEA66,stroke-width:1px,color:#81CCEA
classDef inactive fill:#EEF9FD,stroke:#81CCEA66,stroke-width:1px,color:#81CCEA

Process types

classDef manual fill:#EEF9FD,stroke:#D86E89,stroke-width:2px,color:#002A41
classDef automated fill:#EEF9FD,stroke:#1E5E82,stroke-width:2px,color:#002A41
classDef async fill:#81CCEA33,stroke:#81CCEA,stroke-width:2px,color:#002A41,stroke-dasharray:8 3
classDef sync fill:#EEF9FD,stroke:#1E5E82,stroke-width:2px,color:#002A41

System elements

classDef system fill:#002A4133,stroke:#002A41,stroke-width:2px,color:#002A41
classDef network fill:#81CCEA33,stroke:#1E5E82,stroke-width:2px,color:#002A41
classDef queue fill:#81CCEA55,stroke:#1E5E82,stroke-width:2px,color:#002A41
classDef monitoring fill:#EEF9FD,stroke:#81CCEA,stroke-width:2px,color:#002A41,stroke-dasharray:1 1

Emphasis and highlights

classDef highlight fill:#D86E8922,stroke:#D86E89,stroke-width:3px,color:#002A41
classDef focus fill:#1E5E8244,stroke:#1E5E82,stroke-width:3px,color:#002A41
classDef selected fill:#81CCEA44,stroke:#002A41,stroke-width:3px,color:#002A41

Secondary elements

classDef secondary fill:#EEF9FD,stroke:#81CCEA,stroke-width:2px,color:#002A41
classDef note fill:#EEF9FD,stroke:#81CCEA,stroke-width:1px,color:#1E5E82
classDef comment fill:#EEF9FD,stroke:#81CCEA,stroke-width:1px,color:#1E5E82,stroke-dasharray:3 3
classDef optional fill:#EEF9FD,stroke:#81CCEA,stroke-width:1px,color:#002A41,stroke-dasharray:5 5

Default styling

classDef default fill:#EEF9FD,stroke:#1E5E82,stroke-width:2px,color:#002A41

Mermaid Usage Guide

Core Process Elements:

• Use 'process' for standard workflow steps
• Use 'subprocess' for nested or child processes
• Use 'components' for system components or modules

Interactive Elements:

• Use 'inputOutput' for user interactions or system I/O
• Use 'user' for user/actor specific elements
• Use 'api' for external service connections
• Use 'external' for third-party systems or external dependencies

Decision and Alert Elements:

• Use 'decision' for branching logic or critical choices
• Use 'critical' for important warnings or highlights
• Use 'error' for error states or failure conditions
• Use 'warning' for caution states (less severe than errors)
• Use 'security' for security-related checkpoints or processes

Data Elements:

• Use 'data' for data objects or data flow
• Use 'storage' or 'database' for persistent storage
• Use 'cache' for temporary storage or caching layers

State Elements:

• Use 'start' for process start points
• Use 'end' for process end points
• Use 'success' for successful completion states
• Use 'pending' for waiting or queued states
• Use 'active' for currently running processes
• Use 'complete' for finished processes
• Use 'disabled' or 'inactive' for unavailable elements

Process Types:

• Use 'manual' for human/manual processes
• Use 'automated' for automatic processes
• Use 'async' for asynchronous operations
• Use 'sync' for synchronous operations

System Elements:

• Use 'system' for internal system components
• Use 'network' for network-related elements
• Use 'queue' for message queues or buffers
• Use 'monitoring' for logging or monitoring components

Emphasis Elements:

• Use 'highlight' for temporarily emphasised elements
• Use 'focus' for elements requiring attention
• Use 'selected' for user-selected items

Supporting Elements:

• Use 'secondary' for supporting or auxiliary elements
• Use 'note' for annotations or explanatory text
• Use 'comment' for inline comments or documentation
• Use 'optional' for optional steps or components

Transparency Note

Some classes use transparency via hex alpha values (e.g., #81CCEA55):

• Last 2 digits represent opacity: FF=100%, CC=80%, 99=60%, 66=40%, 55=33%, 33=20%, 22=13%
• Used for: warning, cache, pending, disabled, system, network, queue, highlight states
• This creates visual hierarchy without introducing non-brand colours

Mermaid Rules

• Use <br> instead of \n for line breaks
• Apply standard colour theme unless specified otherwise
• Do NOT use round brackets ( ) within item labels or descriptions
• Mermaid does not support unordered lists within item labels

---

PlantUML Styles

PlantUML Colour Definitions

Apply these at the start of PlantUML diagrams:

!define OCEAN #1E5E82
!define FLAMINGO #D86E89
!define DEEP_OCEAN #002A41
!define SKY_BLUE #81CCEA
!define CLOUD #EEF9FD

skinparam backgroundColor CLOUD
skinparam defaultFontColor DEEP_OCEAN

' Activity Diagrams
skinparam activity {
   BackgroundColor CLOUD
   BorderColor OCEAN
   FontColor DEEP_OCEAN
   StartColor OCEAN
   EndColor DEEP_OCEAN
   BarColor FLAMINGO
   DiamondBackgroundColor SKY_BLUE
   DiamondBorderColor OCEAN
}

' Class Diagrams
skinparam class {
   BackgroundColor CLOUD
   BorderColor OCEAN
   FontColor DEEP_OCEAN
   AttributeFontColor OCEAN
   StereotypeFontColor SKY_BLUE
   ArrowColor OCEAN
   HeaderBackgroundColor SKY_BLUE
}

' Sequence Diagrams
skinparam sequence {
   ParticipantBackgroundColor SKY_BLUE
   ParticipantBorderColor OCEAN
   ActorBackgroundColor CLOUD
   ActorBorderColor DEEP_OCEAN
   LifeLineBorderColor OCEAN
   ArrowColor OCEAN
   GroupBackgroundColor CLOUD
   GroupBorderColor SKY_BLUE
   NoteBackgroundColor CLOUD
   NoteBorderColor FLAMINGO
}

' Component Diagrams
skinparam component {
   BackgroundColor CLOUD
   BorderColor OCEAN
   FontColor DEEP_OCEAN
   InterfaceBackgroundColor SKY_BLUE
   InterfaceBorderColor DEEP_OCEAN
}

' State Diagrams
skinparam state {
   BackgroundColor CLOUD
   BorderColor OCEAN
   FontColor DEEP_OCEAN
   StartColor OCEAN
   EndColor DEEP_OCEAN
   AttributeFontColor OCEAN
}

' Use Case Diagrams
skinparam usecase {
   BackgroundColor CLOUD
   BorderColor OCEAN
   FontColor DEEP_OCEAN
   ActorBackgroundColor SKY_BLUE
   ActorBorderColor DEEP_OCEAN
}

' Error/Warning States
skinparam note {
   BackgroundColor<<warning>> FLAMINGO
   BorderColor<<warning>> DEEP_OCEAN
   FontColor<<warning>> CLOUD
}