Brand Guidelines
The complete Composio brand book — overview, platforms, logo, color, type, layout, and voice in one place.
Overview
There are two worlds. FOR YOU is the light, consumer-facing surface; DEV is the dark, developer-facing one. The same brand color, type, and components render in either context — the brand flips to suit the surface rather than locking to a single look.
- Achromatic interface. Black, white, and the surface tokens carry the UI. Blue is a spot color at roughly 7% of what you see.
- Two-surface system with token-flipping — never mix light and dark within one section.
- Two typefaces, no exceptions — Geist Sans for everything readable; JetBrains Mono for code and chrome. No third face, no fallback shipped in place of either.
- Sans never goes bold — emphasis comes from size, not weight.
- No eyebrow text — headings stand alone, with no label, kicker, or overline above them.
- One spot blue —
#51a2ffon both surfaces. On dark, hover and active are #51a2ff too; only light mode darkens them.
The Two Platforms
Every Composio surface belongs to one of two worlds. Keep each section internally consistent.
FOR YOU — consumer, light. Off-white surfaces (#f6f6f6), generous space, the spot blue #51a2ff on marks and interactive state. Marketing, onboarding, the consumer product.
DEV — developer, dark. Warm near-black surfaces (#0f0f0f / #1e1e1e), tight chrome, the same spot blue #51a2ff which reads cleanly against the dark at 7.27:1. Docs, dashboards, code, the developer product.
Logo
The wordmark and logomark come in black and white. Match the variant to the surface.
Use the black logo on FOR YOU (light) surfaces and the white logo on DEV (dark) surfaces. The logomark (icon only) is for tight spaces; the full logo everywhere else.
Clear space: keep a margin of x on all sides, where x equals the width of the logomark. Never crowd it.
Color
The interface is achromatic. Blue is a spot color that marks things, and it is about 7% of what you see.
Build with neutrals. Surfaces are deliberately off-pure: background #f6f6f6 / #0f0f0f, card #ffffff / #1e1e1e, popover #fafafa / #2a2a2a, with hairline borders #eaeaea / #2c2c2c. Hierarchy comes from alpha on black or white, not from hue. Every primary CTA is a black fill on light or a white fill on dark. Every secondary is a white fill with a black/15 hairline, or its inverse.
Blue is a spot color, not a UI color. It does one named job: interactive state, such as a focus ring, a checked control, or a selected row. It is not what you build interfaces with, and a section that feels plain is not a reason to reach for it. Plain is the house style.
There is one brand blue, #51a2ff, and it does not flip. It clears contrast on both surfaces, 7.27:1 on the dark page and legible as a fill on light, so a second hue was never needed. The retired dark value #0007cd was 1.75:1 and effectively invisible, which is the only reason the brand ever appeared to need two. --brand is a fill, and the only text allowed on it is --brand-on-brand. It is never a text color on light: #51a2ff there is 2.44:1 and fails.
When blue has to be read rather than seen, use --brand-ink (#0b6fd6 on light, 4.56:1). Links, focus rings and selected rows take ink. This is the token that did not exist before, which is why the old rule about using the brand for links was unfollowable.
Semantic colors (destructive, success, warning) mean what they say. Use them only for errors, confirmations, and cautions, never as a generic accent.
Note that --accent means something different in the product repos, where it is a neutral interaction surface (#f5f5f5 / #262626) used for hover. It carries no brand color. Do not reach for it expecting blue.
Typography
Exactly two typefaces: Geist Sans for everything readable, JetBrains Mono for code and developer chrome. These rules are hard constraints, not preferences. There is no context, format, or deadline in which another face or a bold sans is acceptable.
Geist Sans by Vercel is the only sans: headings, body, UI, buttons, names, titles, and stat values. JetBrains Mono is the only mono: code, terminal text, numbers that label a chart mark, badges, version chips, and inline metadata. No third typeface exists, including for display, decorative, or 'just this once' use.
Banned faces. ABC Diatype (retired; the files still under /fonts/ABCDiatype-* are archival and must not be loaded), Geist Pixel (any variant), Geist Mono, Inter, Arial, Helvetica, SF Pro, Roboto, system-ui, and any serif, script, or display face. A fallback stack is a safety net for loading, never a design choice. If the real face cannot load in your environment, stop and fix the loading, do not ship the fallback.
Loading. In Next.js, load Geist Sans from the geist package (geist/font/sans) and JetBrains Mono from next/font/google. In plain HTML, load Geist and JetBrains Mono from Google Fonts. For anything rendered to an image (canvas, SVG, satori, Playwright capture), wait for document.fonts to load the exact weights you use before painting, or embed the font files directly. Write stacks as 'Geist', sans-serif and 'JetBrains Mono', monospace.
Sans never goes bold. Use weight 400 or 500 only — every heading (display and all title tokens) is normal weight; 500 is only for body emphasis through the -medium body tokens. Emphasis comes from size, not weight. 600 is bold. So are font-semibold, font-bold, <b> and <strong> left at the browser default, faux bold from -webkit-text-stroke or a text-shadow smear, and synthesized bold. Style <strong> and <b> to 500 or to a colour change.
Two line heights, three tracking values, all inside the tokens. Leading is 1.1 for display and titles and 1.5 for body and labels. Tracking is -0.025em on headings, -0.011em on body, and 0.05em on the small mono labels (text-label-small, -mini, -micro). Never add leading or tracking next to a token.
Mono can be any weight. It is the only face allowed above 500, and the only face that takes uppercase with wide tracking. Mono is for chrome and code, never for headings or running body copy.
One exception, narrowly scoped. Inside an app-native UI mockup (for example a recreated Slack message or GitHub PR in a use-case post), text inside the mocked app may mirror that app's weights so the mock reads as the real product. The mock is still set in Geist Sans and JetBrains Mono, and everything outside the mock, the Composio frame and any headline, follows these rules exactly.
Check before you ship. Inspect the computed font-family and font-weight of the headings, body, and numbers you produced. Every sans element must resolve to Geist at 400 or 500; every mono element to JetBrains Mono. If any element resolves to a fallback, another family, or a sans weight above 500, it is not done.
No eyebrow text, of any kind. Never put a small label, kicker, overline, or category tag above a heading — not in mono, not in sans, not uppercase or sentence case, not in blue or in muted grey, and not paired with a dot or icon. The heading opens the section on its own. If a heading needs context to make sense, rewrite the heading.
Layout & Elevation
Structure carries the brand as much as color and type do.
Page content sits within a 1240px max width; long-form columns at 720px, forms at 520px, single CTAs at 380px. Don't hardcode pixel widths — use the container tokens.
Elevation has one signature: a two-layer card shadow (shadow-elevated) for primary surface cards, with the standard shadow scale for ordinary lifts. Lead with whitespace and surface contrast before adding decoration.
Voice & Tone
Composio speaks to two audiences without splitting in two: approachable on FOR YOU, precise on DEV, infrastructure-grade throughout.
- Clear over clever — say the thing plainly.
- Technical, not cold — precise, never jargon for its own sake.
- Confident, not loud — let size and space carry emphasis, the way the type system does.