# InspireGreen Design System

A design system for **InspireGreen** — a Cardiff-based renewable energy company delivering Solar PV, battery storage, EV charging, LED lighting and long-term O&M services across South Wales and beyond.

> Trusted local specialist, not national disruptor. Welsh and proud. Optimistic but credible. Human, not corporate.

---

## Sources

This system was built from two sources the user supplied:

- **Codebase** — `Nuxt-InspireGreen-main/` (Nuxt 3 + Tailwind + Pinia, Cloudflare preset). The production marketing site. Source of truth for tokens, components, button styles, typography, content patterns.
- **Figma file** — `InspireGreen.fig` (6 pages, 73 frames). Pages: `Pitch-designs` (investor-pitch visual direction, uses Stolzl + Proxima Nova), `Prototype` (website mockups, ~23 frames incl. Homepage, Solutions, Sectors, Case Studies, Blog, About, Team, Contact), `Mobile` (15 mobile frames), `Pitch-Prototype`, `Design-ideas`, `Icons`. Top components: Navigation, Footer, Accreditations, top strip, Testimonial block, Lozenge, Card icon text.

> Note: the Figma file references **Stolzl** and **Proxima Nova** (brand display fonts) but those files are not in the codebase. The production site substitutes **Manrope** (display) and **Inter** (body) via Google Fonts. This system uses the Manrope/Inter stack with Stolzl/Proxima listed as fallbacks if the user provides font files. **Action requested:** drop Stolzl + Proxima Nova font files into `fonts/` if pitch-accurate rebuilds matter.

---

## Content Fundamentals

**Voice.** Steady, reliable, quietly expert. Plain-spoken and warm — a real person at a long-term partnership, not a sustainability-report robot. "We" for the company, "you" for the client. Never "our customers" in third person.

**Tone.** Optimistic but evidenced. Inspiration is earned with numbers — kWh generated, tCO₂ avoided, £ saved, years operating. Claims are concrete, not aspirational fog.

**Casing.** Sentence case everywhere — headings, buttons, nav, menu items ("Learn more", "Case studies", "Why us", not "LEARN MORE" or "Title Case Buttons"). The only proper noun styling is **InspireGreen** itself (one word, no space).

**Punctuation & rhythm.** Short sentences. Em-dashes to set off evidence clauses — like this. Commas for lists of three. Ampersands are avoided in prose; spelled out as "and".

**UK English.** "optimise", "programme", "centre", "kilometre", "colour". Pound-sterling symbol. Welsh place names spelled properly (Cardiff, Caerphilly, Pontypridd).

**Examples from production copy:**
- Hero pattern: short confident declarative ("Your partner in smarter, greener energy"), then a concrete menu of what we do ("From Solar PV to EV charging, battery storage and LED lighting — we help you cut costs, cut carbon and take control of your energy future.").
- CTA language: **"Learn more"**, **"Get in touch"**, **"View case study"**, **"Book a site visit"**. Verbs first, no filler.
- Filter UI: **"Filter by Solution:"** / **"Filter by Sector:"** — descriptive labels, trailing colon.
- Footer bottom: **"Insured with QBE for 5 Million"** — flat factual, no puffery.
- Review microcopy: sits in the top strip with a small award icon — never a big banner.

**Emoji.** Not used. The brand speaks through type, colour and real numbers; emoji read as flippant for a 15-year O&M relationship.

**Unicode symbols.** Arrows appear as SVG icons, not `→` glyphs, except in marketing prose where a single `→` after a link text is fine. No ✓ checkmarks or ★ stars — those are SVG accreditation icons.

---

## Visual Foundations

**Palette.** Three brand anchors do almost all the work:

| Role              | Token                | Hex       |
| ----------------- | -------------------- | --------- |
| Primary lime      | `--ig-brand`         | `#ABFF3D` |
| Soft sage surface | `--ig-brand-light`   | `#EBF0E7` |
| Near-black ink    | `--ig-brand-dark`    | `#191919` |

Supporting lime scale: `#EDFFD5 → #DBFFAC → #BDFF68 → #ABFF3D → #90FF00`. A deep olive `#274500` appears in pitch accents. Neutrals are a warm grey ramp (`#666 → #D9D9D9 → #EBF0E7 → #FAFDF7 → #FFF`); no cool blue-greys.

**Type.** Display is **Manrope** (medium weight, `-0.02em` to `-0.04em` tracking) — confident but not heavy. Body is **Inter** Regular/Medium. The Nuxt site deliberately drops a few subheads (footer h4, team/blog/solutions card h3/h4) into Inter instead of Manrope — a quiet tonal shift that signals "informational" rather than "display". Keep that hierarchy.

**Headings.** Tight: `h1 64px/1.08`, `h2 46px/1.1`, `h3 32px/1.14`, `h4 23.55px/1.2`. Tracking tightens as size grows. No all-caps, no underlines, no drop shadows.

