Skip to content

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

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