// may the 4th be with you⚔️
Back to designs

DESIGN.md · explainx registry

Composio

### Composio - Tool integration platform. - Modern dark with colorful integration icons - description: A developer-tools brand for AI-agent tool integration whose marketing surfaces lean into a dark, technical aesthetic with a sin

Backend, Database & DevOps#design-md#awesome-design-md#backend-database-devops#composio
Get a custom design.md for your product
DESIGN.md (markdown body)

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

TokenSizeWeightLine HeightLetter SpacingUse
{typography.display-mega}72px5001.05-2.16pxHomepage hero h1
{typography.display-xl}56px5001.05-1.68pxSubsidiary heroes
{typography.display-lg}44px5001.1-1.32pxSection heads
{typography.display-md}32px5001.15-0.96pxSub-section heads
{typography.display-sm}24px5001.25-0.5pxCard group titles
{typography.title-md}18px6001.40Component titles
{typography.title-sm}16px6001.40Toolkit card titles
{typography.body-md}16px4001.50Default body
{typography.body-sm}14px4001.50Footer body
{typography.caption}13px4001.40Photo captions
{typography.caption-uppercase}11px6001.40.88pxSection labels, badge pills
{typography.code}13px4001.50Code blocks — JetBrains Mono
{typography.button}14px5001.00CTA pill labels
{typography.nav-link}14px5001.40Top-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.

LevelTreatmentUse
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 glowRadial 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

TokenValueUse
{rounded.none}0pxReserved
{rounded.xs}4pxInline tags
{rounded.sm}6pxCompact rows
{rounded.md}8pxCTA buttons, form inputs
{rounded.lg}12pxToolkit cards, code blocks, terminal panes
{rounded.xl}16pxFeature cards, terminal mockup grids
{rounded.pill}9999pxSection-label badges
{rounded.full}9999pxAvatar 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

NameWidthKey Changes
Mobile< 640pxHero h1 72→36px; terminal mockup grid collapses to single pane; toolkit grid 1-up; nav hamburger.
Tablet640–1024pxHero h1 56px; terminal mockup grid stays 2×2; toolkit grid 2-up.
Desktop1024–1280pxFull hero h1 72px; full 2×2 terminal mockup; toolkit grid 4-up.
Wide> 1280pxContent 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.

Usage

  1. Copy DESIGN.md into your project or paste it into your IDE agent chat.
  2. Ask your assistant to follow the tokens for color, typography, spacing, and component styling.
  3. When collaborating, share the file directly—or tap “Copy page link” below so teammates open the same snapshot.

Common questions

What is Composio on explainx.ai?
### Composio - Tool integration platform. - Modern dark with colorful integration icons - description: A developer-tools brand for AI-agent tool integration whose marketing surfaces lean into a dark, technical aesthetic with a sin Listed under category “Backend, Database & DevOps”. Explainx.ai mirrors the full DESIGN.md document so assistants can cite stable tokens and prose in one place.
What is DESIGN.md?
DESIGN.md blends YAML design tokens—colors, typography, spacing, radii—with markdown that explains intent. Google documents this pattern for agent-driven UI work under Stitch (stitch.withgoogle.com).
How do I use this with ChatGPT, Cursor, Claude Code, or another IDE agent?
Paste the DESIGN.md into your repo root or attach it to the agent conversation, then ask explicitly for layouts, spacing, palette, type scale, and component tone that follow the document. Refresh from this listing when upstream authors publish changes.
Where is the source repo?
Maintainers link to github.com/VoltAgent/awesome-design-md. Community listings on explainx.ai may reference popular aesthetic names for inspiration; that does not imply official endorsement by any trademark holder.
How current is this DESIGN.md?
Explainx snapshots the file at import time. Recorded last update on this listing: May 4, 2026.
Need a fresh DESIGN.md from scratch?
Use the ExplainX DESIGN.md generator to describe your product and audience; it returns Stitch-style YAML plus narrative guidance you can publish or submit to the registry afterward.

Still exploring the format? Browse the full DESIGN.md registry or draft a new system with our DESIGN.md generator.

Community listing for AI design workflows—not necessarily affiliated with any brand referenced in the name or summary. For context on the format, see Google Stitch.