Vue.js progressive docs

A progressive documentation system driving modern web libraries, combining vibrant Vue Green, deep c...
Back to Home
01

Visual Theme & Atmosphere

# Design System — Vue.js (VitePress Documentation Style)

Extracted and adapted from [cn.vuejs.org](https://cn.vuejs.org) and [vuejs.org](https://vuejs.org). A content-first, developer-friendly documentation design system characterized by vibrant Vue Green accents, soft semantic highlights, progressive layout flow, and exceptionally legible dark-theme code blocks.

---

Live Visual Theme Representation:

Visual Theme Example

02

Color Palette & Roles

primary
#42b883
primary-focus
#338a60
canvas
#ffffff
surface-card
#f6f6f7
surface-soft
#f6f6f7
ink
#2c3e50
body
#2c3e50
muted
#476582
hairline
#e2e2e3
03

Typography Rules

Dynamic Preview:
display-xl size: 38px | weight: 700 | height: 1.2 | spacing: 0
The quick brown fox jumps over the lazy dog
Use: Page Heading
body-md size: 16px | weight: 400 | height: 1.6 | spacing: 0
The quick brown fox jumps over the lazy dog
Use: Primary Body
04

Layout Principles

Grid Layout Wireframe Mockup:

Layout Grid Example

Layout Wireframe blueprint
1
2
3
4
5
6
7
8
9
10
11
12
Gutter spacing: 16px / 24px
Side Margins: 24px (Mobile) / 48px (Desktop)
Max Container Width: 1200px
05

Depth & Elevation

Elevation Level Showcase:

Elevation Level Example

Flat Surface (Level 0)

Used for background layers, sidebar headers, or baseline borders.

Low Elevation (Level 1 / Card)

Used for floating product elements, cards, and hover states.

High Elevation (Level 2 / Popover & Dropdown)

Used for modals, select menus, code editor tooltips, and overlay headers.

Border Radius & Shape Scale:

radius-sm 4px
radius-md 6px
radius-lg 8px
radius-pill Pill / Tag
06

Component Stylings

Interactive Component Demonstrations:

Component Interactive Example

07

Do's and Don'ts

Do

  • Keep documentation layout flat and focused on readability.
  • Use monospaced fonts for paths, variables, and terminal commands.
  • Limit bright brand gradients to main logos and call-to-action cards.

Don't

  • Don't use overly stylized buttons or elements that distract from raw documentation content.
  • Don't use heavy cards with deep blur box-shadows.
  • Don't mix bright brand gradients inside long reading blocks.
✅ Recommended / Do
  • Keep documentation layout flat and focused on readability.
  • Use monospaced fonts for paths, variables, and terminal commands.
  • Limit bright brand gradients to main logos and call-to-action cards.
❌ Discouraged / Don't
  • Don't use overly stylized buttons or elements that distract from raw documentation content.
  • Don't use heavy cards with deep blur box-shadows.
  • Don't mix bright brand gradients inside long reading blocks.
08

Responsive Behavior

Responsive Adaptation Note:

Responsive Behavior Example

Interactive Viewport Simulator
Width: 800px (Desktop Mode) Grid Container
Primary Column

Adjusts layout width

Secondary Column

Folds on viewport change

Sidebar Column

Stacks to bottom on mobile

09

Agent Prompt Guide

Copyable Agent Integration Prompt:

Prompt Guide Copy Box

10

Full System Design Tokens

The parsed design tokens extracted from the core stylesheet of this design system:

Design TokenHex ValueSystem Palette Role
--primary#42b883System color representation for primary
--primary-focus#338a60System color representation for primary-focus
--canvas#ffffffSystem color representation for canvas
--surface-card#f6f6f7System color representation for surface-card
--surface-soft#f6f6f7System color representation for surface-soft
--ink#2c3e50System color representation for ink
--body#2c3e50System color representation for body
--muted#476582System color representation for muted
--hairline#e2e2e3System color representation for hairline