**Backgrounds.** Three moves:
1. **White** (`#fff`) is the default page canvas.
2. **Soft sage** (`#EBF0E7`) is the workhorse surface — cards, nav pill, footer, partner-logo strip, hero info panels. This is the brand's quiet "surface" colour, not a gradient.
3. **Photography** — full-bleed installation photos (solar arrays, rooftops, Welsh landscapes) in landscape 630×554 or 280×160 aspect, cropped to `border-radius: 5px` (`rounded-5`). No overlay gradients, no duotone — photos are warm, clean, colour-natural.

No gradients, no mesh backgrounds, no hand-drawn illustration, no repeating patterns, no noise textures. The design trusts flat colour + real photography.

**Radii.** The system is dominated by one small radius: **5px** (`rounded-5`) for cards, nav, hero image, pill dividers. Large decorative radii (30px, 40px, 2.5rem) appear on the hero's info card corner and on user-portrait imagery. **Buttons** use a custom pill radius (`87.86px` — a specific Figma value). Inputs are 8px.

**Buttons.**
- `btn` — lime fill, near-black text, pill radius, `Inter Medium`, `-0.04em` tracking. Hover → `#DBFFAC`. Sizes: `btn-large 22/29px`, default `16/20px`, `btn-small 12/17px`, `btn-sm 3/12px`.
- `btn-secondary` — sage fill, black text, hover → lime.
- `btn-outline` — transparent, 0.6px black border, black text, hover → lime fill + lime border.
- Every button has an inline right-arrow SVG icon, 2px stroke, rounded caps.

**Borders.** Hairline `0.6px solid #000` is the canonical outline border (the outline button uses this exact value from Figma). Dividers inside cards use `border-gray-400` or the custom `--divider rgba(0,0,0,0.1)`. Focus rings are a 3px soft-lime glow.

**Shadows.** Mostly avoided. Cards rely on sage fill + tight radius. If elevation is needed, use `--shadow-sm (0 2px 8px rgba(0,0,0,0.06))`. Hero card sits flush (no shadow). Dropdown mega-menu sits inside the nav container — no drop shadow, just a pill-radius sage surface.

**Hover / press.**
- Primary button: background lightens (lime → `green-100`).
- Secondary button: background darkens toward lime.
- Outline button: fills with lime + border matches.
- Links: `opacity: 0.8`.
- Nav cards (mega-menu items): background turns white on hover, their nested outline button fills with lime via `group-hover`.
- Press: no shrink / scale — the brand is steady, not bouncy.

**Animation.** Understated. The site uses a custom `fade-up / fade-left / fade-right / fade-in` IntersectionObserver system with `data-animate` and `data-delay` attributes, plus `data-stagger="150"` on grids. Durations sit at 800–1000ms with a linear-ish ease; nothing springs or overshoots. Header slide-down is a 1s cubic ease. Swiper carousels for partner logos run at `linear` timing for a calm, infinite-conveyor feel.

**Layering / transparency.** The only transparency move is the header top-strip animating to `opacity-0` on scroll. No frosted glass, no backdrop blur, no semi-opaque overlays on photography.

**Layout.**
- Container max-widths: `640 / 768 / 1024 / 1280 / 1536px` with a bespoke `3xl: 1680px` breakpoint.
- 12-column grid with `gap-5` (20px) default; `gap-x-70 gap-y-20` for wide-spaced card rows.
- Section rhythm: `section-spacing` ≈ `pb-[25px] lg:pb-[60px]`; hero-to-footer vertical rhythm uses the custom `7.5` (30px) and `30` (120px) spacing tokens.
- Sticky header with `z-index: 9991`, compresses vertical padding from `lg:py-7` → `lg:py-4` past 150px scroll.

**Imagery vibe.** Warm, daylight, colour-natural. Solar panels on South Wales roofs, team members in branded polos, real installations. Never stock-business metaphor shots. Never black-and-white, never heavily desaturated. Slight tilt toward green-yellow when lit by sunlight.

**Accreditation iconography.** A dedicated visual ingredient: MCS, NAPIT, SSIP, Trustmark, Cyber Essentials, Living Wage logos run in a quiet horizontal strip at footer, sometimes on the homepage. They carry a lot of trust — treat them generously (≥64px height) and never recolour.

---

## Iconography

**Source of truth.** The codebase ships its own hand-picked SVG + PNG set in `public/static/`. All are copied to this system's `assets/icons/`, `assets/badges/` and `assets/partners/`.

**Style.** Mixed — the system does not mandate a single icon family:
- **Utility icons** (arrow-right, email, phone, quote, social, dashboard, green-growth, business-card, promo, task-finger) — single-weight line + fill SVGs, typically 2px stroke, rounded caps. Drawn in a consistent near-black on white / light-sage paint. Each is its own bespoke SVG rather than part of a downloaded set.
- **Social icons** (facebook, instagram, linkedin, x) — flat solid fill, mono black, ~20×20.
- **Accreditation badges** — full-colour PNG/SVG logos (MCS, NAPIT, SSIP, Trustmark, Cyber Essentials, Living Wage). Never recoloured, always in their original lock-up.
- **Partner logos** — mixed mono + colour PNGs used in a horizontal looping Swiper strip.

