Site: Astro Starlight, in the chant docs design

.github/workflows/hugo.yml → .github/workflows/pages.yml

@@ -1,8 +1,11 @@
-name: Deploy Hugo site to Pages
+name: Deploy site to Pages
 
+# A pull request runs the prose lint, the build and the room link check; a
+# push to main does the same and then deploys.
 on:
   push:
     branches: ["main"]
+  pull_request:
   workflow_dispatch:
 
 permissions:
@@ -11,48 +14,36 @@ permissions:
   id-token: write
 
 concurrency:
-  group: "pages"
-  cancel-in-progress: false
-
-defaults:
-  run:
-    shell: bash
+  group: ${{ github.event_name == 'pull_request' && format('pr-{0}', github.ref) || 'pages' }}
+  cancel-in-progress: ${{ github.event_name == 'pull_request' }}
 
 jobs:
   build:
     runs-on: ubuntu-latest
-    env:
-      HUGO_VERSION: 0.162.1
     steps:
-      - name: Install Hugo CLI
-        run: |
-          wget -O ${{ runner.temp }}/hugo.deb https://github.com/gohugoio/hugo/releases/download/v${HUGO_VERSION}/hugo_extended_${HUGO_VERSION}_linux-amd64.deb \
-          && sudo dpkg -i ${{ runner.temp }}/hugo.deb
       - name: Checkout
         uses: actions/checkout@v6
-        with:
-          fetch-depth: 0
       - uses: actions/setup-node@v4
         with:
-          node-version: '22'
+          node-version: '24'
           cache: npm
       - run: npm ci
       - name: Prose lint (sentences ruleset)
         run: npm run lint:prose
       - name: Setup Pages
-        id: pages
+        if: github.event_name != 'pull_request'
         uses: actions/configure-pages@v6
-      - name: Build with Hugo
-        env:
-          HUGO_CACHEDIR: ${{ runner.temp }}/hugo_cache
-          HUGO_ENVIRONMENT: production
-        run: hugo --gc --minify --baseURL "${{ steps.pages.outputs.base_url }}/"
+      # astro build, then scripts/check-rooms.mjs on the output
+      - name: Build
+        run: npm run build
       - name: Upload artifact
+        if: github.event_name != 'pull_request'
         uses: actions/upload-pages-artifact@v5
         with:
-          path: ./public
+          path: ./dist
 
   deploy:
+    if: github.event_name != 'pull_request'
     environment:
       name: github-pages
       url: ${{ steps.deployment.outputs.page_url }}

.gitignore

@@ -1,4 +1,3 @@
-public/
-resources/_gen/
-.hugo_build.lock
+dist/
+.astro/
 node_modules/

astro.config.mjs

