# GitHub

> Generated by BrandSweets from the github BrandDoc (v2, schema 1). Do not edit by hand.

## Identity

**Tagline:** Let's build from here.

**Mission:** To increase the health of the global open-source ecosystem and help every developer build, together.

**Sector:** developer tools and software collaboration

**Audience:** developers — from open-source maintainers to enterprise engineering teams

**Founded:** 2008

**Domain:** github.com

**Guidelines:** https://github.com/logos


GitHub is the home for all developers — where over 100 million people build software together. The brand is calm, technical, and confident: the Invertocat, the Primer design system, and open-source typefaces that GitHub gives back to the community.

### Values

- **Developer first** — Every decision starts with the developer experience.
- **Open source stewardship** — Give back to the ecosystem — typefaces, tools, and standards released openly.
- **Collaboration** — Software is a team sport; the platform and the brand celebrate building together.

## Voice

**Tone:** technical, clear, confident, developer-first

### Do

- Write for developers — precise, unpatronizing
- Prefer concrete verbs and real examples
- Respect the reader's time; get to the command

### Don't

- Never talk down or over-explain the basics
- Avoid marketing fluff and hype adjectives
- Don't anthropomorphize the product

### Sample copy

- **primary button** _(cta)_: "Clone repository" — `clone-cta`
- **empty state** _(empty-state)_: "This repository is empty. Push your first commit to get started." — `empty-repo`
- **hero headline** _(headline)_: "Let's build from here." — `hero-headline`

### Vocabulary

- **Preferred:** repository, commit, pull request, developer, open source
- **Avoided:** repo (in formal copy), coder, user (prefer 'developer')
- **GitHub:** One word, capital G and capital H. Never 'Github', 'github', or 'GITHUB' in prose.
- **Octocat:** GitHub's mascot; the mark is the 'Invertocat' (the cat silhouette in a circle).
- **pull request:** Lowercase, two words. 'PR' acceptable in informal/technical contexts.

## Colors

