|
1 | | ---- |
2 | | -version: alpha |
3 | | -name: marimo |
4 | | -description: Design system for marimo, a reactive Python notebook for reproducible, git-friendly, deployable work. |
5 | | -colors: |
6 | | - background: "#FFFFFF" |
7 | | - background-dark: "#181C1A" |
8 | | - foreground: "#0F172A" |
9 | | - foreground-dark: "#ECEEED" |
10 | | - surface-muted: "#F1F5F9" |
11 | | - surface-muted-dark: "#020303" |
12 | | - muted-foreground: "#64748B" |
13 | | - muted-foreground-dark: "#AAB2AF" |
14 | | - popover: "#FFFFFF" |
15 | | - popover-dark: "#252927" |
16 | | - popover-foreground: "#0F172A" |
17 | | - popover-foreground-dark: "#AAB2AF" |
18 | | - card: "#FFFFFF" |
19 | | - card-dark: "#252927" |
20 | | - card-foreground: "#0F172A" |
21 | | - card-foreground-dark: "#C0C6C3" |
22 | | - border: "#E2E8F0" |
23 | | - border-dark: "#3B403E" |
24 | | - input: "#A3A3A3" |
25 | | - input-dark: "#474C4A" |
26 | | - primary: "#0880EA" |
27 | | - primary-dark: "#28879F" |
28 | | - on-primary: "#F8FAFC" |
29 | | - on-primary-dark: "#B6ECF7" |
30 | | - secondary: "#F1F5F9" |
31 | | - secondary-dark: "#ECEEED" |
32 | | - on-secondary: "#0F172A" |
33 | | - on-secondary-dark: "#252927" |
34 | | - accent: "#EDF6FF" |
35 | | - accent-dark: "#1D5B6A" |
36 | | - on-accent: "#0B68CB" |
37 | | - on-accent-dark: "#B6ECF7" |
38 | | - ring: "#94A3B8" |
39 | | - destructive: "#FF6666" |
40 | | - on-destructive: "#F8FAFC" |
41 | | - error: "#EA5D5D" |
42 | | - on-error: "#F8FAFC" |
43 | | - success: "#66FF7F" |
44 | | - on-success: "#F8FAFC" |
45 | | - action: "#FEF2A5" |
46 | | - action-hover: "#FFF8BB" |
47 | | - on-action: "#946800" |
48 | | - link: "#0B68CB" |
49 | | - link-dark: "#479BF5" |
50 | | - link-visited: "#8E4EC6" |
51 | | - link-visited-dark: "#BF9BDF" |
52 | | - stale: "#AF8931" |
53 | | - code-background: "#FFFFFF" |
54 | | - code-background-dark: "#282C34" |
55 | | - surface: "#FFFFFF" |
56 | | - surface-dark: "#252927" |
57 | | - data-grid-accent: "#7C3AED" |
58 | | -typography: |
59 | | - body-md: |
60 | | - fontFamily: PT Sans |
61 | | - fontSize: 1rem |
62 | | - fontWeight: "400" |
63 | | - lineHeight: 1.75rem |
64 | | - letterSpacing: 0em |
65 | | - body-sm: |
66 | | - fontFamily: PT Sans |
67 | | - fontSize: 0.875rem |
68 | | - fontWeight: "400" |
69 | | - lineHeight: 1.25rem |
70 | | - letterSpacing: 0em |
71 | | - label-md: |
72 | | - fontFamily: PT Sans |
73 | | - fontSize: 0.875rem |
74 | | - fontWeight: "500" |
75 | | - lineHeight: "1" |
76 | | - letterSpacing: 0em |
77 | | - label-xs: |
78 | | - fontFamily: PT Sans |
79 | | - fontSize: 0.75rem |
80 | | - fontWeight: "600" |
81 | | - lineHeight: 1rem |
82 | | - letterSpacing: 0em |
83 | | - markdown-heading: |
84 | | - fontFamily: Lora |
85 | | - fontSize: 1.875rem |
86 | | - fontWeight: "600" |
87 | | - lineHeight: 2.25rem |
88 | | - letterSpacing: -0.025em |
89 | | - code-editor: |
90 | | - fontFamily: Fira Mono |
91 | | - fontSize: 14px |
92 | | - fontWeight: "400" |
93 | | - lineHeight: 1.25rem |
94 | | - letterSpacing: 0em |
95 | | - slide-h1: |
96 | | - fontFamily: PT Sans |
97 | | - fontSize: 4.375rem |
98 | | - fontWeight: "600" |
99 | | - lineHeight: "1.2" |
100 | | - letterSpacing: 0em |
101 | | -rounded: |
102 | | - sm: 4px |
103 | | - DEFAULT: 8px |
104 | | - md: 6px |
105 | | - lg: 8px |
106 | | - cell: 10px |
107 | | - xl: 0.75rem |
108 | | - full: 9999px |
109 | | -spacing: |
110 | | - unit: 0.5rem |
111 | | - xs: 0.25rem |
112 | | - sm: 0.5rem |
113 | | - md: 1rem |
114 | | - lg: 1.5rem |
115 | | - xl: 3rem |
116 | | - content-compact: 740px |
117 | | - content-medium: 1110px |
118 | | - content-wide: 1400px |
119 | | - grid-row-height: 20px |
120 | | - grid-columns: "24" |
121 | | -components: |
122 | | - app-shell: |
123 | | - backgroundColor: "{colors.background}" |
124 | | - textColor: "{colors.foreground}" |
125 | | - typography: "{typography.body-md}" |
126 | | - cell: |
127 | | - backgroundColor: "{colors.surface}" |
128 | | - textColor: "{colors.foreground}" |
129 | | - typography: "{typography.body-md}" |
130 | | - rounded: "{rounded.cell}" |
131 | | - width: 100% |
132 | | - output-area: |
133 | | - backgroundColor: "{colors.surface}" |
134 | | - textColor: "{colors.foreground}" |
135 | | - typography: "{typography.body-md}" |
136 | | - padding: 1rem |
137 | | - width: 100% |
138 | | - code-editor: |
139 | | - backgroundColor: "{colors.code-background}" |
140 | | - textColor: "{colors.foreground}" |
141 | | - typography: "{typography.code-editor}" |
142 | | - width: 100% |
143 | | - button-primary: |
144 | | - backgroundColor: "{colors.primary}" |
145 | | - textColor: "{colors.on-primary}" |
146 | | - typography: "{typography.label-md}" |
147 | | - rounded: "{rounded.md}" |
148 | | - height: 2.25rem |
149 | | - button-action: |
150 | | - backgroundColor: "{colors.action}" |
151 | | - textColor: "{colors.on-action}" |
152 | | - typography: "{typography.label-md}" |
153 | | - rounded: "{rounded.md}" |
154 | | - height: 2.25rem |
155 | | - input: |
156 | | - backgroundColor: "{colors.background}" |
157 | | - textColor: "{colors.foreground}" |
158 | | - typography: "{typography.code-editor}" |
159 | | - rounded: "{rounded.sm}" |
160 | | - height: 1.5rem |
161 | | - data-table: |
162 | | - backgroundColor: "{colors.surface}" |
163 | | - textColor: "{colors.foreground}" |
164 | | - typography: "{typography.body-sm}" |
165 | | - width: 100% |
166 | | ---- |
167 | | - |
168 | | -<!-- Generated by scripts/generate-design-md.ts. --> |
169 | | - |
170 | | -## Intent |
171 | | - |
172 | | -marimo UI should feel compact, calm, readable, and native to a reactive notebook. Prefer clear controls, quiet surfaces, precise spacing, and useful output over decorative gradients or marketing layouts. |
173 | | - |
174 | | -## Token Use |
175 | | - |
176 | | -The YAML frontmatter is generated from marimo frontend tokens and layout defaults. Component entries are intentionally small: they are canonical examples, not a reverse-engineered inventory of every UI primitive. |
177 | | - |
178 | | -Use related token families for variants: hover, active, dark, destructive, error, success, stale, and visited states should derive from the same color families as their base component. |
179 | | - |
180 | | -## Brand Assets |
181 | | - |
182 | | -- Logo SVG: https://raw.githubusercontent.com/marimo-team/marimo/main/docs/_static/marimo-logotype-thick.svg |
183 | | -- Preserve the original aspect ratio. |
184 | | -- Do not recolor unless explicitly requested. |
185 | | - |
186 | | -## Components |
187 | | - |
188 | | -Buttons should use compact heights, label typography, md radius, and the primary, secondary, or action color families. Inputs should be compact, bordered, readable, and use code typography for code-like values. |
189 | | - |
190 | | -Notebook cells, outputs, code editors, and data views should be full-width, overflow-safe, and visually quieter than the controls around them. |
191 | | - |
192 | | -## UI Guidance |
193 | | - |
194 | | -- Use PT Sans for UI and prose, Lora for authored markdown headings, and Fira Mono for code-like values. |
195 | | -- Keep controls compact and use generated tokens for sizing, radius, and semantic colors. |
196 | | -- Use borders first and subtle shadows second. Avoid floating section cards and nested cards. |
197 | | -- Reserve wider layouts for grids, dashboards, slides, and apps that need comparison or scanning. |
198 | | - |
199 | | -## Motion |
200 | | - |
201 | | -Use short, functional motion for state changes, loading, focus, and drag interactions. Avoid decorative animation. |
0 commit comments