Aquiva Brand Book

The Aquiva brand and design system — colour, type, components, and usage. Generated from the design system; always current.

Cover (light)

Open “Cover (light)” in a new tab

Iconography

Open “Iconography” in a new tab

Logo — primary

Primary mark · Aquiva
Color
On cream
Inverse
The Aquiva A. Two stacked forms — a triangular A with a counter shaped like a lower triangle, sitting on a horizontal base bar. Vector lifted from the Figma file (Logo_sign_color).

Brand orange #ED7F20 on white is the canonical color treatment. On dark surfaces, use the inverse white mark on deep indigo #0C1F4F.

Clear space ≥ 1× mark height. Min size 24 px digital · 8 mm print.

Logo — SVG sources

Wordmark · indigo on white
Monochrome gray · cream bg
White on deep indigo

Logo — versions

Wordmark · size lockups
S · default lockup · 296×64 vector · logo-wordmark-indigo.svg
XS · small-size lockup · 148×32 vector · logo-wordmark-xs.svg
Two lockups. The XS isn’t a downscale of S — the path data is redrawn with thicker strokes and tighter joins to stay legible at 12–24 px. Use it for app chrome, dense nav bars, footer credits, favicons, email signatures.

Switch to S above 24 px, or whenever the logo carries the layout. Below 12 px, prefer the standalone A-sign (square mark) over either wordmark.

Photography

1 · opacity 70%
2 · blue filter
3 · gradient filter
Three treatments for stock photography: reduced opacity, blue overlay, or brand gradient. Always cool-toned.

Voice & tone

Voice · concrete enumeration · first person plural · no jargon
DO

"We build durable solutions and products: components you can reuse, tests that catch regressions, and code your team can own after we leave."

DON'T

"We leverage synergies to drive transformative value."

DO

"We build software inside your org with your data model, permissions, and audit trail."

DON'T

"We ship in days, not sprints."

Colors & type

Colors · Brand core
Cornflower Blue
Primary · 50–60%
#5A99E6
Jackson Purple
Secondary · 40%
#352694
Cerise Red
Accent · 10–20% · never bg
#E01F6F
Light Violet
#E3E8FD
Light Blue
#D9EBFF
Light Grey
#F4F4F6
Ink
#423C4C
Type · Families & scale
Display
Lexend 500
56 / −.01em
The AI-native partner for growth companies.
Heading
Lexend 600
28 / 1.2
Consulting and engineering, rebuilt around AI.
Body
Open Sans 400
15 / 1.55
We help enterprise teams, scaling technology companies, and ISVs turn their core applications into operational platforms. Software that ships but doesn't get used isn't software yet.
Eyebrow
Lexend 600
11 / .16em
Who we serve
Numerals
Lexend Light 300
72 / −.025em
98%

Colors — Backgrounds

Light Blue
Section bg
#CEE0F8
Light Violet
Feature bg
#E3E8FD
White
Surface · card
#FFFFFF

Colors — Gradients

