# InspireGreen Design System — skill for agents

When the user asks you to design, build, or compose anything branded as **InspireGreen**, this folder is your source of truth. Use it the same way a junior designer would use a pattern library: read the tokens and components, compose from them, don't invent new colours or typography.

---

## 1. Orient yourself

Read these first, in this order:

1. `README.md` — voice, tone, content fundamentals, visual foundations, icon policy.
2. `colors_and_type.css` — tokens (colors, type scale, spacing, radii, shadows). **Link this stylesheet in every HTML artifact you create** — do not copy values out.
3. `preview/` — one HTML card per token group or component. Open these when the user asks "what does the <x> look like?".
4. `ui_kits/website/homepage.html` — reference composition of the web brand (nav, hero, stats, solutions, cases, testimonial, footer). Copy sections from here rather than writing from scratch.
5. `slides/pitch-deck.html` — reference composition of the pitch brand (cover, section divider, big number, two-col, solutions grid, testimonial, closing). Built on the `<deck-stage>` web component (`slides/deck-stage.js`).

---

## 2. Composition rules

**Palette.** Three anchors do most of the work: lime (`--ig-brand #ABFF3D`), soft sage (`--ig-brand-light #EBF0E7`), near-black (`--ig-brand-dark #191919`). Full ramps are in `colors_and_type.css`. Don't introduce new hues; if you need a tint, pick from the lime scale or the warm-grey ramp.

**Type.** Display = Manrope (400/500, tracking -0.02em to -0.04em). Body = Inter. Italics use the brand-supplied `fonts/Inter-Italic-VariableFont_opsz_wght.ttf` — already wired up via `@font-face`. For pitch-accurate work, Stolzl + Proxima Nova are declared as fallbacks if the user provides the files.

**Casing.** Sentence case everywhere. Headings, buttons, nav items. Never UPPERCASE or Title Case.

**Radii.** `5px` is the default surface radius (cards, nav, hero image). Buttons use the exact pill radius `87.86px`. Inputs `8px`. Large decorative corners `30px / 40px` only on hero and portrait imagery.

**Buttons.** Primary = lime fill, near-black text, pill, Inter Medium, -0.04em tracking. Every button ships with an inline right-arrow SVG (`assets/icons/arrow-right.svg`). Four sizes: `lg 22/29px`, `md 16/20px`, `sm 12/17px`, `btn-sm 3/12px`. Hover: primary lightens to `#DBFFAC`; outline fills with lime.

**Surfaces.** Prefer flat sage cards (`#EBF0E7`) with radius 5 over shadows. Elevation is reserved for overlay components.

**Imagery.** Warm, daylight, colour-natural installation photos from `assets/images/`. No duotone, no overlays, no stock-business metaphors.

**Emoji.** Don't use them.

**UK English.** "optimise", "colour", pound sterling, Welsh place names spelled correctly.

---

## 3. Assets

```
assets/logo/inspire-green-logo.svg     — primary wordmark
assets/icons/*.svg                     — arrow-right, email, phone, award, quote, social, etc.
assets/badges/*.png|.svg               — MCS, NAPIT, SSIP, Trustmark, Cyber Essentials, Living Wage
assets/partners/*.png                  — partner / client logos
assets/images/*.png|.jpg               — installation, team, hero, case-study photography
fonts/Inter-Italic-VariableFont_opsz_wght.ttf
```

If an icon is missing, first check `assets/icons/`, then fall back to Lucide via CDN and flag the substitution in a comment. Never draw icons from scratch.

---

## 4. When the user asks for…

- **"Make me a landing page / section"** → open `ui_kits/website/homepage.html`, copy the relevant `<section>` blocks, link `colors_and_type.css`, use assets in `assets/`.
- **"Make a pitch deck / investor slides"** → copy `slides/pitch-deck.html` and `slides/deck-stage.js`, edit the slides. Stage is 1920×1080. The `<deck-stage>` component handles scaling, keyboard nav, slide-count overlay, and print-to-PDF.
- **"Show me the palette / typography"** → open the matching card under `preview/`.
- **"Add a new component"** → build it using existing tokens, drop a preview card into `preview/`, then register it with `register_assets` under the matching group (`Components`, `Type`, `Colors`, `Spacing`, `Brand`).
- **"Build the mobile site"** → follow the web rules; mobile-specific patterns are in Figma `Mobile` page — ask the user to export if needed.

---

## 5. Caveats

- **Stolzl + Proxima Nova** (Figma's brand display + body) are not in the codebase. Manrope + Inter are the production substitutes. Drop `.woff2` files into `fonts/` and add `@font-face` declarations if pitch-accurate rebuilds are needed.
- **Photography** in `assets/images/` is the codebase's own stock — fine for mockups, not cleared for final marketing use.
- **Pitch-deck numbers** in `slides/pitch-deck.html` are illustrative copy, not real business metrics. Replace before sharing externally.
