Skip to content

Commit 0ebde88

Browse files
committed
fix(site): give the Config Builder the sidebar back
It used `template: splash`, which is Starlight's no-sidebar layout — so the one page a first-timer is sent to from Start Here was also the only page in the site with no way to navigate onward. Dropping splash needs two things with it. Starlight's default content column is 45rem, sized for prose, which would have collapsed the wizard's form and YAML preview into a single column on every screen; ConfigWizard.astro widens it to 82rem. And the page has no headings, so the table of contents would have rendered empty — disabled in frontmatter. The width override is a `:root` rule inside the component's style block. Astro leaves `:root` unscoped, and code-splits the CSS per page, so it lands only on the one page that renders the component — verified: the rule ships in config-builder.*.css and no other page loads that file. Verified in the built site: sidebar renders with Config Builder active, and the wizard keeps its two 588px columns. Claude-Session: https://claude.ai/code/session_01RgSnMCa3JQigphGnPbazdw
1 parent 7c4f685 commit 0ebde88

7 files changed

Lines changed: 15 additions & 1 deletion

File tree

docs/images/Dashboard.png

-5 Bytes
Loading

docs/images/Diagnostics.png

565 Bytes
Loading

docs/images/History.png

439 Bytes
Loading

docs/images/Tools.png

219 Bytes
Loading

docs/images/Topology.png

313 Bytes
Loading

site/src/components/ConfigWizard.astro

Lines changed: 11 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -99,6 +99,17 @@
9999
</script>
100100

101101
<style>
102+
/* This component renders on exactly one page, so a global rule here is
103+
page-scoped in practice. Starlight's 45rem default is sized for prose and
104+
would force the form and its YAML preview into a single column on every
105+
screen; the wizard is a two-pane tool, not an article. */
106+
:root {
107+
--sl-content-width: 82rem;
108+
}
109+
/* Starlight caps the prose column; the wizard needs the full width it was
110+
just given, and its own max-width still governs the upper bound. */
111+
.sl-markdown-content .tigo-wizard { max-width: none; }
112+
102113
.tigo-wizard {
103114
display: grid;
104115
grid-template-columns: minmax(0, 1fr) minmax(0, 1fr);

site/src/content/docs/config-builder.mdx

Lines changed: 4 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,7 +1,10 @@
11
---
22
title: Config Builder
33
description: Generate a ready-to-flash ESPHome YAML for your Tigo Monitor board, right in the browser.
4-
template: splash
4+
# Not `template: splash` — splash is the no-sidebar layout, which left this page
5+
# as the only one in the site with no way to navigate back out. The wizard needs
6+
# a wider content column than the 45rem default; ConfigWizard.astro widens it.
7+
tableOfContents: false
58
---
69

710
import ConfigWizard from '../../components/ConfigWizard.astro';

0 commit comments

Comments
 (0)