GitHub-inspired DESIGN.md

Code hosting. Neutral grays, Mona Sans, developer documentation and repository browse aesthetic.

CursorClaude CodeCodexGoogle StitchLovableBoltv0Figma Make

2,472 copies1,688 saves1,368 downloads

Added by

May 8, 2026

Tags

brand-inspireddesign-mdgithubsaas

# GitHub-inspired DESIGN.md
## Product feel
Code hosting. Neutral grays, Mona Sans, developer documentation and repository browse aesthetic.
Build for a Supabase-style, Dark command center, AI app visual taste. Keep density practical, typography strong, and layouts easy for AI agents to repeat.
## Color direction
- Primary text: #111827
- Accent / interactive: #3b82f6
- Surface: #f8fafc
- Border / separators: #cbd5e1
## Typography
- Use a modern sans for body copy and a sharper display face for hero/page titles.
- Titles should feel deliberate, not shouty. Avoid oversized marketing fluff.
- Meta text should stay compact and quiet.
## Layout rules
- Prefer light UI by default.
- Use compact spacing and card grids that still feel breathable.
- Keep navigation practical: search first, then filters, then actions.
- This entry belongs to the "brand-inspired" lane.
## Components
- Buttons: slightly rounded, clear hierarchy, only one primary CTA per section.
- Cards: soft border, useful metadata, preview-first composition.
- Empty states: helpful, never dead.
- Code panels: mono, dense, copy-friendly.
## Agent rules
- Do not generate generic Tailwind marketing blocks.
- Respect the palette and keep component states consistent.
- Optimize for these tools: Cursor, Claude Code, Codex, Google Stitch, Lovable, Bolt, v0, Figma Make.
## Accessibility
- Preserve contrast for text and controls.
- Use visible focus states.
- Avoid relying on color alone for meaning.
## License
Reference only
## Disclaimer

Color Palette

TEXT

#111827

ACCENT

#3b82f6

SURFACE

#f8fafc

BORDER

#cbd5e1

Typography

Mona Sans

Mona Sans variable font; Monaspace Neon for code.

display

4.5rem / 600 / 1.04

The quick brown fox

heading-lg

3rem / 700 / 1.07

The quick brown fox

heading

2rem / 600 / 1.1

The quick brown fox jumps

heading-sm

1.25rem / 600 / 1.2

The quick brown fox jumps

body

1rem / 400 / 1.5

The quick brown fox jumps over the lazy dog

caption

0.75rem / 400 / 1.5

The quick brown fox jumps over the lazy dog

Design Tokens

Spacing

space-14px

space-28px

space-312px

space-416px

space-624px

space-832px

space-1248px

space-1664px

Border Radius

radius-none0px

radius-sm4px

radius-md8px

radius-lg16px

radius-xl24px

radius-full9999px

Elevation

Flatshadow-none

XSshadow-xs

SMshadow-sm

MDshadow-md

LGshadow-lg

XLshadow-xl

Related DESIGN.md files

Inngest

Event-driven functions platform. Clean developer UI.

Fly.io

Run apps close to users. Dark terminal aesthetic.

Trigger.dev

Background jobs for developers. Dark minimal devtool.

Turso

Edge-native SQLite. Dark, minimal, developer-brand.

Raycast

Productivity launcher for Mac. Dark, minimal, keyboard-first.

Render

Cloud hosting platform. Clean, modern, accessible.

PostHog

Open-source product analytics. Dark, bold, opinionated.

GitHub

Code hosting and collaboration. Iconic devtool UI.

FAQ

Can I use this with Cursor or Claude Code?

Yes. Copy the DESIGN.md into your project root and ask the agent to follow it.

Is this official?

No — this is an independent reference.

How do I add this to my project?

Copy the markdown into a DESIGN.md file in your repo root and mention it in your agent prompt.