g1t/apps/docs/src/styles/g1t.css

427 lines10,796 bytesCodeBlame
1/*
2 * g1t's docs: Starlight in g1t's own design. A very dark gray base,
3 * lavender as the accent for links and the current page, quiet
4 * typography, and one theme.
5 */
6:root,
7:root[data-theme='light'] {
8 --sl-font: var(--g1t-font-sans);
9 --sl-font-mono: var(--g1t-font-mono);
10
11 /* Lavender is the docs' accent: links, the current page, highlights. */
12 --sl-color-accent-low: color-mix(in srgb, var(--g1t-merged) 14%, var(--g1t-bg));
13 --sl-color-accent: var(--g1t-merged);
14 --sl-color-accent-high: #d9d1ff;
15
16 --sl-color-white: var(--g1t-fg);
17 --sl-color-gray-1: var(--g1t-fg-soft);
18 --sl-color-gray-2: var(--g1t-fg-soft);
19 --sl-color-gray-3: var(--g1t-muted);
20 --sl-color-gray-4: var(--g1t-faint);
21 --sl-color-gray-5: var(--g1t-line);
22 --sl-color-gray-6: var(--g1t-surface);
23 --sl-color-gray-7: var(--g1t-surface);
24 --sl-color-black: var(--g1t-bg);
25
26 --sl-color-bg: var(--g1t-bg);
27 --sl-color-bg-nav: color-mix(in srgb, var(--g1t-bg) 88%, transparent);
28 --sl-color-bg-sidebar: var(--g1t-bg);
29 --sl-color-hairline: var(--g1t-line);
30 --sl-color-hairline-light: var(--g1t-line);
31 --sl-color-hairline-shade: var(--g1t-line);
32 --sl-color-text: var(--g1t-fg-soft);
33 --sl-color-text-accent: #cfc6ff;
34 --sl-color-text-invert: var(--g1t-bg);
35 --sl-color-bg-inline-code: var(--g1t-raised);
36
37 --sl-text-body: 0.9375rem;
38 --sl-line-height: 1.75;
39 --sl-content-width: 46rem;
40 /* The header's row, as tall as the app's top bar (4rem), and the tabs
41 beneath it. */
42 --sl-nav-height: 6.75rem;
43 --sl-sidebar-width: 17rem;
44
45 color-scheme: dark;
46}
47
48/* There is one theme, so the switcher has nothing to switch. */
49starlight-theme-select {
50 display: none;
51}
52
53/* --- Header --------------------------------------------------------------- */
54
55header.header {
56 padding: 0 !important;
57 backdrop-filter: blur(10px);
58 border-bottom: 1px solid var(--g1t-line);
59}
60site-search {
61 width: 100%;
62 max-width: 30rem;
63}
64/* On phones the menu button sits in the header's top row, not its middle. */
65.sl-menu-button {
66 top: calc((4rem - var(--sl-menu-button-size)) / 2) !important;
67}
68site-search button[data-open-modal] {
69 border-radius: 0.5rem;
70 background: var(--g1t-surface);
71 border-color: var(--g1t-line);
72 color: var(--g1t-faint);
73}
74site-search button[data-open-modal]:hover {
75 border-color: var(--g1t-line-strong);
76 color: var(--g1t-muted);
77}
78
79/* --- Sidebar -------------------------------------------------------------- */
80
81.sidebar-content {
82 padding-top: 1.25rem;
83}
84/* Groups always show their pages: no caret, no folding. */
85.sidebar-content details > summary {
86 pointer-events: none;
87 padding-top: 0.25rem;
88}
89.sidebar-content details > summary .caret {
90 display: none;
91}
92.sidebar-content .top-level > li + li {
93 margin-top: 1rem;
94}
95/* Group labels: small and quiet, like section names, not links. */
96.sidebar-content details > summary .group-label .large,
97.sidebar-content .top-level > li > details > summary {
98 font-size: 0.75rem;
99 font-weight: 600;
100 letter-spacing: 0.06em;
101 text-transform: uppercase;
102 color: var(--g1t-faint);
103}
104.sidebar-content ul ul,
105.sidebar-content ul ul li {
106 border-inline-start: 0;
107 margin-inline-start: 0;
108 padding-inline-start: 0;
109}
110.sidebar-content a {
111 border-radius: 0.375rem;
112 padding: 0.32rem 0.6rem;
113 font-size: 0.875rem;
114 color: var(--g1t-muted);
115}
116.sidebar-content a:hover {
117 background: var(--g1t-surface);
118 color: var(--g1t-fg);
119}
120/* The current page: brighter text and a lavender mark, not a filled bar.
121 Square on the mark's side, so the mark is a straight line. */
122.sidebar-content a[aria-current='page'],
123.sidebar-content a[aria-current='page']:hover {
124 border-radius: 0 0.375rem 0.375rem 0;
125 background: var(--g1t-surface);
126 color: var(--g1t-fg);
127 font-weight: 500;
128 box-shadow: inset 2px 0 0 var(--g1t-merged);
129}
130
131/* --- Content -------------------------------------------------------------- */
132
133.content-panel {
134 padding-top: 2rem;
135}
136/* The title and the page read as one, without a rule between them. */
137.content-panel + .content-panel {
138 border-top: 0;
139 padding-top: 0.5rem;
140}
141/* Headlines in Bricolage Grotesque, its optical size following the size. */
142.sl-markdown-content :is(h1, h2) {
143 font-family: var(--g1t-font-display);
144 font-optical-sizing: auto;
145}
146.sl-markdown-content h1 {
147 font-size: 2.25rem;
148 font-weight: 650;
149 letter-spacing: -0.02em;
150 line-height: 1.15;
151 color: var(--g1t-fg);
152}
153/* Sections open with space, not rules. */
154.sl-markdown-content .sl-heading-wrapper.level-h2 {
155 margin-top: 3rem;
156}
157.sl-markdown-content h2 {
158 font-size: 1.5rem;
159 font-weight: 600;
160 letter-spacing: -0.01em;
161 color: var(--g1t-fg);
162}
163.sl-markdown-content h3 {
164 margin-top: 2rem;
165 font-size: 1.1rem;
166 font-weight: 600;
167 letter-spacing: -0.005em;
168 color: var(--g1t-fg);
169}
170.sl-markdown-content p,
171.sl-markdown-content li {
172 color: var(--g1t-fg-soft);
173}
174.sl-markdown-content a:not(.card, .sl-link-button, .sl-link-card) {
175 color: #cfc6ff;
176 text-decoration-color: color-mix(in srgb, var(--g1t-merged) 45%, transparent);
177 text-underline-offset: 0.2em;
178}
179.sl-markdown-content a:not(.card, .sl-link-button, .sl-link-card):hover {
180 text-decoration-color: var(--g1t-merged);
181}
182.sl-markdown-content :not(pre) > code {
183 border-radius: 0.3rem;
184 padding: 0.1rem 0.3rem;
185 font-size: 0.85em;
186 color: var(--g1t-fg);
187 background: var(--g1t-raised);
188}
189
190/* Tables: ruled, not boxed. */
191.sl-markdown-content table {
192 display: table;
193 width: 100%;
194 border-collapse: collapse;
195 font-size: 0.875rem;
196}
197/* On a phone a wide table scrolls inside itself, not the page. */
198@media (max-width: 50rem) {
199 .sl-markdown-content table {
200 display: block;
201 overflow-x: auto;
202 }
203}
204.sl-markdown-content th {
205 border-bottom: 1px solid var(--g1t-line-strong);
206 background: transparent;
207 font-weight: 600;
208 color: var(--g1t-muted);
209 text-align: start;
210}
211.sl-markdown-content td,
212.sl-markdown-content th {
213 padding: 0.6rem 0.75rem;
214 border-inline: 0;
215 border-top: 0;
216}
217.sl-markdown-content td {
218 border-bottom: 1px solid var(--g1t-line);
219 vertical-align: top;
220}
221.sl-markdown-content tr:nth-child(2n) {
222 background: transparent;
223}
224
225/* Callouts: a tinted panel with a coloured edge. */
226.starlight-aside {
227 border: 0;
228 border-inline-start: 2px solid;
229 border-radius: 0 0.6rem 0.6rem 0;
230 padding: 0.85rem 1.1rem;
231}
232.starlight-aside--note {
233 border-color: var(--g1t-info);
234 background: color-mix(in srgb, var(--g1t-info) 7%, var(--g1t-bg));
235}
236.starlight-aside--tip {
237 border-color: var(--g1t-accent);
238 background: color-mix(in srgb, var(--g1t-accent) 6%, var(--g1t-bg));
239}
240.starlight-aside--caution {
241 border-color: var(--g1t-warn);
242 background: color-mix(in srgb, var(--g1t-warn) 7%, var(--g1t-bg));
243}
244.starlight-aside--danger {
245 border-color: var(--g1t-danger);
246 background: color-mix(in srgb, var(--g1t-danger) 7%, var(--g1t-bg));
247}
248
249/* --- On this page --------------------------------------------------------- */
250
251.right-sidebar-panel h2 {
252 font-size: 0.75rem;
253 font-weight: 600;
254 letter-spacing: 0.06em;
255 text-transform: uppercase;
256 color: var(--g1t-faint);
257}
258.right-sidebar-panel a {
259 font-size: 0.8125rem;
260 color: var(--g1t-muted);
261}
262.right-sidebar-panel a:hover {
263 color: var(--g1t-fg);
264}
265.right-sidebar-panel a[aria-current='true'] {
266 color: #cfc6ff;
267}
268
269/* --- Cards and buttons ---------------------------------------------------- */
270
271.card,
272.sl-link-card {
273 border-radius: 1rem;
274 background: var(--g1t-surface);
275 border: 1px solid var(--g1t-line);
276 transition: border-color 0.15s;
277}
278.sl-link-card:hover {
279 border-color: var(--g1t-line-strong);
280 background: var(--g1t-surface);
281}
282.sl-link-button {
283 border-radius: 0.5rem;
284 font-size: 0.9rem;
285 font-weight: 500;
286}
287.sl-link-button.primary {
288 background: var(--g1t-fg);
289 border-color: var(--g1t-fg);
290 color: var(--g1t-bg);
291}
292.sl-link-button.primary:hover {
293 background: #fff;
294}
295.sl-link-button.minimal {
296 color: var(--g1t-fg-soft);
297}
298
299/* --- Pagination and footer ----------------------------------------------- */
300
301.pagination-links a {
302 border-radius: 0.75rem;
303 border-color: var(--g1t-line);
304 box-shadow: none;
305}
306.pagination-links a:hover {
307 border-color: var(--g1t-line-strong);
308}
309.pagination-links a .link-title {
310 color: var(--g1t-fg);
311}
312.meta,
313.meta a {
314 font-size: 0.8125rem;
315 color: var(--g1t-faint);
316}
317
318/* --- Cards ---------------------------------------------------------------- */
319
320.sl-markdown-content .card-grid {
321 gap: 0.75rem;
322}
323.sl-markdown-content .card {
324 padding: 1.1rem 1.2rem;
325}
326.sl-markdown-content .card .title {
327 font-size: 1rem;
328 font-weight: 600;
329 color: var(--g1t-fg);
330}
331.sl-markdown-content .card .icon {
332 color: var(--g1t-merged);
333 background: color-mix(in srgb, var(--g1t-merged) 12%, transparent);
334 border: 0;
335 border-radius: 0.5rem;
336 padding: 0.3rem;
337}
338.sl-link-card {
339 padding: 1rem 1.2rem;
340}
341.sl-link-card .title {
342 font-size: 0.95rem;
343 font-weight: 600;
344 color: var(--g1t-fg);
345}
346.sl-link-card .description {
347 font-size: 0.85rem;
348 color: var(--g1t-muted);
349}
350
351/* Steps: numbered, on a quiet rail. */
352.sl-steps > li::before {
353 background: var(--g1t-raised) !important;
354 color: var(--g1t-fg) !important;
355 box-shadow: inset 0 0 0 1px var(--g1t-line-strong);
356 font-family: var(--g1t-font-mono);
357 font-size: 0.8rem;
358}
359.sl-steps > li::after {
360 background: var(--g1t-line) !important;
361}
362
363/* --- API reference -------------------------------------------------------- */
364
365/* An operation's method and path, at the top of its page. */
366.sl-markdown-content .g1t-endpoint {
367 display: flex;
368 align-items: center;
369 gap: 0.75rem;
370 overflow-x: auto;
371 border: 1px solid var(--g1t-line);
372 border-radius: 0.75rem;
373 padding: 0.7rem 0.9rem;
374 background: var(--g1t-surface);
375}
376.sl-markdown-content .g1t-endpoint code {
377 padding: 0;
378 background: transparent;
379 font-size: 0.875rem;
380 white-space: nowrap;
381 color: var(--g1t-fg);
382}
383/* Methods: the same small mono tag in the sidebar and on the page. */
384.g1t-method {
385 --method: var(--g1t-muted);
386 flex-shrink: 0;
387 border: 0 !important;
388 border-radius: 0.3rem;
389 padding: 0.05rem 0.4rem;
390 background: color-mix(in srgb, var(--method) 14%, transparent) !important;
391 color: var(--method) !important;
392 font-family: var(--g1t-font-mono);
393 font-size: 0.7rem;
394 font-weight: 600;
395 letter-spacing: 0.02em;
396}
397.g1t-method-get,
398.g1t-method[data-method='get'] {
399 --method: var(--g1t-accent);
400}
401.g1t-method-post,
402.g1t-method[data-method='post'] {
403 --method: var(--g1t-info);
404}
405.g1t-method-put,
406.g1t-method-patch,
407.g1t-method[data-method='put'],
408.g1t-method[data-method='patch'] {
409 --method: var(--g1t-warn);
410}
411.g1t-method-delete,
412.g1t-method[data-method='delete'] {
413 --method: var(--g1t-danger);
414}
415/* In the sidebar the method sits at the end of the row, in a fixed column. */
416.sidebar-content a:has(.g1t-method) {
417 display: flex;
418 justify-content: space-between;
419 align-items: center;
420 gap: 0.5rem;
421}
422.sidebar-content .g1t-method {
423 min-width: 3.1rem;
424 text-align: center;
425 font-size: 0.625rem;
426 line-height: 1.6;
427}