| Role | Name | Hex | Dark | Usage |
| --- | --- | --- | --- | --- |
| `primary` | GitHub Black | `#181717` | `#f0f6fc` | The Octocat mark and wordmark; the brand's core monochrome color. |
| `accent` | Primer Blue | `#0969da` | `#58a6ff` | Links, primary actions, focus/selection (accent emphasis). |
| `surface` | — | `#ffffff` | `#0d1117` | Canvas / page background (light theme default). |
| `text` | — | `#1f2328` | `#e6edf3` | Default foreground text (fg.default #1f2328). |
| `textMuted` | — | `#57606a` | — | Muted/secondary foreground (fg.muted). |
| `border` | — | `#d0d7de` | — | Default borders/dividers (border.default #d0d7de). |
| `success` | — | `#1a7f37` | — | Success states, merged PRs, checks passed. |
| `danger` | — | `#cf222e` | — | Errors, destructive actions, failed checks, closed-without-merge. |

### Scales

- **primary:** 50 `#f6f6f6`, 100 `#ececec`, 200 `#d8d8d8`, 300 `#bcbcbc`, 400 `#8e8e8e`, 500 `#6a6a6a`, 600 `#4e4e4e`, 700 `#3c3c3c`, 800 `#2a2a2a`, 900 `#1e1e1e`, 950 `#181717`
- **accent:** 50 `#ddf4ff`, 100 `#b6e3ff`, 200 `#80ccff`, 300 `#54aeff`, 400 `#218bff`, 500 `#0969da`, 600 `#0550ae`, 700 `#033d8b`, 800 `#0a3069`, 900 `#002155`, 950 `#001034`
- **surface:** 50 `#ffffff`, 100 `#f6f8fa`, 200 `#eaeef2`, 300 `#d0d7de`, 400 `#afb8c1`, 500 `#8c959f`, 600 `#6e7781`, 700 `#424a53`, 800 `#32383f`, 900 `#24292f`, 950 `#1f2328`
- **text:** 50 `#f6f8fa`, 100 `#eaeef2`, 200 `#d0d7de`, 300 `#afb8c1`, 400 `#8c959f`, 500 `#6e7781`, 600 `#57606a`, 700 `#424a53`, 800 `#32383f`, 900 `#24292f`, 950 `#1f2328`
- **textMuted:** 50 `#f6f8fa`, 100 `#eaeef2`, 200 `#d0d7de`, 300 `#afb8c1`, 400 `#8c959f`, 500 `#6e7781`, 600 `#57606a`, 700 `#424a53`, 800 `#32383f`, 900 `#24292f`, 950 `#1f2328`
- **border:** 50 `#f6f8fa`, 100 `#eaeef2`, 200 `#d8dee4`, 300 `#d0d7de`, 400 `#afb8c1`, 500 `#8c959f`, 600 `#6e7781`, 700 `#424a53`, 800 `#32383f`, 900 `#24292f`, 950 `#1f2328`
- **success:** 50 `#dafbe1`, 100 `#aceebb`, 200 `#6fdd8b`, 300 `#4ac26b`, 400 `#2da44e`, 500 `#1a7f37`, 600 `#116329`, 700 `#044f1e`, 800 `#003d16`, 900 `#002d11`, 950 `#001d0a`
- **danger:** 50 `#ffebe9`, 100 `#ffcecb`, 200 `#ffaba8`, 300 `#ff8182`, 400 `#fa4549`, 500 `#cf222e`, 600 `#a40e26`, 700 `#82071e`, 800 `#660018`, 900 `#4c0014`, 950 `#2d000b`

## Typography

### Families

#### Hubot Sans `hubot-sans`
- **Source:** commissioned
- **Foundry:** GitHub
- **Weights:** 500 Medium, 700 Bold
- **Fallback stack:** `"Hubot Sans", "Mona Sans", sans-serif`
- **Licensing:** Hubot Sans — GitHub, SIL OFL 1.1, self-hostable. Variable font.
- **License:** https://github.com/github/hubot-sans/blob/main/LICENSE
- **Usage:** Expressive headers and pull-quotes; Mona Sans's angular sibling.
- **Variable axes:** wdth 75–125 (def 100), wght 200–900 (def 400)

#### Mona Sans `mona-sans`
- **Source:** commissioned
- **Foundry:** GitHub
- **Weights:** 400 Regular, 500 Medium, 600 SemiBold, 700 Bold, 900 Black
- **Fallback stack:** `"Mona Sans", -apple-system, BlinkMacSystemFont, "Segoe UI", sans-serif`
- **Licensing:** Mona Sans is released by GitHub under the SIL Open Font License 1.1 — free to self-host and redistribute. Variable font (weight + width axes).
- **License:** https://github.com/github/mona-sans/blob/main/LICENSE
- **Usage:** Marketing display and headings; the brand's primary typeface.
- **Variable axes:** wdth 75–125 (def 100), wght 200–900 (def 400)

#### Monaspace Neon `monaspace-neon`
- **Source:** commissioned
- **Foundry:** GitHub Next
- **Weights:** 400 Regular, 700 Bold
- **Fallback stack:** `"Monaspace Neon", ui-monospace, SFMono-Regular, monospace`
- **Licensing:** Monaspace — GitHub, SIL OFL 1.1, self-hostable.
- **License:** https://github.com/githubnext/monaspace/blob/main/LICENSE
- **Variable axes:** wdth 100–125 (def 100), wght 200–800 (def 400)

#### -apple-system `system-stack`
- **Source:** system
- **Weights:** 400 Regular, 600 SemiBold
- **Fallback stack:** `-apple-system, BlinkMacSystemFont, "Segoe UI", "Noto Sans", Helvetica, Arial, sans-serif`
- **Licensing:** System font stack — no file to host or license.

### Role assignments

- **display:** Mona Sans (`mona-sans`) — Full weight/width range for marketing display.
- **heading:** Mona Sans (`mona-sans`) — weights 600, 700
- **body:** -apple-system (`system-stack`) — weights 400, 600
- **mono:** Monaspace Neon (`monaspace-neon`)
- **quote:** Hubot Sans (`hubot-sans`) — weights 500, 700 — GitHub uses Hubot Sans more broadly than quotes — expressive marketing headers too.

### Scale

| Step | Size (rem) | Line height | Tracking (em) |
| --- | --- | --- | --- |
| xs | 0.75 | 1.5 | — |
| sm | 0.875 | 1.5 | — |
| base | 1 | 1.5 | — |
| lg | 1.25 | 1.4 | — |
| xl | 1.5 | 1.3 | — |
| 2xl | 2 | 1.2 | -0.01 |
| display | 3 | 1.1 | -0.02 |

## Logos

### primary
- **Formats:**
  - `svg` (24×24): data:image/svg+xml,%3Csvg%20xmlns%3D%22http%3A%2F%2Fwww.w3.org%2F2000%2Fsvg%22%20viewBox%3D%220%200%2024%2024%22%20role%3D%22img%22%3E%3Ctitle%3EGitHub%3C%2Ftitle%3E%3Cpath%20d%3D%22M12%20.297c-6.63%200-12%205.373-12%2012%200%205.303%203.438%209.8%208.205%2011.385.6.113.82-.258.82-.577%200-.285-.01-1.04-.015-2.04-3.338.724-4.042-1.61-4.042-1.61C4.422%2018.07%203.633%2017.7%203.633%2017.7c-1.087-.744.084-.729.084-.729%201.205.084%201.838%201.236%201.838%201.236%201.07%201.835%202.809%201.305%203.495.998.108-.776.417-1.305.76-1.605-2.665-.3-5.466-1.332-5.466-5.93%200-1.31.465-2.38%201.235-3.22-.135-.303-.54-1.523.105-3.176%200%200%201.005-.322%203.3%201.23.96-.267%201.98-.399%203-.405%201.02.006%202.04.138%203%20.405%202.28-1.552%203.285-1.23%203.285-1.23.645%201.653.24%202.873.12%203.176.765.84%201.23%201.91%201.23%203.22%200%204.61-2.805%205.625-5.475%205.92.42.36.81%201.096.81%202.22%200%201.606-.015%202.896-.015%203.286%200%20.315.21.69.825.57C20.565%2022.092%2024%2017.592%2024%2012.297c0-6.627-5.373-12-12-12%22%20fill%3D%22%23181717%22%2F%3E%3C%2Fsvg%3E
  - `png` (600×168): brands/github/logo-primary@2x.png
- **Clearspace:** 1× cap-height — Clear space equal to the cap-height of the wordmark on all sides.
- **Min size:** 20px h (screen)
- **Allowed backgrounds:** light, muted
- **Disallowed backgrounds:** photo
- **Notes:** Official monochrome mark from simple-icons (CC0 / public domain). Source: https://github.com/logos

### mark
- **Symbol name:** Invertocat
- **Formats:**
  - `svg` (98×96): brands/github/invertocat.svg
- **Clearspace:** 0.5× mark-width
- **Min size:** 16px w (screen)
- **Allowed backgrounds:** any
- **Colors:** text
- **Notes:** The Invertocat — Octocat silhouette. Single color; adapts to background.

### mono
- **Formats:**
  - `svg` (24×24): data:image/svg+xml,%3Csvg%20xmlns%3D%22http%3A%2F%2Fwww.w3.org%2F2000%2Fsvg%22%20viewBox%3D%220%200%2024%2024%22%20role%3D%22img%22%3E%3Ctitle%3EGitHub%3C%2Ftitle%3E%3Cpath%20d%3D%22M12%20.297c-6.63%200-12%205.373-12%2012%200%205.303%203.438%209.8%208.205%2011.385.6.113.82-.258.82-.577%200-.285-.01-1.04-.015-2.04-3.338.724-4.042-1.61-4.042-1.61C4.422%2018.07%203.633%2017.7%203.633%2017.7c-1.087-.744.084-.729.084-.729%201.205.084%201.838%201.236%201.838%201.236%201.07%201.835%202.809%201.305%203.495.998.108-.776.417-1.305.76-1.605-2.665-.3-5.466-1.332-5.466-5.93%200-1.31.465-2.38%201.235-3.22-.135-.303-.54-1.523.105-3.176%200%200%201.005-.322%203.3%201.23.96-.267%201.98-.399%203-.405%201.02.006%202.04.138%203%20.405%202.28-1.552%203.285-1.23%203.285-1.23.645%201.653.24%202.873.12%203.176.765.84%201.23%201.91%201.23%203.22%200%204.61-2.805%205.625-5.475%205.92.42.36.81%201.096.81%202.22%200%201.606-.015%202.896-.015%203.286%200%20.315.21.69.825.57C20.565%2022.092%2024%2017.592%2024%2012.297c0-6.627-5.373-12-12-12%22%20fill%3D%22%23111111%22%2F%3E%3C%2Fsvg%3E
- **Clearspace:** 1× logo-height — Default clearspace of one logo-height on all sides (auto-seeded; refine after review).
- **Min size:** 24px w (screen)
- **Allowed backgrounds:** light, muted
- **Disallowed backgrounds:** dark
- **Notes:** Official monochrome mark from simple-icons (CC0 / public domain). Source: https://github.com/logos

### inverse
- **Formats:**
  - `svg` (300×84): brands/github/logo-inverse.svg
- **Clearspace:** 1× cap-height
- **Min size:** 20px h (screen)
- **Allowed backgrounds:** dark, brand, photo
- **Notes:** White lockup for dark backgrounds (dark theme, marketing on dark).

### favicon
- **Formats:**
  - `svg` (32×32): brands/github/favicon.svg
  - `png` (32×32): brands/github/favicon-32.png
  - `ico` (32×32): brands/github/favicon.ico
- **Allowed backgrounds:** any

## Usage Rules

- **[MUST] Meet WCAG AA (Primer baseline)** (accessibility) — Foreground/background pairings must meet 4.5:1 for text, matching Primer's accessibility floor. `contrast-aa`
- **[MAY] Self-host the open typefaces** (typography) — Mona Sans, Hubot Sans, and Monaspace are SIL OFL and may be freely self-hosted and redistributed with attribution. `fonts-open-source`
- **[MUST] Keep the Invertocat single-color** (logo) — The mark is reproduced in one color that contrasts with its background. Never apply gradients or multiple colors. `invertocat-single-color`
- **[MUST] Write the name as 'GitHub'** (voice) — Capital G, capital H, one word. Never 'Github', 'github', or 'GITHUB' in running text. `name-casing`

## Boards

- **Cover** — `cover` (`board-cover`)
- **The Invertocat** — `logo-suite` (`board-logos`)
- **Primer Color** — `color-system` (`board-colors`)
- **Mona Sans & Hubot Sans** — `type-specimen` (`board-type`)
- **Buttons & States** — `ui-preview` (`board-ui`)
- **Voice & Tone** — `voice` (`board-voice`)

## Resources

- Tokens (JSON): /b/github/tokens.json
- Tokens (CSS): /b/github/brand.css
- This document: /b/github/brand.md
- MCP endpoint (public read): mcp.brandsweets.com/github/mcp
- Agent integration guide: /agents.md