Composio

Overview

Composio's marketing site reads like a serious developer-infrastructure brand — closer to Vercel or Stripe Docs in atmosphere than to a typical AI-tools startup. The base canvas is a near-black `{colors.canvas}` (#0f0f0f) holding white type and a single voltage of **deep electric blue** (`{colors.primary}` — #0007cd) carrying every primary CTA, brand wordmark, and atmospheric spotlight glow that backs the homepage hero.

Type runs **abcDiatype** as the single sans family across display, body, navigation, and captions. Display sits at weight 500 — confident but not bombastic. Code blocks and terminal mockups switch to JetBrains Mono.

The page rhythm is monolithic: dark canvas top to bottom with subtle elevation steps via card surfaces. The brand's strongest visual signature is a **four-pane terminal-style mockup** — a 2×2 grid of dark code/output panels with a central blue spotlight glow behind them.

**Key Characteristics:**

• Single accent: `{colors.primary}` (#0007cd) for primary CTAs, wordmark, spotlight glows.
• Single sans family: abcDiatype carries everything except code (JetBrains Mono).
• Dark monolithic canvas: `{colors.canvas}` runs top to bottom; depth from `{colors.surface-card}` and `{colors.surface-card-elevated}` brightness steps.
• Terminal-mockup hero: 2×2 grid of code/output panes is the brand signature.
• Compact pill geometry: CTAs sit at `{rounded.md}` (8px), not full pills — developer-tool dialect.
• Spotlight-glow atmospheric backdrop: a radial blue glow centered behind hero content.
• 96px section rhythm.

Colors

Brand & Accent

• **Composio Blue** (`{colors.primary}` — #0007cd): Primary CTAs, wordmark, spotlight glow center.
• **Composio Blue Active** (`{colors.primary-active}` — #0005a3): Press state.
• **Spotlight Glow Tone** (`{colors.primary-glow}` — #1a26ff): Brighter blue used inside radial atmospheric glows.
• **Accent Cyan** (`{colors.accent-cyan}` — #00d4ff): Sparingly on data-flow visualizations.
• **Accent Violet** (`{colors.accent-violet}` — #7b3aed): Inside specific product illustrations only.

Surface

• **Canvas** (`{colors.canvas}` — #0f0f0f): Page floor — near-black.
• **Canvas Deep** (`{colors.canvas-deep}` — #000000): Pure black for terminal mockup grids and code blocks.
• **Surface Card** (`{colors.surface-card}` — #181818): Default content card.
• **Surface Card Elevated** (`{colors.surface-card-elevated}` — #222222): Terminal panes, secondary buttons.
• **Surface Strong** (`{colors.surface-strong}` — #2a2a2a): Dropdown menus.

Hairlines

• **Hairline** (`{colors.hairline}` — #222222): Default 1px divider.
• **Hairline Soft** (`{colors.hairline-soft}` — #1a1a1a): Lighter divider.
• **Hairline Strong** (`{colors.hairline-strong}` — #333333): Stronger panel outline.

Text

• **Ink** (`{colors.ink}` — #ffffff): Display headlines.
• **Body** (`{colors.body}` — #a8a8a8): Default running-text — soft gray.
• **Body Strong** (`{colors.body-strong}` — #ffffff): Same as ink.
• **Muted** (`{colors.muted}` — #888888): Sub-titles, breadcrumbs.
• **Muted Soft** (`{colors.muted-soft}` — #666666): Disabled text.
• **On Primary** (`{colors.on-primary}` — #ffffff): White text on blue CTAs.

Semantic

• **Success** (`{colors.semantic-success}` — #33d17a): "Online", "active" indicators.
• **Error** (`{colors.semantic-error}` — #ff4d4d): Validation errors.

Typography

Font Family

The system runs **abcDiatype** (Lineto) across every text role. Code blocks switch to **JetBrains Mono**. Fallback: `ui-sans-serif, system-ui, sans-serif`.

Hierarchy

| Token | Size | Weight | Line Height | Letter Spacing | Use |

|---|---|---|---|---|---|

| `{typography.display-mega}` | 72px | 500 | 1.05 | -2.16px | Homepage hero h1 |

| `{typography.display-xl}` | 56px | 500 | 1.05 | -1.68px | Subsidiary heroes |

| `{typography.display-lg}` | 44px | 500 | 1.1 | -1.32px | Section heads |

| `{typography.display-md}` | 32px | 500 | 1.15 | -0.96px | Sub-section heads |

| `{typography.display-sm}` | 24px | 500 | 1.25 | -0.5px | Card group titles |

| `{typography.title-md}` | 18px | 600 | 1.4 | 0 | Component titles |

| `{typography.title-sm}` | 16px | 600 | 1.4 | 0 | Toolkit card titles |

| `{typography.body-md}` | 16px | 400 | 1.5 | 0 | Default body |

| `{typography.body-sm}` | 14px | 400 | 1.5 | 0 | Footer body |

| `{typography.caption}` | 13px | 400 | 1.4 | 0 | Photo captions |

| `{typography.caption-uppercase}` | 11px | 600 | 1.4 | 0.88px | Section labels, badge pills |

| `{typography.code}` | 13px | 400 | 1.5 | 0 | Code blocks — JetBrains Mono |

| `{typography.button}` | 14px | 500 | 1.0 | 0 | CTA pill labels |

| `{typography.nav-link}` | 14px | 500 | 1.4 | 0 | Top-nav menu |

Principles

• **Display weight stays at 500.** Confident but not display-bold.
• **abcDiatype across every role.** No display/body family split.
• **JetBrains Mono on every code surface.**

Note on Font Substitutes

abcDiatype is a Lineto licensed typeface. Open-source substitute: **Inter** at weight 500 with letter-spacing -1.5%.

Layout

Spacing System

• **Base unit:** 4px.
• **Tokens:** `{spacing.xxs}` 4px · `{spacing.xs}` 8px · `{spacing.sm}` 12px · `{spacing.base}` 16px · `{spacing.md}` 20px · `{spacing.lg}` 24px · `{spacing.xl}` 32px · `{spacing.xxl}` 48px · `{spacing.section}` 96px.
• **Section padding:** `{spacing.section}` (96px) for major bands.

Grid & Container

• Max content width: ~1200px.
• Editorial body: 12-column grid.
• Terminal mockup grid: 2×2 equal-size panes.
• Toolkit grid: 4-up at desktop, 2-up tablet, 1-up mobile.
• Footer: 5-column at desktop.

Whitespace Philosophy

The dark canvas creates its own depth — whitespace can stay tight without feeling crowded. 96px between bands; 24px between cards inside a band.

Elevation & Depth

The system uses **brightness-step elevation**: surfaces step up in brightness instead of casting drop shadows. Combined with subtle radial blue glows, this creates a focused dark-mode atmosphere.

| Level | Treatment | Use |

|---|---|---|

| Flat (canvas) | `{colors.canvas}` (#0f0f0f) | Body bands, footer |

| Recessed | `{colors.canvas-deep}` (#000000) | Terminal mockup grid background, code blocks |

| Card | `{colors.surface-card}` (#181818) | Default content cards |

| Card elevated | `{colors.surface-card-elevated}` (#222222) | Terminal panes, secondary buttons |

| Atmospheric glow | Radial gradient using `{colors.primary-glow}` | Hero spotlight backdrop |

Decorative Depth

• **Spotlight glow backdrops** — radial blue gradient centered behind hero content.
• **Terminal-pane brightness ladder** — 2×2 mockup uses canvas-deep outer + surface-card-elevated panes.

Shapes

Border Radius Scale

| Token | Value | Use |

|---|---|---|

| `{rounded.none}` | 0px | Reserved |

| `{rounded.xs}` | 4px | Inline tags |

| `{rounded.sm}` | 6px | Compact rows |

| `{rounded.md}` | 8px | CTA buttons, form inputs |

| `{rounded.lg}` | 12px | Toolkit cards, code blocks, terminal panes |

| `{rounded.xl}` | 16px | Feature cards, terminal mockup grids |

| `{rounded.pill}` | 9999px | Section-label badges |

| `{rounded.full}` | 9999px | Avatar plates (rare) |

Compact developer-ergonomic radii — 8px CTAs, 12-16px cards. Signals "developer tool" rather than "consumer brand."

Components

Top Navigation

**`top-nav-dark`** — Default top nav. Background `{colors.canvas}`, text `{colors.body-strong}`, height 64px. Layout: Composio wordmark left, primary horizontal menu (Product / Toolkits / Docs / Pricing / Customers / Blog), GitHub stars + Sign In + "Get started" right.

Buttons

**`button-primary`** — The signature Composio Blue CTA. Background `{colors.primary}`, text `{colors.on-primary}`, type `{typography.button}` (14px / 500), padding 10px × 18px, height 40px, rounded `{rounded.md}` (8px).

**`button-primary-active`** — Press state. Background `{colors.primary-active}`.

**`button-secondary-dark`** — Surface-elevated secondary. Background `{colors.surface-card-elevated}`, text `{colors.body-strong}`.

**`button-outline`** — Transparent with 1px hairline-strong border.

**`button-tertiary-text`** — Inline text link.

Hero & Atmospheric

**`hero-band`** — Homepage hero. Background `{colors.canvas}`, full-width display headline in `{typography.display-mega}` (72px / 500), subhead, two CTAs, and a spotlight-glow backdrop emanating from behind the centered terminal-mockup grid.

**`terminal-mockup-grid`** — The brand's strongest visual signature. 2×2 grid of dark code/output panels inside a `{rounded.xl}` (16px) container. Background `{colors.canvas-deep}`, padding 32px, gap 16px.

**`terminal-pane`** — Individual code/output panel inside the mockup grid. Background `{colors.surface-card}`, text `{colors.body}` in `{typography.code}`, rounded `{rounded.lg}` (12px), padding 20px.

**`spotlight-glow-card`** — Large feature card with centered display headline and a radial blue glow behind it. Background `{colors.surface-card}`, text `{colors.body-strong}` in `{typography.display-md}`, rounded `{rounded.xl}`, padding 48px.

Cards

**`feature-card`** — 3-up benefit grid. Background `{colors.surface-card}`, text `{colors.body}`, type `{typography.title-md}`, rounded `{rounded.xl}`, padding 28px.

**`toolkit-card`** — 4-up toolkit grid (Slack, GitHub, Stripe, Notion, Linear, etc.). Background `{colors.surface-card}`, text `{colors.body-strong}`, type `{typography.title-sm}`, rounded `{rounded.lg}`, padding 20px. 40px square `{component.toolkit-icon}` top, toolkit name, one-line description.

**`toolkit-icon`** — Square icon plate. Background `{colors.surface-card-elevated}`, rounded `{rounded.md}`, 40px size.

**`testimonial-card`** — Quote card. Background `{colors.surface-card}`, text `{colors.body}`, rounded `{rounded.lg}`, padding 24px.

Code

**`code-block`** — Inline code/terminal block. Background `{colors.canvas-deep}`, text `{colors.body}` in `{typography.code}`, rounded `{rounded.lg}`, padding 20px.

Forms

**`text-input`** — Background `{colors.surface-card}`, text `{colors.body-strong}`, rounded `{rounded.md}` (8px), padding 12px × 16px, height 44px.

**`search-input`** — Compact search field. Same surface and radius, smaller padding, 40px height.

Tags & Badges

**`badge-pill`** — Small uppercase pill. Background `{colors.surface-card-elevated}`, text `{colors.body-strong}`, type `{typography.caption-uppercase}`, rounded `{rounded.pill}`, padding 4px × 10px.

CTA / Footer

**`cta-band-spotlight`** — Pre-footer band. Background `{colors.canvas}` with centered radial spotlight glow. Display headline + single primary CTA pill. 96px padding.

**`footer-dark`** — Closing footer. Background `{colors.canvas}`, text `{colors.body}`. 5-column link list. 64×48px padding.

**`footer-link`** — Background transparent, text `{colors.body}`, type `{typography.body-sm}`.

Do's and Don'ts

Do

• Reserve `{colors.primary}` for primary CTAs, wordmark, and spotlight glows.
• Use `{rounded.md}` (8px) for every CTA — not full pills.
• Use brightness-step ladder for elevation; avoid drop shadows.
• Pair every hero with a centered radial blue spotlight glow.
• Render code, CLI commands in JetBrains Mono via `{typography.code}`.
• Use the 2×2 terminal-mockup grid as the homepage hero anchor.

Don't

• Don't introduce a secondary brand color. Cyan and violet are illustrative-only.
• Don't use full pills on CTAs.
• Don't drop display weight to 400.
• Don't add drop shadow tiers.
• Don't use canvas-deep (#000000) outside terminal/code surfaces.
• Don't extract a CTA color from a third-party widget (cookie consent, OneTrust). The brand's CTA color is what appears on actual page CTAs.

Responsive Behavior

Breakpoints

| Name | Width | Key Changes |

|---|---|---|

| Mobile | < 640px | Hero h1 72→36px; terminal mockup grid collapses to single pane; toolkit grid 1-up; nav hamburger. |

| Tablet | 640–1024px | Hero h1 56px; terminal mockup grid stays 2×2; toolkit grid 2-up. |

| Desktop | 1024–1280px | Full hero h1 72px; full 2×2 terminal mockup; toolkit grid 4-up. |

| Wide | > 1280px | Content caps at 1200px. |

Touch Targets

• Primary CTA at 40px height — at WCAG AA, padded for AAA.
• Search input at 40px.

Collapsing Strategy

• Top nav switches to hamburger below 768px.
• Terminal mockup 2×2 grid collapses to a single pane on mobile.
• Toolkit grid: 4-up → 2-up → 1-up.
• Hero spotlight glow stays at every breakpoint.

Iteration Guide

1. Focus on a single component at a time.

2. CTAs default to `{rounded.md}` (8px). Cards use `{rounded.lg}` or `{rounded.xl}`.

3. Variants live as separate entries inside `components:`.

4. Use `{token.refs}` everywhere — never inline hex.

5. Hover state never documented.

6. abcDiatype 500 for display, 400/600 for body. JetBrains Mono on every code surface.

7. Composio Blue stays scarce.

Known Gaps

• abcDiatype is licensed; Inter is the substitute.
• Animation timings out of scope.
• In-product surfaces (toolkit dashboards, agent playground) are behind login walls.
• Form validation states beyond focus not visible on captured surfaces.