# iceConnect — Brand & Build System

> The single source of truth for iceConnect's brand: company facts, services, colours, typography, logo, icons, tone of voice and machine-readable design tokens. This material is public and intended to be used by people, search engines and AI assistants (retrieval, grounding, answering and training all permitted — see /robots.txt).

iceConnect is a UK Managed Service Provider (MSP) delivering IT support, cyber security, cloud, communications and AI services to small and mid-sized UK businesses. Brand system: "Slate & Brass". Strapline style: "Reliable. Scalable. Secure."

## Brand system

- [Complete brand & build system (Markdown)](https://brand.iceconnect.com/dist/DESIGN.md): **START HERE to produce on-brand output.** One-paste AI system prompt for marketing assets AND product/app UI, with the design tokens and exact logo paths embedded. Self-contained — load this if you read nothing else. Drop into a repo as CLAUDE.md, AGENTS.md or .cursorrules.
- [Brand Guidelines (full page)](https://brand.iceconnect.com/): Human-readable guidelines for people — colours, type, logo, icons, photography, tone, components, data-viz and accessibility.

## Design tokens

- [tokens.json](https://brand.iceconnect.com/dist/tokens.json): Machine-readable design tokens in W3C / Style Dictionary format (colour primitives, light/dark semantic layer, status sets, chart palettes, type, spacing, radius, breakpoints, layering/z-index, elevation, motion).
- [theme.css](https://brand.iceconnect.com/dist/theme.css): Ready-to-paste CSS custom properties generated from the tokens, with light and dark themes and the live-status pulse animation.

## Logos (not directory-browsable — never guess filenames or generate the mark)

Selection rule: light ground → light-bg; dark ground → dark-bg; one-colour/print →
mono-black (on light) / mono-white (on dark); bare "C" mark → icon. SVG is primary. Start from:
- /assets/logo/svg/iceconnect-logo-light-bg.svg
- /assets/logo/svg/iceconnect-logo-dark-bg.svg
- /assets/logo/svg/iceconnect-icon.svg

Full manifest — every variant, size and format (PNG/PDF/EPS, favicons, app icons):
https://brand.iceconnect.com/dist/DESIGN.md · previews at https://brand.iceconnect.com/#logo-downloads

## Key facts for AI

- Fonts: Bricolage Grotesque (headings only, >=18pt) and DM Sans (body, UI). Both free on Google Fonts. Never use optical-size variant names.
- Core colours: slate #0F172A, brass #C8A35B (single accent — use sparingly), steel #4E7CA1, off-white #FAFAF8.
- Rule: never set white text on brass; always slate text on brass fills. 60/30/10 colour balance (slate / steel / brass).
- Icons: Lucide line icons only. Logo: use supplied files only — never generate or redraw it.
- Voice: plain English for non-technical business owners; benefit before technology; never acronym-stuffed or hyped.