Respira Brand & Design System

This document describes the Respira for WordPress brand and design system. It is structured for AI assistants, crawlers, and developers. The interactive design system loads below via JavaScript.

North Star Principles

The principles that shape every decision across all Respira surfaces — marketing site, docs, cloud dashboard, WordPress plugin, Chrome extension, and AI interfaces.

Personality to UI Behavior

Anti-Patterns (Never)

Unified Family Rule

All six surfaces — marketing site, docs, cloud dashboard, WordPress plugin, Chrome extension, and AI interfaces — use the same tokens, the same typography, the same icon set, and the same motion language. A user moving between surfaces should never feel like they've left Respira.

Testimonials

Trusted by professionals. Sample testimonials: Sarah Jenkins (Nexus Digital Agency) — "Respira is the only AI tool we trust with our clients' sites. The duplicate-before-edit feature means we never risk breaking a live WooCommerce store." Marcus Thorne (GlobalTech Solutions) — "Respira's auditability and strict guardrails made it the only viable choice for our enterprise infrastructure." Elena Rodriguez (Elena Designs) — "Respira actually understands how WordPress builders work. It saves me 15 hours a week."

Color System

Primary: Emerald green #10b981 (heartbeat color). Warm stone neutrals for depth. Semantic: Success #22c55e, Warning #eab308, Error #ef4444, Info #3b82f6. Accents: Amber #f59e0b, Sky #0ea5e9, Violet #8b5cf6, Rose #f43f5e. Dark surface layers: Base #0c0a09, Surface #1c1917, Elevated #1f1e1d, Overlay #182433.

Typography

Display and body: DM Sans. Monospace: JetBrains Mono, Fira Code. Cormorant Garamond for editorial.

Section Layouts

Every section on the page should feel different. Mix layouts so no two consecutive sections share the same structure. Types: Bento Grid, Editorial Split, Flow Diagram, Data Dashboard, Full-Bleed Hero, Horizontal Marquee, Compact Stat Strip. Rules: Never two same layouts back-to-back. Alternate dense and spacious. Every 3rd section a "breathing" moment. Tinted zones create mood shifts.

Background Zones

zone-dark #070a0f (Hero, CTA), zone-elevated #0c1219 (default sections), zone-emerald #f0fdf4 (safety, how-it-works), zone-slate #f1f5f9 (technical), zone-cream #faf7f2 (testimonials). Light sections create contrast and trust. Wave dividers create organic transitions.

Logo & Wordmark

Use logo and wordmark together in headers. Favicon alone for browser tabs, bookmarks, wp-admin sidebar. Never stretch, never recolor. Light background: #fafaf9. Dark background: #0c0a09.