@@ -0,0 +1,80 @@
+// @ts-check
+import { defineConfig } from 'astro/config';
+import starlight from '@astrojs/starlight';
+
+// intentius.io itself, at the root of the domain. The tool sites (terragucci,
+// choudoufu, chant, ...) are served beside it under their own paths from
+// their own repositories.
+export default defineConfig({
+	site: 'https://intentius.io',
+	integrations: [
+		starlight({
+			title: 'Intentius',
+			description: 'Intentius is an infrastructure consultancy. I build terragucci, choudoufu and chant, and help teams put them to work.',
+			// The pixel eye and the brain (scripts/brand/), Geist, and the palette
+			// as tokens for both themes.
+			customCss: ['./src/styles/intentius.css'],
+			// The site title and footer carry the logo, the header a Contact link,
+			// each page title its one-line description, and the theme starts dark.
+			components: {
+				PageTitle: './src/components/PageTitle.astro',
+				Footer: './src/components/Footer.astro',
+				SocialIcons: './src/components/SocialIcons.astro',
+				SiteTitle: './src/components/SiteTitle.astro',
+				ThemeProvider: './src/components/ThemeProvider.astro',
+				ThemeSelect: './src/components/ThemeSelect.astro',
+			},
+			// public/favicon.svg is the brain mark, drawn by scripts/brand/mark.py;
+			// the PNG is the fallback for browsers without SVG favicons.
+			favicon: '/favicon.svg',
+			social: [{ icon: 'github', label: 'GitHub', href: 'https://github.com/intentius' }],
+			head: [
+				{ tag: 'link', attrs: { rel: 'icon', href: '/favicon-48.png', sizes: '48x48', type: 'image/png' } },
+				{
+					tag: 'script',
+					content: `
+						!function(t,e){var o,n,p,r;e.__SV||(window.posthog=e,e._i=[],e.init=function(i,s,a){function g(t,e){var o=e.split(".");2==o.length&&(t=t[o[0]],e=o[1]),t[e]=function(){t.push([e].concat(Array.prototype.slice.call(arguments,0)))}}(p=t.createElement("script")).type="text/javascript",p.crossOrigin="anonymous",p.async=!0,p.src=s.api_host.replace(".i.posthog.com","-assets.i.posthog.com")+"/static/array.js",(r=t.getElementsByTagName("script")[0]).parentNode.insertBefore(p,r);var u=e;for(void 0!==a?u=e[a]=[]:a="posthog",u.people=u.people||[],Object.defineProperty(u,"toString",{configurable:!0,enumerable:!0,writable:!0,value:function(t){var e="posthog";return"posthog"!==a&&(e+="."+a),t||(e+=" (stub)"),e}}),Object.defineProperty(u.people,"toString",{configurable:!0,enumerable:!0,writable:!0,value:function(){return u.toString(1)+".people (stub)"}}),o="init capture register register_once register_for_session unregister unregister_for_session getFeatureFlag getFeatureFlagResult isFeatureEnabled reloadFeatureFlags updateEarlyAccessFeatureEnrollment getEarlyAccessFeatures on onFeatureFlags onSessionId getSurveys getActiveMatchingSurveys renderSurvey canRenderSurvey getNextSurveyStep identify setPersonProperties group resetGroups setPersonPropertiesForFlags resetPersonPropertiesForFlags setGroupPropertiesForFlags resetGroupPropertiesForFlags reset get_distinct_id getGroups get_session_id get_session_replay_url alias set_config startSessionRecording stopSessionRecording sessionRecordingStarted captureException loadToolbar get_property getSessionProperty createPersonProfile opt_in_capturing opt_out_capturing has_opted_in_capturing has_opted_out_capturing clear_opt_in_out_capturing debug".split(" "),n=0;n<o.length;n++)g(u,o[n]);e._i.push([i,s,a])},e.__SV=1)}(document,window.posthog||[]);
+						posthog.init('phc_mjyjBEHnta5mh6ZHhkY2kh83XBsqUfP7LVnB83mEEtwM', {
+							api_host: 'https://us.i.posthog.com',
+							defaults: '2026-05-30',
+						})
+					`,
+				},
+			],
+			// Every group starts collapsed; Starlight opens the one holding the
+			// current page. "Help me" lists the pages under /for/
+			// (src/pages/for/[id].astro) in the order of src/data/rooms.mjs;
+			// scripts/check-rooms.mjs fails the build when the two disagree, and it
+			// reads this list as plain text, so keep it literal.
+			sidebar: [
+				{
+					label: 'Help me',
+					collapsed: true,
+					items: [
+						{ label: 'Carve up a large estate', link: '/for/estate/' },
+						{ label: 'Move off another runner', link: '/for/moving/' },
+						{ label: 'Roll out terragucci', link: '/for/rollout/' },
+						{ label: 'Run agents on real infrastructure', link: '/for/agents/' },
+						{ label: 'Generate deploys and pipelines', link: '/for/releases/' },
+					],
+				},
+				'work',
+				{
+					label: 'Open source',
+					collapsed: true,
+					items: ['tools', 'terragucci', 'accessible-ops'],
+				},
+				{
+					label: 'Compare',
+					collapsed: true,
+					items: ['compare', 'compare/choudoufu-and-terraform-state', 'compare/chant-cdk-and-pulumi', 'compare/control-planes'],
+				},
+				{
+					label: 'About',
+					collapsed: true,
+					items: ['about', 'writing', 'contact'],
+				},
+			],
+		}),
+	],
+});