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

432 lines10,973 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 (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-merged);
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-merged) 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-merged);
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.sl-markdown-content th {
210 border-bottom: 1px solid var(--g1t-line-strong);
211 background: transparent;
212 font-weight: 600;
213 color: var(--g1t-muted);
214 text-align: start;
215}
216.sl-markdown-content td,
217.sl-markdown-content th {
218 padding: 0.6rem 0.75rem;
219 border-inline: 0;
220 border-top: 0;
221}
222.sl-markdown-content td {
223 border-bottom: 1px solid var(--g1t-line);
224 vertical-align: top;
225}
226.sl-markdown-content tr:nth-child(2n) {
227 background: transparent;
228}
229
230/* Callouts: a tinted panel with a coloured edge. */
231.starlight-aside {
232 border: 0;
233 border-inline-start: 2px solid;
234 border-radius: 0 0.6rem 0.6rem 0;
235 padding: 0.85rem 1.1rem;
236}
237.starlight-aside--note {
238 border-color: var(--g1t-info);
239 background: color-mix(in srgb, var(--g1t-info) 7%, var(--g1t-bg));
240}
241.starlight-aside--tip {
242 border-color: var(--g1t-accent);
243 background: color-mix(in srgb, var(--g1t-accent) 6%, var(--g1t-bg));
244}
245.starlight-aside--caution {
246 border-color: var(--g1t-warn);
247 background: color-mix(in srgb, var(--g1t-warn) 7%, var(--g1t-bg));
248}
249.starlight-aside--danger {
250 border-color: var(--g1t-danger);
251 background: color-mix(in srgb, var(--g1t-danger) 7%, var(--g1t-bg));
252}
253
254/* --- On this page --------------------------------------------------------- */
255
256.right-sidebar-panel h2 {
257 font-size: 0.75rem;
258 font-weight: 600;
259 letter-spacing: 0.06em;
260 text-transform: uppercase;
261 color: var(--g1t-faint);
262}
263.right-sidebar-panel a {
264 font-size: 0.8125rem;
265 color: var(--g1t-muted);
266}
267.right-sidebar-panel a:hover {
268 color: var(--g1t-fg);
269}
270.right-sidebar-panel a[aria-current='true'] {
271 color: #cfc6ff;
272}
273
274/* --- Cards and buttons ---------------------------------------------------- */
275
276.card,
277.sl-link-card {
278 border-radius: 1rem;
279 background: var(--g1t-surface);
280 border: 1px solid var(--g1t-line);
281 transition: border-color 0.15s;
282}
283.sl-link-card:hover {
284 border-color: var(--g1t-line-strong);
285 background: var(--g1t-surface);
286}
287.sl-link-button {
288 border-radius: 0.5rem;
289 font-size: 0.9rem;
290 font-weight: 500;
291}
292.sl-link-button.primary {
293 background: var(--g1t-fg);
294 border-color: var(--g1t-fg);
295 color: var(--g1t-bg);
296}
297.sl-link-button.primary:hover {
298 background: #fff;
299}
300.sl-link-button.minimal {
301 color: var(--g1t-fg-soft);
302}
303
304/* --- Pagination and footer ----------------------------------------------- */
305
306.pagination-links a {
307 border-radius: 0.75rem;
308 border-color: var(--g1t-line);
309 box-shadow: none;
310}
311.pagination-links a:hover {
312 border-color: var(--g1t-line-strong);
313}
314.pagination-links a .link-title {
315 color: var(--g1t-fg);
316}
317.meta,
318.meta a {
319 font-size: 0.8125rem;
320 color: var(--g1t-faint);
321}
322
323/* --- Cards ---------------------------------------------------------------- */
324
325.sl-markdown-content .card-grid {
326 gap: 0.75rem;
327}
328.sl-markdown-content .card {
329 padding: 1.1rem 1.2rem;
330}
331.sl-markdown-content .card .title {
332 font-size: 1rem;
333 font-weight: 600;
334 color: var(--g1t-fg);
335}
336.sl-markdown-content .card .icon {
337 color: var(--g1t-merged);
338 background: color-mix(in srgb, var(--g1t-merged) 12%, transparent);
339 border: 0;
340 border-radius: 0.5rem;
341 padding: 0.3rem;
342}
343.sl-link-card {
344 padding: 1rem 1.2rem;
345}
346.sl-link-card .title {
347 font-size: 0.95rem;
348 font-weight: 600;
349 color: var(--g1t-fg);
350}
351.sl-link-card .description {
352 font-size: 0.85rem;
353 color: var(--g1t-muted);
354}
355
356/* Steps: numbered, on a quiet rail. */
357.sl-steps > li::before {
358 background: var(--g1t-raised) !important;
359 color: var(--g1t-fg) !important;
360 box-shadow: inset 0 0 0 1px var(--g1t-line-strong);
361 font-family: var(--g1t-font-mono);
362 font-size: 0.8rem;
363}
364.sl-steps > li::after {
365 background: var(--g1t-line) !important;
366}
367
368/* --- API reference -------------------------------------------------------- */
369
370/* An operation's method and path, at the top of its page. */
371.sl-markdown-content .g1t-endpoint {
372 display: flex;
373 align-items: center;
374 gap: 0.75rem;
375 overflow-x: auto;
376 border: 1px solid var(--g1t-line);
377 border-radius: 0.75rem;
378 padding: 0.7rem 0.9rem;
379 background: var(--g1t-surface);
380}
381.sl-markdown-content .g1t-endpoint code {
382 padding: 0;
383 background: transparent;
384 font-size: 0.875rem;
385 white-space: nowrap;
386 color: var(--g1t-fg);
387}
388/* Methods: the same small mono tag in the sidebar and on the page. */
389.g1t-method {
390 --method: var(--g1t-muted);
391 flex-shrink: 0;
392 border: 0 !important;
393 border-radius: 0.3rem;
394 padding: 0.05rem 0.4rem;
395 background: color-mix(in srgb, var(--method) 14%, transparent) !important;
396 color: var(--method) !important;
397 font-family: var(--g1t-font-mono);
398 font-size: 0.7rem;
399 font-weight: 600;
400 letter-spacing: 0.02em;
401}
402.g1t-method-get,
403.g1t-method[data-method='get'] {
404 --method: var(--g1t-accent);
405}
406.g1t-method-post,
407.g1t-method[data-method='post'] {
408 --method: var(--g1t-info);
409}
410.g1t-method-put,
411.g1t-method-patch,
412.g1t-method[data-method='put'],
413.g1t-method[data-method='patch'] {
414 --method: var(--g1t-warn);
415}
416.g1t-method-delete,
417.g1t-method[data-method='delete'] {
418 --method: var(--g1t-danger);
419}
420/* In the sidebar the method sits at the end of the row, in a fixed column. */
421.sidebar-content a:has(.g1t-method) {
422 display: flex;
423 justify-content: space-between;
424 align-items: center;
425 gap: 0.5rem;
426}
427.sidebar-content .g1t-method {
428 min-width: 3.1rem;
429 text-align: center;
430 font-size: 0.625rem;
431 line-height: 1.6;
432}