16 KiB
Design System
Color Palette Reference
| # | Name | Colors | Style | Use Cases | Tips |
|---|---|---|---|---|---|
| 1 | Modern & Wellness | #006d77 #83c5be #edf6f9 #ffddd2 #e29578 |
Fresh, soothing | Healthcare, counseling, skincare, yoga/spa | Deep teal for titles, light pink for background |
| 2 | Business & Authority | #2b2d42 #8d99ae #edf2f4 #ef233c #d90429 |
Formal, classic | Annual reports, financial analysis, corporate intro, government | Deep blue for professionalism, bright red to highlight data |
| 3 | Nature & Outdoors | #606c38 #283618 #fefae0 #dda15e #bc6c25 |
Grounded, earthy | Outdoor gear, environmental, agriculture, historical culture | Dark green base, cream text |
| 4 | Vintage & Academic | #780000 #c1121f #fdf0d5 #003049 #669bbc |
Classic, scholarly | Academic lectures, history reviews, museums, heritage brands | Strong contrast between deep red and deep blue |
| 5 | Soft & Creative | #cdb4db #ffc8dd #ffafcc #bde0fe #a2d2ff |
Dreamy, candy-toned | Mother & baby, desserts, women's fashion, kindergarten | Use dark gray or black for text |
| 6 | Bohemian | #ccd5ae #e9edc9 #fefae0 #faedcd #d4a373 |
Gentle, muted | Wedding planning, home decor, organic food, slow living | Cream background, green-brown accents |
| 7 | Vibrant & Tech | #8ecae6 #219ebc #023047 #ffb703 #fb8500 |
High energy, sporty | Sports events, gyms, startup pitches, youth education | Deep blue for stability, orange as focal accent |
| 8 | Craft & Artisan | #7f5539 #a68a64 #ede0d4 #656d4a #414833 |
Rustic, coffee-toned | Coffee shops, handicrafts, traditional culture, bakery | Suited for paper/leather textures |
| 9 | Tech & Night | #000814 #001d3d #003566 #ffc300 #ffd60a |
Deep, luminous | Tech launches, astronomy, night economy, luxury automobiles | Must use dark mode |
| 10 | Education & Charts | #264653 #2a9d8f #e9c46a #f4a261 #e76f51 |
Clear, logical | Statistical reports, education, market analysis, general business | Perfect chart color scheme |
| 11 | Forest & Eco | #dad7cd #a3b18a #588157 #3a5a40 #344e41 |
Monochrome gradient, forest | Landscape design, ESG reports, environmental causes, botanical | Monochrome palette is safe and cohesive |
| 12 | Elegant & Fashion | #edafb8 #f7e1d7 #dedbd2 #b0c4b1 #4a5759 |
Muted, Morandi tones | Haute couture, art galleries, beauty brands, magazine style | Negative space is key |
| 13 | Art & Food | #335c67 #fff3b0 #e09f3e #9e2a2b #540b0e |
Rich, vintage-poster | Food documentaries, art exhibitions, ethnic themes, vintage restaurants | Works well with large color blocks |
| 14 | Luxury & Mysterious | #22223b #4a4e69 #9a8c98 #c9ada7 #f2e9e4 |
Cool, purple-toned | Jewelry showcases, hotel management, high-end consulting, psychology | Purple evokes premium atmosphere |
| 15 | Pure Tech Blue | #03045e #0077b6 #00b4d8 #90e0ef #caf0f8 |
Futuristic, clean | Cloud/AI, water/ocean, hospitals, clean energy | Deep ocean to sky gradient |
| 16 | Coastal Coral | #0081a7 #00afb9 #fdfcdc #fed9b7 #f07167 |
Refreshing, summery | Travel, summer events, beverage brands, ocean themes | Teal and coral as complementary focal colors |
| 17 | Vibrant Orange Mint | #ff9f1c #ffbf69 #ffffff #cbf3f0 #2ec4b6 |
Bright, cheerful | Children's events, promotional posters, FMCG, social media | Orange grabs attention, mint feels fresh |
| 18 | Platinum White Gold | #0a0a0a #0070F3 #D4AF37 #f5f5f5 #ffffff |
Premium, professional | Agent products, corporate websites, fintech, luxury brands | White-gold base, blue for action, gold for emphasis |
Agent Design System — Full Color Scale
Based on the Platinum White-Gold Theme design tokens. Provides complete color scales for fine-grained design work.
White Scale (Backgrounds & Light Surfaces)
| Token | Value | Usage |
|---|---|---|
| white-0 | #ffffff |
Primary background |
| white-50 | #fefefe |
Slightly warm white |
| white-75 | #fcfcfc |
Near-white |
| white-100 | #fafafa |
Secondary background |
| white-200 | #f7f7f7 |
Card background |
| white-300 | #f5f5f5 |
Tertiary background |
| white-400 | #f0f0f0 |
Separator zones |
| white-500 | #ebebeb |
Light border |
| white-600 | #e5e5e5 |
Disabled background |
| white-700 | #e0e0e0 |
Deep white-gray |
| white-800 | #d9d9d9 |
Placeholder |
| white-900 | #d4d4d4 |
Divider lines |
| white-1000 | #cccccc |
Deepest white |
Gold Scale (Platinum Business Accent)
| Token | Value | Usage |
|---|---|---|
| gold-25 | #FFFDF5 |
Extremely light gold background |
| gold-50 | #FEF9E7 |
Light gold background |
| gold-75 | #FCF3D0 |
Pale gold highlight |
| gold-100 | #FAECB8 |
Gold hover state |
| gold-200 | #F5DC8A |
Bright gold accent |
| gold-300 | #E8C860 |
Gold hover |
| gold-400 | #D4AF37 |
Primary gold (core) |
| gold-500 | #B8972E |
Gold text |
| gold-600 | #9A7E26 |
Deep gold accent |
| gold-700 | #7C651E |
Dark gold border |
| gold-800 | #5E4C16 |
Deep gold background |
| gold-900 | #40330F |
Very deep gold |
| gold-1000 | #221A08 |
Black gold |
Blue Scale (Primary Action Color)
| Token | Value | Usage |
|---|---|---|
| blue-25 | #F0F7FF |
Extremely light blue background |
| blue-50 | #E0EFFF |
Info alert background |
| blue-75 | #C2DFFF |
Light blue highlight |
| blue-100 | #A3CFFF |
Disabled blue |
| blue-200 | #66AFFF |
Bright blue |
| blue-300 | #338FFF |
Blue hover |
| blue-400 | #0070F3 |
Primary blue (core) |
| blue-500 | #005FCC |
Blue text |
| blue-600 | #004FA6 |
Deep blue accent |
| blue-700 | #003F80 |
Dark blue border |
| blue-800 | #002F5A |
Deep blue background |
| blue-900 | #001F3D |
Very deep blue |
| blue-1000 | #001026 |
Black blue |
Gray Scale (Text & Neutral Colors)
| Token | Value | Usage |
|---|---|---|
| gray-0 | #ffffff |
White |
| gray-50 | #fafafa |
Extremely light gray |
| gray-75 | #f5f5f5 |
Light gray background |
| gray-100 | #ededed |
Light divider |
| gray-200 | #d4d4d4 |
Light border |
| gray-300 | #a3a3a3 |
Quaternary text |
| gray-400 | #737373 |
Tertiary text |
| gray-500 | #525252 |
Secondary text |
| gray-600 | #404040 |
Dark gray |
| gray-700 | #2e2e2e |
Dark background |
| gray-800 | #1f1f1f |
Deep background |
| gray-900 | #141414 |
Very deep background |
| gray-1000 | #0a0a0a |
Primary text (core) |
Opacity Values
Opacity Black
| Opacity | Value | Usage |
|---|---|---|
| 0% | #0a0a0a00 |
Fully transparent |
| 2% | #0a0a0a05 |
Subtle overlay |
| 4% | #0a0a0a0a |
Secondary interactive background |
| 8% | #0a0a0a14 |
Border / divider |
| 15% | #0a0a0a26 |
Pressed state |
| 20% | #0a0a0a33 |
Light overlay |
| 25% | #0a0a0a40 |
Medium overlay |
| 50% | #0a0a0a80 |
Semi-transparent |
| 70% | #0a0a0ab2 |
Deep overlay |
| 80% | #0a0a0acc |
Hover state |
| 90% | #0a0a0ae5 |
Tooltip |
| 95% | #0a0a0af2 |
Modal |
Opacity White
| Opacity | Value | Usage |
|---|---|---|
| 0% | #ffffff00 |
Fully transparent |
| 2% | #ffffff05 |
Subtle overlay |
| 4% | #ffffff0a |
Secondary interactive background |
| 8% | #ffffff12 |
Border / divider |
| 15% | #ffffff26 |
Pressed state |
| 20% | #ffffff33 |
Light overlay |
| 25% | #ffffff40 |
Medium overlay |
| 50% | #ffffff80 |
Semi-transparent |
| 70% | #ffffffb2 |
Deep overlay |
| 80% | #ffffffcc |
Hover state |
| 90% | #ffffffe5 |
Tooltip |
| 95% | #fffffff2 |
Modal |
Color Palette Rules (MANDATORY)
Strict Palette Adherence
Use ONLY the provided color palette. Do NOT create or modify colors.
- All colors must come from the user-provided palette
- Do NOT use colors outside the palette
- Do NOT modify palette colors (brightness, saturation, mixing)
- Only exception: Add transparency using the
transparencyproperty (0-100)
// Correct: Using palette colors
slide.addShape(pres.shapes.RECTANGLE, { fill: { color: theme.primary } });
slide.addText("Title", { color: theme.accent });
// Wrong: Colors outside palette
slide.addShape(pres.shapes.RECTANGLE, { fill: { color: "1a1a2e" } });
No Gradients
Gradients are prohibited. Use solid colors only.
No Animations
Animations and transitions are prohibited. All slides must be static.
Font Reference
Recommended Fonts
| Language | Default Font | Alternatives |
|---|---|---|
| Chinese | Microsoft YaHei | — |
| English | Arial | Georgia, Calibri, Cambria, Trebuchet MS |
- For mixed Chinese-English content: use Microsoft YaHei for Chinese, the chosen font for English
- Prefer system fonts for cross-platform compatibility
- Titles and body text can use different font pairings (e.g. Georgia + Calibri)
Recommended Font Pairings
| Header Font | Body Font |
|---|---|
| Georgia | Calibri |
| Arial Black | Arial |
| Calibri | Calibri Light |
| Cambria | Calibri |
| Trebuchet MS | Calibri |
| Impact | Arial |
| Palatino | Garamond |
| Consolas | Calibri |
Choose an interesting font pairing — don't default to Arial for everything. Pick a header font with personality and pair it with a clean body font.
No Bold for Body Text
Plain body text and caption/legend text must NOT use bold.
- Body paragraphs, descriptions → normal weight
- Captions, legends, footnotes → normal weight
- Reserve bold for titles and headings only
// Correct
slide.addText("Main Title", { bold: true, fontSize: 36, fontFace: "Arial" });
slide.addText("Body text here.", { bold: false, fontSize: 14, fontFace: "Arial" });
// Wrong
slide.addText("Body text here.", { bold: true, fontSize: 14 });
Style Recipes
The same design can be rendered in 4 distinct visual styles by adjusting corner radius (rectRadius) and spacing. Choose the style recipe that fits the presentation tone.
Unit note: PptxGenJS uses inches. Slide dimensions are 10" x 5.625" (LAYOUT_16x9).
Style Overview
| Style | Corner Radius | Spacing | Best For |
|---|---|---|---|
| Sharp & Compact | 0 ~ 0.05" | Tight | Data-dense, tables, professional reports |
| Soft & Balanced | 0.08" ~ 0.12" | Moderate | Corporate, business presentations, general use |
| Rounded & Spacious | 0.15" ~ 0.25" | Relaxed | Product intros, marketing, creative showcases |
| Pill & Airy | 0.3" ~ 0.5" | Open | Brand showcases, launch events, premium presentations |
Sharp & Compact
Visual character: Geometric, high information density, formal and serious.
| Category | Value (inches) | Notes |
|---|---|---|
| Corner radius — small | 0" | Full right angle |
| Corner radius — medium | 0.03" | Micro-rounded |
| Corner radius — large | 0.05" | Slight rounding |
| Element padding | 0.1" ~ 0.15" | Compact |
| Element gap | 0.1" ~ 0.2" | Compact |
| Page margin | 0.3" | Narrow |
| Block gap | 0.25" ~ 0.35" | Compact |
Soft & Balanced
Visual character: Moderate rounding, comfortable whitespace, professional yet approachable.
| Category | Value (inches) | Notes |
|---|---|---|
| Corner radius — small | 0.05" | Slight rounding |
| Corner radius — medium | 0.08" | Medium rounding |
| Corner radius — large | 0.12" | Larger rounding |
| Element padding | 0.15" ~ 0.2" | Moderate |
| Element gap | 0.15" ~ 0.25" | Moderate |
| Page margin | 0.4" | Standard |
| Block gap | 0.35" ~ 0.5" | Moderate |
Rounded & Spacious
Visual character: Large corners, generous whitespace, friendly and modern.
| Category | Value (inches) | Notes |
|---|---|---|
| Corner radius — small | 0.1" | Medium rounding |
| Corner radius — medium | 0.15" | Large rounding |
| Corner radius — large | 0.25" | Very large rounding |
| Element padding | 0.2" ~ 0.3" | Relaxed |
| Element gap | 0.25" ~ 0.4" | Relaxed |
| Page margin | 0.5" | Wide |
| Block gap | 0.5" ~ 0.7" | Relaxed |
Pill & Airy
Visual character: Full pill-shaped corners, abundant whitespace, light and open feel, strong brand presence.
| Category | Value (inches) | Notes |
|---|---|---|
| Corner radius — small | 0.2" | Large rounding |
| Corner radius — medium | 0.3" | Pill shape |
| Corner radius — large | 0.5" | Full pill |
| Element padding | 0.25" ~ 0.4" | Open |
| Element gap | 0.3" ~ 0.5" | Open |
| Page margin | 0.6" | Wide |
| Block gap | 0.6" ~ 0.9" | Open |
Component Style Mapping
| Component | Sharp | Soft | Rounded | Pill |
|---|---|---|---|---|
| Button / Tag | rectRadius: 0 | rectRadius: 0.05 | rectRadius: 0.1 | rectRadius: 0.2 |
| Card / Container | rectRadius: 0.03 | rectRadius: 0.1 | rectRadius: 0.2 | rectRadius: 0.3 |
| Image Container | rectRadius: 0 | rectRadius: 0.08 | rectRadius: 0.15 | rectRadius: 0.25 |
| Input Field | rectRadius: 0 | rectRadius: 0.05 | rectRadius: 0.1 | rectRadius: 0.2 |
| Badge | rectRadius: 0.02 | rectRadius: 0.05 | rectRadius: 0.08 | rectRadius: 0.15 |
| Avatar Frame | rectRadius: 0 | rectRadius: 0.1 | rectRadius: 0.2 | rectRadius: 0.5 (circle) |
PptxGenJS Corner Radius Examples
// Sharp style card
slide.addShape("rect", {
x: 0.5, y: 1, w: 4, h: 2.5,
fill: { color: "F5F5F5" },
rectRadius: 0.03
});
// Rounded style card
slide.addShape("rect", {
x: 0.5, y: 1, w: 4, h: 2.5,
fill: { color: "F5F5F5" },
rectRadius: 0.2
});
// Pill style button (height 0.4", rectRadius 0.2" = perfect pill)
slide.addShape("rect", {
x: 3, y: 4, w: 2, h: 0.4,
fill: { color: "4A90D9" },
rectRadius: 0.2
});
Mixing Rules
1. Outer container corner >= inner element corner
// Correct: outer > inner
card: rectRadius: 0.2
button: rectRadius: 0.1
// Wrong: inner > outer → visual overflow effect
card: rectRadius: 0.1
button: rectRadius: 0.2
2. Information density drives spacing
| Zone Type | Recommended Style |
|---|---|
| Data display zone | Sharp / Soft (compact spacing) |
| Content browsing zone | Rounded / Pill (relaxed spacing) |
| Title zone | Soft / Rounded (moderate spacing) |
3. Corner radius vs element height
| Element Height | Sharp | Soft | Rounded | Pill |
|---|---|---|---|---|
| Small (< 0.3") | 0" | 0.03" | 0.08" | height/2 |
| Medium (0.3" ~ 0.6") | 0.02" | 0.05" | 0.12" | height/2 |
| Large (0.6" ~ 1.2") | 0.03" | 0.08" | 0.2" | 0.3" |
| Extra large (> 1.2") | 0.05" | 0.12" | 0.25" | 0.4" |
Pill tip: For a perfect pill shape, set
rectRadius = element height / 2
Typography Scale (PPT)
| Usage | Size (pt) | Notes |
|---|---|---|
| Annotations / Sources | 10 ~ 12 | Minimum readable size |
| Body / Description | 14 ~ 16 | Standard body |
| Subtitle | 18 ~ 22 | Secondary heading |
| Title | 28 ~ 36 | Page title |
| Large Title | 44 ~ 60 | Cover / section title |
| Data Callout | 60 ~ 96 | Key number display |
Spacing Scale (PPT)
Based on 10" x 5.625" slide dimensions:
| Usage | Recommended (inches) |
|---|---|
| Icon-to-text gap | 0.08" ~ 0.15" |
| List item spacing | 0.15" ~ 0.25" |
| Card inner padding | 0.2" ~ 0.4" |
| Element group gap | 0.3" ~ 0.5" |
| Page safe margin | 0.4" ~ 0.6" |
| Major block gap | 0.5" ~ 0.8" |
Quick Selection Guide
| Presentation Type | Recommended Style | Reason |
|---|---|---|
| Finance / Data reports | Sharp & Compact | High density, serious and precise |
| Corporate / Business | Soft & Balanced | Balances professionalism and approachability |
| Product intro / Marketing | Rounded & Spacious | Modern feel, friendly |
| Launch events / Brand | Pill & Airy | Premium feel, visual impact |
| Training / Education | Soft / Rounded | Clear, readable, friendly |
| Tech sharing | Sharp / Soft | Professional, information-dense |