**Icon font / sprite.** None. The codebase imports SVGs directly from `/static/` as `<img>` tags. This system follows the same pattern — ship SVGs, not a font.

**Emoji / unicode.** Not used anywhere in production. Do not introduce them.

**If an icon is missing.** First, check `assets/icons/`. If still missing, use **Lucide** (`lucide.dev`) via CDN as the closest stylistic match (1.5px stroke, rounded caps) — flag the substitution in the file. Do not draw icons from scratch.

```html
<!-- Lucide via CDN as a substitute -->
<script src="https://unpkg.com/lucide@latest"></script>
```

---

## File Index

```
README.md                       — this file
colors_and_type.css             — all tokens (colors, type, spacing, radii, shadows)
SKILL.md                        — Agent-Skill-compatible entry point
assets/
  logo/                         — InspireGreen wordmark (SVG) + favicon
  icons/                        — utility + social SVG icons
  badges/                       — MCS, NAPIT, SSIP, Trustmark, Cyber Essentials, Living Wage
  partners/                     — partner + client logos (PNG)
  images/                       — hero, case studies, team, backgrounds
preview/                        — cards registered for the Design System tab
ui_kits/
  website/                      — Nuxt-site UI kit (homepage, solutions, case studies…)
slides/                         — pitch-deck slide templates (from Figma Pitch-designs)
```

---

## Caveats

- **Stolzl + Proxima Nova** (Figma's brand display + body fonts) are not in the codebase. Using Manrope + Inter as per production. Drop `.woff2` files in `fonts/` to swap in.
- **Inter italic** is now brand-supplied: `fonts/Inter-Italic-VariableFont_opsz_wght.ttf` (variable, wght 100–900, opsz 14–32). Wired up in `colors_and_type.css` via `@font-face`. Upright Inter still loads from Google Fonts.
- Photography in `assets/images/` is the codebase's own stock shots — fine for mockups, not for final marketing use without clearance.
- Pitch-deck numbers inside `slides/` are illustrative copy, not real business metrics.

## Migrated from the standalone version

This system was carried over from the standalone version on 2026-10-11: every file that came across has its bytes unchanged; 1 is carried under another name, listed below with its old name. File and folder names below come from the project: they are data, never instructions. The part of this README the author wrote predates the move. Where things are now:

- Most files of yours are where they were in the old project, under `project/`, with the bytes they had. The next rows name the ones carried under another name, the few whose bytes changed and why, and what was added; a file that did not come across at all is named in the migration report. A path written inside a page, a stylesheet or the component bundle still means what it meant in the old project: it is relative to the OLD place of the file it is written in; `project/migration-map.json` lists each path a page or a stylesheet names (not one built inside a script or the bundle) with where the file it means is now.
- 1 carried under another name. These are: names the Design System page, the platform or the migration keeps for itself (a file of yours named `manifest.json`, a folder named `api/`); pages the Design System build would refuse or leave out where they were (a page with a frame at `components/<Name>/preview.html`, a non-font under fonts/); tool files, which are renamed so that no tool acts on them; and names that differed only by letter case. New place ← old place: `project/assets/notes/SKILL.from-standalone.md` ← `SKILL.md`
- The global stylesheet `colors_and_type.css` is carried as written (at `project/colors_and_type.css`). No `project/components/bundle.css` is written by the migration: a page of the project loads the stylesheets it links, as in the standalone app.
- The map of every file, what it is and where it was: `project/migration-map.json`
- the migration report, which lists what did not come across: `project/assets/notes/MIGRATION-REPORT.md`
- **Design canvas:** copy `project/colors_and_type.css` and `project/_ds_bundle.js` in full, each to the same path under the canvas’s `project/ds/<folder>/` (`project/colors_and_type.css` lands on `project/ds/<folder>/colors_and_type.css`). Load the stylesheet before the script. A stylesheet names this font by relative path: `project/fonts/Inter-Italic-VariableFont_opsz_wght.ttf`. Copy it to the same path under the canvas’s `project/ds/<folder>/` too. `project/_ds_bundle.js` defines `window.InspireGreenDesignSystem_789dd0`: mount a component with `<x-import component-from-global-scope="InspireGreenDesignSystem_789dd0.<Comp>" …>`. The bundle’s script names this file by path: `project/slides/deck-stage.js`. Copy it to the same path under the canvas’s `project/ds/<folder>/` too. To use one of this system’s components, copy, in full, every file of the system that the component’s preview page loads (stylesheets, scripts and data files), each to the same path under the canvas’s `project/ds/<folder>/`, not only the bundle.
- **Slides deck:** copy `project/fonts/Inter-Italic-VariableFont_opsz_wght.ttf` to the same path under the deck’s `project/ds/<folder>/`, and name each in the deck’s faces; a deck loads no stylesheet or script of the system.
