File: docs/BRANDING.md  
Version: v0.3.4  
Last updated: November 2025  
Maintainer: Leak Technologies  
Project: Goondex  

------------------------------------------------------------
Goondex Branding Guide
------------------------------------------------------------

Purpose:  
Define the current visual identity and colour palette for Goondex, including logo interpretation, UI application, and consistency notes. This file is versioned and updated alongside major CLI and UI revisions.

------------------------------------------------------------
Colour Palette
------------------------------------------------------------

Primary Accent: Flamingo Pulse  
Hex: #FF5FA2  
Usage: Core brand colour used in the logo, buttons, and key highlights.

Secondary Accent: Electric Plum  
Hex: #8C2F5C  
Usage: Shadow tone and hover states. Complements Flamingo Pulse.

Highlight Glow: Neon Rose  
Hex: #FF9BCB  
Usage: Used sparingly for glow or gradient highlight effects.

Background (Dark): Deep Charcoal  
Hex: #1E1E1E  
Usage: Main dark-mode background for UI and presentation.

Text (Primary): Soft Porcelain  
Hex: #E9E9E9  
Usage: Default readable text colour on dark backgrounds.

Text (Muted): Ash Gray  
Hex: #B0B0B0  
Usage: Secondary text, metadata, or inactive UI states.

Print Match (CMYK):  
Flamingo Pulse → C:0  M:70  Y:15  K:0

------------------------------------------------------------
Logo Guidelines
------------------------------------------------------------

Wordmark:  
Custom type featuring interlinked "OO" characters that form a playful, anatomical suggestion of breasts.  
The "D" subtly mirrors a phallic shape, continuing the tongue-in-cheek theme.  
The logo remains clean and geometric, ensuring the humour is implied, not explicit.

Primary Colour:  
Flamingo Pulse (#FF5FA2)

Backgrounds:  
Best contrast on Deep Charcoal (#1E1E1E) or near-black backgrounds.

Minimum Spacing:  
Maintain clear space around the logo equal to the height of the "G" on all sides.

Optional Glow:  
Apply Neon Rose (#FF9BCB) outer glow at 10–15% opacity for digital assets only.  
Avoid glow in print use.

------------------------------------------------------------
Typography
------------------------------------------------------------

Preferred typefaces:  
- Montserrat  
- Poppins  
- Satoshi  

Fallbacks:  
- Sans-serif system fonts (Arial, Helvetica, etc.)

All-caps for primary titles and logos.  
Mixed case for documentation and UI elements.

------------------------------------------------------------
UI Application
------------------------------------------------------------

Buttons:  
Flamingo Pulse base colour, with Electric Plum overlay on hover (10–20% opacity).

Links and Highlights:  
Flamingo Pulse.

Cards and Panels:  
Deep Charcoal background with 1px border in Electric Plum (20% opacity).

Headers and Dividers:  
Use Soft Porcelain for text and Electric Plum for thin divider accents.

------------------------------------------------------------
Notes
------------------------------------------------------------

Keep the palette consistent; avoid introducing new accent colours.  
Ensure contrast ratios meet accessibility guidelines.  
When printing, verify Flamingo Pulse tone accuracy using the CMYK approximation listed above.  
Maintain a professional tone with playful undertones. The logo and colour scheme should feel adult, confident, and minimalist — never explicit.

------------------------------------------------------------
End of File
------------------------------------------------------------