Brand gradient · blue → purple
linear-gradient(135deg, #5A99E6, #352694)
Warm gradient · purple → pink
linear-gradient(135deg, #352694, #E01F6F)
Full spectrum · blue → purple → pink
linear-gradient(135deg, #5A99E6, #352694, #E01F6F)

Colors — Neutrals

Ash Gray
Body text
#423C4C
Gray
Logo · UI
#737474
Light Gray
Headers · 4th
#9E9E9E
Soft Gray
Page bg
#F6F7F9

Colors — Primary

Cornflower Blue
Primary · 50–60%
#5A99E6
Jackson Purple
Secondary · 40%
#352694
Cerise Red
Accent · 10–20% · never bg
#E01F6F

Colors — Ratio

Ratio · 50–60 / 40 / 10–20
Blue 55%
Purple 30%
Pink 15%

Blue leads every composition. Purple supports without overtaking. Pink sparks — icons, quote marks, a single highlighted word — but never a background.

Colors — Warm

Warm accents · Figma-derived · use as illustration fills & featured backgrounds
Peach
Illustrations
#F5C7A3
Orange
Emphasis · icons
#ED7F20
Cream
Featured bg
#F9F5F0
Deep Indigo
Hero · footer
#0C1F4F

Dark surfaces

surface-dark-1
Jackson Purple · #352694
surface-dark-2
Deep Indigo · #0C1F4F

Primary text — --on-dark-1

Secondary text — --on-dark-2 (white 78%)

Tertiary / captions — --on-dark-3 (white 52%)

--border-dark hairline (white 14%)

Headline accent

Headline emphasis · pink, never italic

The AI-native partner for growth companies.

Consulting and engineering, rebuilt around AI.

Use <em> inside any heading — the brand stylesheet renders it pink, weight 500, never italic. One accented phrase per headline.

On dark — accent stays pink

Salesforce at the core. AWS, Azure, and GCP around it.

Type — Body

EYEBROW · LEXEND MEDIUM 11 / 0.12EM

Lead. Open Sans 18/28. By the end of week one, you're usually clicking through a working prototype.

Body. Open Sans Regular 16/26. Growth companies bring us problems that rarely line up with a vendor's product taxonomy.

Caption · Open Sans 13 / Light Gray

Type — Display

Display · Lexend
The AI-native partner
for growth companies.
Lexend 50056 / 59tracking −0.01em

Type — Headings

Headings · Lexend
H1 · Page title
H2 · Section header in blue
H3 · Lexend SemiBold
H4 · Lexend SemiBold 20

Type — Numerals

Stats · Lexend Light 72–96 pt
10
Market Experience
1800+
Certifications
200+
Projects Delivered
4.95
CSAT / 5
87%
Pilots to production

Type — Quote

Our job is to help customers build what comes next and make sure it actually works in production, not just in the demo.
Jay Keating · CEO, Aquiva

Radii

Radii
xs · 4
sm · 8
md · 12
lg · 16
xl · 24
pill

Shadows

Soft, purple-tinted shadow system
xs
sm
md
lg

Spacing scale

Spacing · 4-px base · 8-px grid
s-14 px
s-28 px
s-312 px
s-416 px
s-624 px
s-832 px
s-1248 px
s-1664 px
s-2496 px

Core components (React)

Open “Core components (React)” in a new tab

Badges & tags

Badges
Salesforce Select Partner Advisory New Product Development Expert Navigator SOC 2 Compliant
LatAm CWE SEE USA

Buttons

Light surface · primary + ghost .aq-btn-primary · .aq-btn-ghost
Default
Hover
Active
Focus
Disabled
On dark · primary + ghost .aq-btn-primary-on-dark · .aq-btn-ghost-on-dark
Default
Hover
Focus
Sizes & affordances .sz-sm · default · .sz-lg
Sizes
With icon
Trailing →

Cards

Cards · white on soft gray
Proactive & Engaged

We operate as a true partner, bringing curiosity and commitment to every engagement.

Growth Minded

We love what we do and embrace an explorer's mindset as we master our craft.

Responsible & Honest

We do what we say — trust through transparency, dialog, and integrity.

Code / terminal

sapim · tail -f /var/log/integrations ● LIVE
04:11:58[OK]integration.rainfocus 4,218 req/min · p95 142ms
04:12:09[WARN]webhook.attendee · 38% 4xx rate detected
04:12:09[INFO]→ baseline deviation: +340% (threshold 150%)
04:12:10[ACTION]→ agent.sapim dispatched · case created
04:13:02[OK]webhook.attendee · re-enabled · 620 req/min

Form inputs

Inputs · radius 10 · focus ring rgba(90,153,230,.25)

Marketing page

Open “Marketing page” in a new tab

Capabilities deck

Open “Capabilities deck” in a new tab

Slide library

Open “Slide library” in a new tab

Kits — overview

Aquiva UI Kit

The complete design system for Aquiva surfaces -- slides, marketing, and brand foundation -- in one place. Two surface kits share one set of brand tokens.

Reference deliverables (open these first)

The fully-populated reference files. Open one, fork it, rewrite the content.

  • Aquiva Sample Deck -- a real 56-slide capabilities deck about Aquiva. Mission, AI POD methodology, RainFocus customer story, team pod, joint roadmap. Every layout in the system is exercised at least once. The easiest place to start a new deck.
  • Aquiva Sample Page -- the full aquiva.com structure rebuilt with the marketing kit. Reference for what a complete site assembly looks like.
  • Slide Library -- every slide layout, empty, with placeholder content. The designer's swatch book; pick a layout, copy its block out, fill it in.

Slides kit

Fixed-canvas presentation system, 1920x1080, scaled by <deck-stage>.

File What it is
slides/README.md Slide kit reference -- layout inventory and prop signatures
slides/deck-stage.js Web component that scales + navigates the deck
slides/slide-primitives.css Shared styles for all layouts
slides/layouts/cover.jsx A. Cover, agenda, section dividers, thank-you, questions
slides/layouts/stats.jsx B. Hero stats, big numbers, callouts
slides/layouts/content.jsx C/D. Mission, values, body content, bullets, highlights
slides/layouts/people.jsx E. Team intros, org chart, anniversaries, roles
slides/layouts/process.jsx F/G. Methodology, timeline, sprint cycle, quotes
slides/layouts/customer.jsx H/I. Customer overview, case study, three pillars, products
slides/layouts/devices.jsx J/K/L. Mockups, charts, mind maps, Sinek why-how-what
slides/layouts/primitives.jsx Shared building blocks (Slide, Title, Body, Footer, Wordmark)

Marketing kit

Responsive marketing-site components. Designed at 1280-1600 width.

File What it is
marketing/README.md Marketing kit reference -- component inventory
marketing/components.jsx Original kit: NavBar, Hero, StatsBand, CoreValues, Services, QuoteSection, ContactSection, Footer
marketing/web-sections.jsx Extended kit: pillars, engagement table, pipeline, industries, ISV, sAPIm, proof, testimonials, perspectives

Brand foundation

Lives at the project root, used by both kits.

File What it is
/colors_and_type.css Color tokens, font stacks, type scale -- the source of truth
/assets/ Logos, photography, brand artwork
/fonts/ Lexend + Open Sans + JetBrains Mono

Brand rules

  • Colors -- pink, blue, purple, deep purple, warm cream. One accent per surface, not all four. Never invent new ones; pull from colors_and_type.css.
  • Type -- Lexend for display + headings, Open Sans for body, JetBrains Mono for code or labels. Never substitute Inter, Roboto, or system stacks.
  • Layout -- slides are fixed 1920x1080 and scale via <deck-stage>; marketing pages are responsive but assume a 1280-1600 design width.
  • Imagery -- placeholders are fine in drafts; swap in real photography and product screenshots before publishing. Don't draw "iconographic illustrations" in SVG.

Marketing UI Kit

Pixel-friendly recreation of Aquiva's marketing surface -- built from the brandbook's visual rules and the canonical aquiva.com structure.

Files

File Description
Aquiva Sample Page.html Full assembled marketing page (1:1 site port -- nav, hero, stats, services, table, pipeline, industries, ISV, sAPIm, proof, testimonials, perspectives, footer)
components.jsx Foundational components (nav, hero, stats, values, services, quote, contact, footer)
web-sections.jsx Larger composed sections specific to the full-site port (engagement table, pipeline, industries, sAPIm band, proof cases, testimonials row, perspectives grid, closing band)

Components exported to window

Foundational (components.jsx)
  • WebNavBar -- sticky top nav with logo, links, primary CTA
  • WebHero -- gradient hero with optional right-side card (live agent log on the sample page)
  • TaglineBand -- full-bleed display tagline
  • PillarsFour -- 4-up numbered pillars (AI Native, Product Grade, Acceleration, Outcome Obsessed)
  • TrustedBy -- logo strip
  • ServicesSix -- 3x2 services grid
  • WebFooter -- dark footer with columns
Composed sections (web-sections.jsx)
  • EngagementTable -- pricing-style comparison with one column highlighted (AI POD)
  • PipelineSection -- 5-stage horizontal pipeline with per-stage activities + stats foot
  • IndustryGrid -- 4 industry cards + ISV gradient tile
  • IsvStrip -- full-bleed dark band linking to ISV practice
  • SapimSection -- sAPIm product callout with live-tailing terminal
  • ProofCases -- 4-card customer proof grid
  • TestimonialsRow -- 3-quote testimonial row
  • PerspectivesGrid -- 3-card editorial / blog grid
  • ClosingBand -- dark CTA band before footer

Caveats

  • No codebase or Figma was shared; layout is inferred from the brandbook's "Who we are" core-values screenshot, the aquiva.com structure described in our intake, and general SaaS marketing conventions matched to brand rules.
  • Service blurbs and customer proof are representative. Confirm copy with stakeholders before publishing.
  • Customer logos in TrustedBy and ProofCases are placeholder marks -- swap in the real artwork when provided.

v1.1 — token alignment (April 2026)

After the v1 marketing site review, headline emphasis was migrated from <em style={{ fontStyle: 'italic', color: 'var(--aq-pink)' }}> to plain <em> — the colors_and_type.css rules now style the accent automatically (pink, weight 500, never italic). Two intentional non-pink emphases (the hero "AI-native" in light blue and the closing "Aquiva" in white) keep inline overrides with fontStyle: 'normal'.


Aquiva Slide Layouts

Comprehensive library of slide layouts derived from uploads/Aquiva - Slides Template _ 2026.pdf (163 slides).

All layouts are built as React JSX components targeting 1920x1080 slides, and use the shared brand tokens from colors_and_type.css.

Layout taxonomy

A. Cover & navigation
  • CoverSlide -- title cover ("The AI-native partner for growth companies.")
  • SectionDivider -- transition slide w/ left-aligned title and small all-caps subhead
  • Agenda -- 1-10 numbered items + page numbers
  • ThankYouSlide -- 1-3 presenters with name/title/email
  • QuestionsSlide -- single big "Questions?" prompt
B. Hero stats / company overview
  • GlobalReachSlide -- 5-stat row + region list + Salesforce/client logos
  • BigNumberSlide -- single huge numeral with subhead
  • StatsRow -- 2- or 3-column big stats with explainers
  • StatPercent -- single big % statistic with citation
  • StatPercentMulti -- 2- or 3-row big % statistics
C. Mission & values
  • CoreFocusSlide -- short mission statement
  • MissionSlide -- paired headline + body
  • ValuesIntroSlide -- values intro
D. Content layouts
  • BulletsTwoCol -- 2-column titled bullet groups
  • BulletsFourCol -- 4-column titled bullet groups
  • SixSectionGrid -- 6-section text grid (3x2)
  • NumberedTextSlide -- large numeral + content
  • TextHighlight -- body + 1 big highlight
  • TextTwoHighlight -- body + 2 stacked highlights
  • TextWithImage -- body + image (left or right)
E. People
  • TeamIntroRow -- 5/6 person row with role/name/details
  • TeamStructureOrg -- leader at top + reports tree
  • TeamGrid -- 6/7 person grid (no leader)
  • AnniversariesGrid -- celebration grid
F. Process & timeline
  • WinsStepsSlide -- 1st/2nd/3rd step -> result
  • ProcessFan -- step -> step -> branching results
  • TimelinePhases -- horizontal phased timeline w/ weeks + activities
  • SprintCycleSlide -- circular 4-phase sprint cycle
  • ThreePhaseApproach -- 3-column phased approach
  • MethodologySlide -- 5-stage methodology row
G. Quotes
  • BigQuote -- full-bleed pull quote
  • PersonQuote -- person photo + quote + attribution (leadership-testimonial style)
H. Customer & case study
  • ChallengeSolutionAbout -- 3-column case study
  • CustomerOverviewSlide -- Objective / Tech Stack / Desired State / Business Units
  • ThreePillars -- 3 vertical text pillars
  • RolesMatrix -- Functional / Technical role groupings
I. Product & capability
  • SFProductsGrid -- Salesforce products icon grid
  • CapabilitiesWheel -- radial capabilities map
  • UseCaseColumns -- 3 use cases each with prompt/actions
  • TwoLineCallouts -- 3 stacked stat callouts
J. Devices & screenshots
  • FullScreenshotSlide -- full-bleed screenshot
  • ScreenshotWithDetails -- single screen + details
  • MultiScreenshotGrid -- 2x2 screenshot grid
  • DeviceMockup -- laptop / desktop / tablet / mobile bezels with placeholder
K. Charts & data
  • DonutChartSlide -- donut with legend
  • BarChartSlide -- horizontal bar chart
  • MindMapSlide -- radial mind map
  • RoadmapNowNextLater -- 3-column roadmap
  • KanbanSlide -- Backlog / In Design / In Progress / Completed
  • GanttSlide -- feature lanes by month
L. Strategy frameworks
  • WhyHowWhat -- Sinek-style 3 concentric questions
  • ProductStrategyQuad -- 2x2 strategy quad

Files

  • deck-stage.js -- slide deck shell (scaling, nav, speaker notes)
  • slide-primitives.css -- base CSS for the 1920x1080 frame and shared elements
  • layouts/primitives.jsx -- shared building blocks (Slide, SlideHeader, SlideFooter, SlideBody, Title, Subtitle, Eyebrow, Pill, NumBadge, PhotoPH, Wordmark, BulletList, Arrow, CornerGlow, Stat, ...)
  • layouts/cover.jsx -- A. Cover & navigation
  • layouts/stats.jsx -- B. Hero stats / company overview (incl. TwoLineCallouts)
  • layouts/content.jsx -- C. Mission & values + D. Content layouts
  • layouts/people.jsx -- E. People
  • layouts/process.jsx -- F. Process & timeline + G. Quotes
  • layouts/customer.jsx -- H. Customer & case study + product grid (SFProductsGrid, UseCaseColumns, CapabilitiesWheel)
  • layouts/devices.jsx -- J. Devices & screenshots + K. Charts & data + L. Strategy frameworks

Usage

<link rel="stylesheet" href="../../colors_and_type.css">
<script src="https://unpkg.com/react@18.3.1/umd/react.development.js"></script>
<script src="https://unpkg.com/react-dom@18.3.1/umd/react-dom.development.js"></script>
<script src="https://unpkg.com/@babel/standalone@7.29.0/babel.min.js"></script>
<script src="ui_kits/slides/deck-stage.js"></script>

<script type="text/babel" src="ui_kits/slides/layouts/primitives.jsx"></script>
<script type="text/babel" src="ui_kits/slides/layouts/cover.jsx"></script>
<!-- ...other layouts -->

<deck-stage>
  <section><div id="slide-1"></div></section>
  <!-- ... -->
</deck-stage>

<script type="text/babel">
  ReactDOM.createRoot(document.getElementById('slide-1')).render(<CoverSlide title="..." />);
</script>

Components — usage

Brand pill button — use for every call-to-action; pick the *-on-dark variants on dark hero/footer sections.

<Button variant="primary" size="md" onClick={save}>Talk to us</Button>
<Button variant="ghost">Explore</Button>
<Button variant="primary-on-dark" as="a" href="/contact">Start a conversation</Button>

Variants: primary (blue, darkens to purple on hover), ghost (outline), primary-on-dark (white fill), ghost-on-dark (white hairline). Sizes: sm · md · lg. Pass icon / iconRight for inline glyphs. One primary button per view; keep labels short and in sentence case.


Small pill badge / tag for statuses, categories, and metadata.

<Badge variant="blue">Salesforce</Badge>
<Badge variant="pink">New</Badge>
<Badge variant="neutral">Draft</Badge>

Variants: blue · purple · neutral (soft, everyday) and pink · solid (high-emphasis — use sparingly, pink stays within the 10–20% accent budget).


Surface card for grouping content — feature blocks, stats, list items.

<Card tone="surface" hover>
  <Eyebrow>Services</Eyebrow>
  <h3 className="aq-h3">Salesforce</h3>
  <p className="aq-p">Salesforce, end to end.</p>
</Card>

Tones: surface (white, default), violet / blue (soft feature backgrounds), cream (warm editorial). Shadows are always soft and purple-tinted — never a hard black or a colored left-border stripe. Set hover for the lift interaction.


All-caps overline label that sits above a heading or section title.

<Eyebrow>What we are</Eyebrow>
<h2 className="aq-h2">The AI-native partner for growth companies.</h2>

Uses the .aq-eyebrow recipe (Lexend Medium, 12px, tracked, muted gray). Keep it to 1–3 words.


Single-line text field with optional label and hint.

<Input label="Work email" type="email" placeholder="you@company.com" />
<Input label="Company" hint="As it appears on your contract" />

Focus shows the brand blue 3px outer glow (--shadow-focus). Pairs with Button for forms. Use sentence-case labels.


Signature stat block — lead with a big Lexend Black numeral, single-word label beneath.

<Stat value="1800+" label="Certifications" />
<Stat value="4.95/5" label="CSAT" color="pink" align="center" />
<Stat value="200+" label="Projects Delivered" color="white" />  {/* on dark */}

Use color="white" on dark surfaces. Keep labels to one word where possible. Numbers are factual and impressive — never invented filler.

Getting started

aquiva-design-system v2026.6.2

"The AI-native partner for growth companies."

The brand system for Aquiva, the AI-native consulting and engineering partner for growth companies. The look is cool, calm, professional: cornflower blue and jackson purple with a cerise-red accent, geometric Lexend headlines over humanist Open Sans body text.

Use this system to produce well-branded artifacts — marketing pages, decks, prototypes, sales collateral — without re-deriving brand rules each time. It ships ready-to-use tokens, fonts, React components, and full kit surfaces as a Claude plugin: versioned in GitHub, reviewed via Pull Requests, and installable into Claude Code and Cowork. One version covers everything — the design system, the plugin, and the GitHub release.


Brand book site

The whole system is also published as a single-page brand book — a public, navigable site generated from this repo (tokens, preview cards, component docs, and the skill), with a client-side Download PDF. It is built by npm run build:site (output in site/, gitignored) and deployed on Vercel, which auto-deploys on every push to main, so the canonical URL never drifts from the repo. Nothing is authored twice — the book is regenerated from source.

Figma: designers pull these tokens into Figma with Tokens Studio, pointed at colors_and_type.css (the :root custom properties are the source of truth). The system does not ship a synced Figma file — colors_and_type.css is the contract.

What's in here

Aquiva Design System
├── README.md                  ← you are here: brand rules + how to use the system
├── styles.css                 ← root entry (imports tokens + slide primitives)
├── colors_and_type.css        ← all CSS tokens (:root) + semantic classes
├── fonts/                     ← Lexend, Open Sans, JetBrains Mono (variable .ttf)
├── assets/                    ← logos, icons, imagery
│   ├── logo-wordmark-indigo.svg         ← wordmark on light bg (deep indigo)
│   ├── logo-wordmark-monochrome.svg     ← wordmark, gray treatment
│   ├── logo-wordmark-gray-blue.svg      ← gray wordmark, blue underline
│   ├── logo-wordmark-white.svg          ← wordmark on dark bg
│   ├── logo-wordmark-xs.svg             ← small-size lockup (12–24 px)
│   ├── logo-color.svg / logo-color-no-bg.svg   ← A-sign mark
│   ├── icons/                           ← icons.jsx (Lucide-based set) + README
│   ├── customers/                       ← customer logos (used by the slides kit)
│   ├── partnership/                     ← partner badges (used by the slides kit)
│   └── salesforce.md                    ← how to fetch Salesforce brand assets (not vendored)
├── components/
│   └── core/                  ← React primitives: Button, Badge, Card, Stat, Eyebrow, Input
│       ├── <Name>.jsx + <Name>.d.ts + <Name>.prompt.md
│       └── core.card.html               ← live component specimen
├── ui_kits/
│   ├── index.html             ← kit index
│   ├── marketing/             ← marketing-site surfaces (components.jsx, web-sections.jsx)
│   └── slides/                ← 1920×1080 deck system (deck-stage.js, layouts/*.jsx)
├── skills/aquiva-design/      ← the Claude plugin skill (single source of truth)
└── claude_design/             ← everything the Claude.ai design project dictates:
    ├── preview/               ← 30+ specimen cards (the project's Design System tab)
    └── _ds_bundle.js / _ds_manifest.json   ← generated by the project, used by specimens

TODO: claude_design/ exists only because the Claude.ai design project dictates its layout and generated files. npm run build:design assembles its upload from the clean structure above. Long-term goal: retire the design-project dependency and delete this folder.

  • Tokens & fontscolors_and_type.css holds every CSS custom property (color, type, spacing, radii, shadows, motion) plus semantic classes. Three brand fonts self-host from fonts/.
  • Components — six React primitives in components/core/, each with a props contract (.d.ts) and usage notes (.prompt.md).
  • Preview cards — small specimens that populate the Design System tab; open claude_design/preview/index.html to browse every token group.
  • UI kits — full marketing surfaces and a slide deck system you can fork.

Install in Claude Cowork

This repo is also a self-contained Claude Cowork plugin. Installing it gives Cowork (or Claude Code) the aquiva-design skill and all of its assets, so the brand shows up automatically when you build a deck, page, or prototype. Each version ships as a GitHub release with a ready-to-install zip attached.

Install it (Cowork desktop)

Install from the release zip, via Cowork's local upload. The Cowork desktop app's in-app marketplace can pin an older cached version and refuse to update, so the release zip is the reliable path.

  1. Download the latest aquiva-design-system-<version>.zip from the Releases page. You need read access to this private repo and a GitHub login.
  2. In Cowork, open Customize → Personal plugins → + to open the Directory.
  3. Under Local uploads, add the zip you downloaded, then install it.
  4. Make sure its toggle is on, and open it to confirm it lists Skills → aquiva-design.

The skill then activates on its own when you do branded design work, and you can invoke it by name. To move to a newer version, download the latest release zip and upload it again.

Claude Code (CLI) picks up plugin updates correctly, so there you can install from the marketplace directly: /plugin marketplace add aquivalabs/aquiva-design-system then /plugin install aquiva-design-system.

Share it with others

Sharing is one person at a time: grant someone read access to the repo, then point them at the Releases page to download the zip and add it through Local uploads in their own Cowork. It installs as a personal, user-scoped plugin in their environment. It is not pushed to everyone at the org level, and it needs no admin setup.

Access is bounded by the LICENSE: these materials are proprietary to Aquiva and shared with authorized partners only. Share only with people who fall under that license, and keep the repo private. This is not a public release.

For maintainers

The plugin is authored here in GitHub, the same place the rest of the system is authored (see "Source of truth & maintenance"). The two .claude-plugin/ manifests are additive, so the one-way GitHub to Claude.ai design sync is unaffected.

One version covers the design system, the plugin, and the GitHub release. It uses CalVer (YYYY.M.patch) and lives in .claude-plugin/plugin.json (with package.json kept identical). The full rules are in CLAUDE.md.

To ship a new version:

  1. Bump version in .claude-plugin/plugin.json and package.json (same value), then run claude plugin validate ./.
  2. Update the version badge in the first line of this README to match.
  3. After merging, tag and release: gh release create vYYYY.M.patch — and attach the zip for Cowork local uploads: git archive --format=zip -o aquiva-design-system-vYYYY.M.patch.zip HEAD.

Using the system

1. Link the styles

Every artifact links one stylesheet. styles.css imports the tokens plus the slide primitives; or link colors_and_type.css directly for tokens only. The three brand fonts self-host from fonts/ via @font-face — no external font CDN needed.

<link rel="stylesheet" href="styles.css">         <!-- tokens + slide primitives -->
<!-- or, tokens only: -->
<link rel="stylesheet" href="colors_and_type.css">

Then style with the tokens and semantic classes — never raw hex:

<p class="aq-eyebrow">What we are</p>
<h1 class="aq-h1">The <em>AI-native</em> partner for growth companies</h1>
<p class="aq-lead">By the end of week one, you're usually clicking through a working prototype.</p>

Semantic classes: .aq-hero, .aq-h1.aq-h4, .aq-eyebrow, .aq-number, .aq-quote, .aq-lead, .aq-p, .aq-caption. Button recipes: .aq-btn + .aq-btn-primary / -ghost / -primary-on-dark / -ghost-on-dark.

2. Use the React components

components/core/ holds Button, Badge, Card, Stat, Eyebrow, Input — thin React wrappers over the brand recipes. They're bundled into claude_design/_ds_bundle.js and exposed on window.AquivaDesignSystem_b5493d. Load React + Babel, then the bundle, then pull components off the namespace:

<script src="claude_design/_ds_bundle.js"></script>
<script type="text/babel">
  const { Button, Stat, Card } = window.AquivaDesignSystem_b5493d;
  // <Button variant="primary">Talk to us →</Button>
  // <Stat value="1800+" label="Certifications" />
</script>

Each component's .prompt.md shows its variants and a usage example.

Namespace note: window.AquivaDesignSystem_b5493d is generated per project. If a component reads as undefined, re-check the namespace — the design-system compiler prints the current value.

3. Fork a kit surface

Whole sections and slides live in ui_kits/ as React JSX — the fastest way to assemble a deck or page:

  • ui_kits/marketing/Aquiva Sample Page.html — a full marketing landing page.
  • ui_kits/slides/Aquiva Sample Deck.html — a multi-slide capabilities deck.
  • ui_kits/slides/Slide Library.html — every empty layout to copy from.
  • ui_kits/index.html — the full kit index.
4. Lint for brand adherence (optional)

Three guardrails keep output on-brand:

npm install        # installs stylelint + oxlint
npm run lint       # copy regression gate (all surfaces) + changed-files CSS hex check
npm run lint:copy  # copy regression gate only — fails if a retired brand string returns
npm run lint:css   # changed-files "no raw hex" check only
npm run lint:js    # component / brand adherence (oxlint)
npm run lint:all   # full stylelint audit of every file

npm run lint always scans every copy surface for retired brand strings (the old tagline, stats, company name, and so on — see "Source of truth & maintenance"), and also runs the CSS hex check over the files you changed so the existing hex backlog never blocks a commit but new hardcoded colors can't land.


Content fundamentals

Copy is plain, concrete, and confident. We say what we ship and who it's for. We write in first person plural, prefer specifics to slogans, and never lean on rhythm or cleverness to carry a point.

Dimension Rule Example
Person First person plural for Aquiva, "you" / "your" for the customer. "We help enterprise teams, scaling technology companies, and ISVs turn their core applications into operational platforms."
Tone Confident and concrete. State what we do; show the result. Trust comes from specifics, not adjectives. "By the end of week one, you're usually clicking through a working prototype."
Casing Sentence case for section titles, with one pink <em> accent phrase per headline. ALL CAPS only for the wordmark and short eyebrow labels. "Consulting and engineering, rebuilt around AI."
Length Short. Get straight to the point. Body paragraphs 2–4 sentences. "Software that ships but doesn't get used isn't software yet."
Em-dashes Replace them, never use them. Appositive becomes a comma; a list of two or more becomes a colon; two independent clauses split into two sentences; an appended qualifier gets reordered. "sAPIm, our own Salesforce API monitoring tool."
Contrast Concrete enumeration beats contrast. Keep a real category contrast (a PDO, not an SI; organized around your problems, not our certifications); kill rhythm-only or time-scale contrasts ("days, not sprints"); one positioning contrast per section. "inside your org with your data model, permissions, and audit trail."
Jargon Use the real platform terms (Agentforce, AppExchange, ISV, sAPIm). Introduce an in-house term with a comma appositive the first time. "sAPIm, our own Salesforce API monitoring tool."
Numbers Lead with the stat: big light numeral, label beneath. Oxford commas in lists. 10 Market Experience · 1800+ Certifications · 200+ Projects Delivered · 4.95/5 CSAT Rating
Emoji Not used. Line icons are the only visual vocabulary at that scale. Arrows (→) in CTAs are fine.
Unicode "+" and curly quotes ("") are display elements, set large. Other glyphs are rare.

Voice playbook: plain and concrete · first person plural · sentence-case titles with one pink <em> accent · Oxford commas · no em-dashes (replace them) · concrete enumeration over contrast · one real positioning contrast per section, no rhythm-only "X not Y" · "shipping/running" over "building" for live systems · no chiasmus, no "committed to," no "we take very seriously" · no emoji (arrows are fine) · direct human quotes preserved verbatim, even when they contain an em-dash.

Do / don't

  • ✅ "We help enterprise teams, scaling technology companies, and ISVs turn their core applications into operational platforms."
  • ❌ "We leverage synergies to drive transformative value."
  • ✅ "inside your org with your data model, permissions, and audit trail." (concrete enumeration)
  • ❌ "inside, not alongside." (rhythm-only contrast)
  • ✅ "By the end of week one, you're usually clicking through a working prototype."
  • ❌ "We don't just build software — we transform businesses." (em-dash + empty contrast)
Positioning & messaging

Tagline: "The AI-native partner for growth companies."

Positioning one-liner: "AI-native consulting and engineering partner for growth companies. Product Development, Custom Solution Development, Advisory, Data & Integrations, and Application Security across Salesforce, AWS, Azure, and GCP."

Canonical stats (the hero stat band; four items, no headcount): 10 Market Experience · 1800+ Certifications · 200+ Projects Delivered · 4.95/5 CSAT Rating. Write 1800+ with no comma; use 200+, never 250.

Services (the canonical six): Salesforce; Product Development; Advisory Services; Data & Integrations; Security, Risk and Compliance; Custom Solution Development.

Terminology: AI-native (hyphen, lowercase "native") in prose, "AI Native" only as a display tag. Agentforce, AppExchange, AgentExchange, Data Cloud, MuleSoft. sAPIm is our own Salesforce API monitoring tool (lowercase s, caps API, lowercase m); introduce it with a comma appositive. Use "Security, Risk and Compliance", not "Application Security." Company name is Aquiva; contact is connect@aquiva.com.

Pillars vs. values: keep them separate. Two distinct lists serve two purposes; don't blend them.

  • The four homepage pillars are positioning (homepage): AI Native, Product Grade, Acceleration, Outcome Obsessed.
  • The five about-page values are culture (about page): Proactive and Engaged, Passionate and Growth Minded, Focused on Results, We Win as a Team, Clear & Candid.
Source of truth & maintenance
  • The website aquiva-website-v2 is canonical for copy. This design system mirrors the website's brand voice, tagline, stats, services, and positioning; it does not set them.
  • This repo started as a Claude.ai design-project export. On a new re-export, re-apply this brand rather than accepting the old copy back. A stale export can reintroduce the previous Salesforce-era tagline, the old stat numbers, and the former company name. Run npm run lint (the copy-adherence guardrail) to catch a regression automatically.
  • When the website changes a canonical stat, tagline, or service, re-pull it here so the two stay in sync.
Editing workflow: GitHub → Claude design

This repo is the surface we author. The Claude.ai design project mirrors it.

  1. Edit in GitHub. Make changes here (branch + PR), not in the Claude.ai export. npm run lint must pass before merge.
  2. Sync into Claude design. After merging, run npm run build:design — it assembles dist/ in the layout the design project expects (preview, bundle, manifest, and SKILL.md at the root) — and upload dist/ into the Claude.ai design project. The project ID matches the bundle namespace (AquivaDesignSystem_b5493d).
  3. Keep the two in lockstep. Treat the GitHub edit and the Claude sync as one change, not two. The hazard is a future re-export from Claude.ai landing on top of an unsynced GitHub edit and reverting it. npm run lint catches the old-brand case on the way back in, but the discipline is to never let the two drift apart.

Direction is one-way: GitHub is authored, Claude design mirrors. Do not hand-edit the Claude export and expect it to flow back.


Visual foundations

Color
Core
Role Color Hex Usage
Primary Cornflower Blue #5A99E6 Main color. 50–60% of any composition. OK for backgrounds.
Secondary Jackson Purple #352694 ~40%. OK for backgrounds; must not dominate blue.
Accent Cerise Red #E01F6F 10–20% max. Icons, quotes, callouts — never background.
Neutral text Ash Gray #423C4C Body copy and icons.
Neutral UI Gray #737474 Logo text, secondary UI.
Header gray Light Gray #9E9E9E Slide / page headers.
Page background Light Gray #F6F7F9 Primary app / page background.
Soft blue bg Light Blue #CEE0F8 Card / section backgrounds.
Soft violet bg Light Violet #E3E8FD Card / section backgrounds.
Warm accents
Role Color Hex Usage
Illustration fill Peach #F5C7A3 The dominant illustration fill; warm section backgrounds.
Emphasis orange Orange #ED7F20 Icons, accent text, illustration strokes. Pairs with peach.
Featured bg Cream #F9F5F0 Warmer, editorial alternative to #F6F7F9.
Peach tint Peach Light #FFD2A9 Highlights, tags, small callouts.
Deep indigo & purple
Role Color Hex Usage
Hero / footer bg Deep Indigo #0C1F4F Pairs with white type and cream accents.
Purple ink Purple Ink #1E1273 Deep purple for display type on light backgrounds.
Midnight Midnight #1D0447 Very dark accent variant.

Ratio rule: blue 50–60 : purple 40 : pink 10–20. Warm accents and deep indigo are out-of-ratio — use them for section-level color, not the primary ratio.

Gradients — canonical pairs: blue → purple, purple → pink, deep indigo → jackson purple (hero), peach → orange (warm illustrations).

Typography

Lexend + Open Sans is the operative pairing. Both are free Google Fonts and load locally — the system is fully self-contained.

Font Role Weights
Lexend All display — headlines, hero text, section titles, numerals, slide titles. Light 300–400 for elegant titles, 500/600 for UI headers. 300, 400, 500, 600, 700, 900
Open Sans Long-form body, paragraphs, lists, captions. 14–18 px on web; 8–11 pt in print/decks. 400, 500, 600, 700
JetBrains Mono Code, terminal / agent surfaces, tiny technical labels. 400, 500, 600

Pair Lexend display (titles & numerals) with Open Sans body. JetBrains Mono is reserved for code, terminal, and agent surfaces — never display or body copy.

Numerals are light. Big stats use Lexend Light (.aq-number → weight 300), 72–96 pt, set large and airy — not heavy.

Headline emphasis is pink, not italic. Emphasis inside a headline is set in cerise pink at the same weight or one step lighter — never italic.

  • Use <em> inside any heading (h1–h4, .aq-h1–h4, .aq-hero) — it's styled automatically — or apply .aq-h-accent to a span.
  • One accented phrase per headline. Pink stays on its 10–20% budget.
  • The accent stays pink on dark backgrounds — the contrast is intentional.
Layout & spacing
  • 4-pixel base, 8-pixel grid (--s-1--s-24)
  • Generous whitespace — layouts should breathe
  • Content cards sit on #F6F7F9 or white with soft shadows (never harsh black)
  • Photos are either full-bleed edge-to-edge or isolated with removed backgrounds
Cards / surfaces
  • White fill on #F6F7F9 page bg — or soft violet #E3E8FD for feature cards
  • Radius 12–16 px (--r-md to --r-lg)
  • Soft diffuse shadow tinted purple: 0 8px 24px rgba(53,38,148,0.10) — never pitch-black
  • Border optional; when present, very subtle #E7E9EE
  • No left-border-accent cards; no colored-stripe headers
Shadows

Three-step soft system, all tinted toward Jackson Purple — never neutral black — on light surfaces (--shadow-xs / -sm / -md / -lg). On dark surfaces purple shadows disappear, so use the dark exception (--shadow-dark-md / -lg) — deep neutral shadows.

Motion

Restrained by default:

  • Standard ease cubic-bezier(0.2, 0.8, 0.2, 1), 150–360 ms
  • Fades > slides > bounces. No bounce or overshoot.
  • Hover: slight lift (translateY −1px) + shadow upgrade. No color shift beyond shade.
  • Press: shrink to 0.98 scale, shadow collapses to shadow-xs.
Hover & press states
  • Primary button hover: darken blue toward Jackson Purple
  • Ghost hover: fill rises from transparent to --aq-violet-light
  • Press: scale(0.98) + shadow collapse
  • Focus: 3 px outer glow in rgba(90,153,230,0.35) (--shadow-focus)
Backgrounds
  • Default: #F6F7F9 soft gray
  • Secondary sections: #E3E8FD light violet or #CEE0F8 light blue — never pure white-on-white
  • Hero / feature: brand gradient linear-gradient(135deg,#5A99E6,#352694), always with white or light-violet type
  • Never use cerise pink as a background — accent-only
Dark surfaces

For hero, footer, and dark-section work, use the named tokens — don't re-derive opacity inline:

Role Token Value
Primary dark bg --surface-dark-1 Jackson Purple #352694
Footer / deepest --surface-dark-2 Deep Indigo #0C1F4F
Mid --surface-dark-mid #2A1E7A
Text on dark --on-dark-1/2/3 white · 78% · 52%
Hairline on dark --border-dark white at 14%
Code / terminal / agent surfaces

AI-themed sections get their own surface family — deeper than the dark hero, paired with JetBrains Mono. Recipes: .aq-terminal, .aq-agent-card; severity tags .aq-code-ok (blue), .aq-code-warn (pink), .aq-code-action, .aq-code-info. Surfaces --surface-code #0A0620, --surface-code-2 #060316.

Photography & imagery
  • Well-lit, people-forward stock
  • Unify with one of three treatments: opacity 60–80%, a blue filter, or a blue→purple gradient filter
  • Backgrounds removed or neutral; full-bleed photos go edge to edge with no margin
  • Warm-toned stock gets recolored to the cool brand palette
Illustrations
  • Solid colors or gradients (blue→purple, purple→pink)
  • Maintain the 50-60 : 40 : 10-20 ratio
  • Icon clusters can hold more pink (up to 50% of the icons in a set)

Iconography

Core style: 2-pixel stroke line icons in brand blue, purple, or cerise pink. All outline-style (1 px for small sizes, 3 px for large) — no filled icons. The set spans general, contact, core values, people, time, team, strategy, global, creative, and AI categories.

Implementation: the system uses Lucide — closest free, CDN-available match to the brand style (2-px stroke, rounded caps, geometric silhouettes). See assets/icons/icons.jsx, or load via <script src="https://unpkg.com/lucide@latest"></script>. Apply the brand palette as CSS color; an icon cluster can go up to 50% pink, otherwise keep the blue/purple ratio.

No emoji. No unicode icon characters (no ⚡️, no ✓ outside actual form UI).


Logo

  • Full wordmark: "AQUIVA" in a custom geometric face, with a horizontal underline beneath the "UI" letters
  • Minimum size: 12 px high (digital) · 6 mm (print); clear space 1× logo height on all sides
  • Variants: colorful (light bg), monochromatic gray (B&W materials), achromatic white (dark bg)
  • Short variant: the A-sign (triangular A with base bar) for avatars, app icons, favicons. Don't stack the sign and the wordmark together.

Forbidden: don't change colors or proportions; don't swap the font; don't add or subtract elements; don't rotate freely (90° OK) or flip.

Files (SVG primary, PNG legacy fallback):

  • assets/logo-wordmark-indigo.svg — deep indigo, for light backgrounds
  • assets/logo-wordmark-monochrome.svg — gray for B&W
  • assets/logo-wordmark-gray-blue.svg — gray with blue underline (--aq-blue)
  • assets/logo-wordmark-white.svg — white for dark bg
  • assets/logo-wordmark-xs.svg — small-size lockup (tuned for 12–24 px)
  • assets/logo-color.svg / logo-color-no-bg.svg — A-sign mark

The Aquiva design skill


name: aquiva-design description: Use this skill to generate well-branded interfaces and assets for Aquiva, either for production or throwaway prototypes/mocks/etc. Contains essential design guidelines, colors, type, fonts, assets, and UI kit components for prototyping. user-invocable: true

This skill packages the Aquiva Design System. The README, tokens, fonts, assets, components, and UI kits all live at the plugin root (${CLAUDE_PLUGIN_ROOT}/), not inside this skill folder. Read ${CLAUDE_PLUGIN_ROOT}/README.md first, then explore the other files.

Key files (all under ${CLAUDE_PLUGIN_ROOT}/):

  • README.md — full brand overview, content fundamentals, visual foundations, iconography
  • colors_and_type.css — CSS tokens (colors, type, spacing, shadows, motion) and semantic utility classes
  • assets/ — logos (color, monochrome, white), icons, customer logos, and partner badges; assets/salesforce.md explains how to fetch Salesforce brand assets (not vendored)
  • claude_design/preview/index.html — clickable hub linking 30+ preview cards (open this first to browse every token group)
  • components/core/ — React primitives (Button, Badge, Card, Stat, Eyebrow, Input); each has a .jsx + .d.ts + .prompt.md. Compiled into claude_design/_ds_bundle.js, exposed on window.AquivaDesignSystem_b5493d
  • ui_kits/index.html — index of both kits plus the sample deck/page to fork
  • ui_kits/marketing/ — React component library for marketing surfaces (nav, hero, stats, values, services, quote, contact, footer)

If creating visual artifacts (slides, mocks, throwaway prototypes, etc), copy assets out and create static HTML files for the user to view. Always import ${CLAUDE_PLUGIN_ROOT}/colors_and_type.css at the top — the whole system depends on those variables.

If working on production code, you can copy assets and read the rules here to become an expert in designing with this brand.

Brand shorthand you must remember:

  • Tagline: "The AI-native partner for growth companies." Company name is Aquiva; contact is connect@aquiva.com.
  • Positioning: AI-native consulting and engineering partner for growth companies. Canonical stats: 10 (Market Experience) · 1800+ (Certifications) · 200+ (Projects Delivered) · 4.95/5 (CSAT Rating).
  • Colors: Cornflower Blue #5A99E6 (primary, 50–60%), Jackson Purple #352694 (secondary, 40%), Cerise Red #E01F6F (accent, 10–20%, never bg)
  • Type: Lexend for display (300/400 elegant titles, 500/600 UI headers, 900 hero numerals), Open Sans for body. JetBrains Mono for code/terminal surfaces only — never display.
  • Voice: plain, concrete, confident, first person plural. Sentence-case titles with one pink <em> accent. Concrete enumeration over contrast; no rhythm-only "X not Y." No em-dashes (replace them). Oxford commas. No emoji (arrows → are fine).
  • Radius: 12–16 px on cards, 999 px on buttons
  • Shadows: always soft and purple-tinted, never harsh black
  • Gradients: blue→purple (primary) or purple→pink (warm). Full tri-color gradient exists but use sparingly.

If the user invokes this skill without any other guidance, ask them what they want to build or design, ask some questions, and act as an expert designer who outputs HTML artifacts or production code, depending on the need.