From e3bf3d774acdfcfec2e92da56300fbfcde3991c4 Mon Sep 17 00:00:00 2001 From: Aleksandar Grbic Date: Fri, 11 Sep 2026 16:47:22 +0200 Subject: [PATCH] feat(docs): make warm paper the default light theme --- apps/docs/astro.config.mjs | 8 +- apps/docs/public/paper-grain.svg | 7 + apps/docs/src/components/ThemeProvider.astro | 35 +++-- apps/docs/src/styles/paper.css | 145 +++++++++++++++++++ apps/docs/src/styles/redesign.css | 3 +- apps/docs/src/styles/tailwind.css | 68 ++++----- output/playwright/landing-desktop.webp | Bin 799644 -> 70784 bytes output/playwright/landing-mobile.webp | Bin 335112 -> 23440 bytes 8 files changed, 208 insertions(+), 58 deletions(-) create mode 100644 apps/docs/public/paper-grain.svg create mode 100644 apps/docs/src/styles/paper.css diff --git a/apps/docs/astro.config.mjs b/apps/docs/astro.config.mjs index 4a2284b4..cf849989 100644 --- a/apps/docs/astro.config.mjs +++ b/apps/docs/astro.config.mjs @@ -235,16 +235,14 @@ export default defineConfig({ "The production-grade SaaS starter, built to be set up by an agent. Auth, billing, queues, email and observability already wired, with the architecture enforced by lint and CI. MIT, open source.", favicon: "/favicon.svg", /* - * Load order matters. redesign.css is the skin ported from tsforge and - * has to come last so it owns the final look; custom.css stays intact - * underneath for the accessible-table wrapper, the mermaid theme and - * the .bs-landing inline-code reset. Removing the last entry reverts - * the site to the previous green/rounded look. + * Shared tokens and accessible component styles load first. The base + * skin maps them to Starlight; paper.css supplies light-only art direction. */ customCss: [ "./src/styles/tailwind.css", "./src/styles/custom.css", "./src/styles/redesign.css", + "./src/styles/paper.css", ], plugins: [ /* diff --git a/apps/docs/public/paper-grain.svg b/apps/docs/public/paper-grain.svg new file mode 100644 index 00000000..8deef84c --- /dev/null +++ b/apps/docs/public/paper-grain.svg @@ -0,0 +1,7 @@ + + + + + + + diff --git a/apps/docs/src/components/ThemeProvider.astro b/apps/docs/src/components/ThemeProvider.astro index bed3f64a..fe6208cd 100644 --- a/apps/docs/src/components/ThemeProvider.astro +++ b/apps/docs/src/components/ThemeProvider.astro @@ -1,26 +1,31 @@ --- -/* - * Starlight ThemeProvider override. - * - * Default behaviour reads OS prefers-color-scheme and uses light for - * users whose OS is light. We force dark as the default for first-time - * visitors so the docs match the brand surface; the toggle still works - * and the user's pick persists in localStorage, so we only override the - * "no stored preference" branch. - */ +/* First visits start in light mode. Explicit light/dark and the stored + * empty-string Auto preference remain compatible with Starlight's picker. */ import { Icon } from "@astrojs/starlight/components"; --- {/* Inlined to avoid FOUC. */}