astro.config.mjs

// @ts-check
import { defineConfig } from 'astro/config';
import starlight from '@astrojs/starlight';
import mermaid from 'astro-mermaid';
// Generated by scripts/schema-to-markdown.py from public/schemas/*.x-group.
import schemaReference from './src/schema-sidebar.json' with { type: 'json' };

// https://astro.build/config
export default defineConfig({
	// Canonical origin, used for sitemap and absolute URLs. Must match the Pages custom domain.
	site: 'https://docs.encounter.plus',
	// Retired pages, plus the flat v4 paths that shipped app builds still open. Those arrive here
	// through the host-level help.encounter.plus/* → docs.encounter.plus/* redirect.
	redirects: {
		'/guides/web-client-faq': '/guides/remote-play/',
		'/remote-play': '/guides/remote-play/',
		'/special-thanks': '/about/special-thanks/',
		// Retired in the v5 guides restructure.
		'/guides/encounter-management': '/guides/encounters/',
		'/guides/battle-map': '/guides/battle-maps/',
		'/guides/special-thanks': '/about/special-thanks/',
		// Broadened from a video-only page.
		'/guides/battle-maps/video-assets': '/guides/battle-maps/assets/',
	},
	integrations: [
		// Renders ```mermaid code blocks client-side. Must come before starlight so it
		// sees the markdown before Starlight processes it.
		mermaid(
			{ 
				theme: 'forest',
				autoTheme: true, 
				enableLog: false ,
			}
		),
		starlight({
			title: 'Encounter+ Docs',
			logo: {
       	light: './src/assets/logo-light.webp',
    		dark: './src/assets/logo-dark.webp',
				replacesTitle: true,
      },
			// Cloudflare Web Analytics: cookieless, so no consent banner. The token is public.
			head: [
				{
					tag: 'script',
					attrs: {
						type: 'module',
						src: 'https://static.cloudflareinsights.com/beacon.min.js',
						'data-cf-beacon': '{"token": "f60deb58dd8d434885761cecf8123606"}',
					},
				},
			],
			social: [{ icon: 'github', label: 'GitHub', href: 'https://github.com/encounterplus/docs' }],
			// "Edit page" link under each page; Starlight appends the page's source path.
			editLink: {
				baseUrl: 'https://github.com/encounterplus/docs/edit/main/',
			},
			customCss: [
        // Relative path to your custom CSS file
        './src/styles/custom.css',
      ],
			sidebar: [
				{
          label: "About",
          items: [
            { label: "Introduction", link: "/about/intro" },
            { label: "Upgrading from v4", link: "/about/upgrading/" },
            { label: "Frequently Asked Questions", link: "/about/faq/" },
            { label: "Special Thanks", link: "/about/special-thanks/" },
          ],
        },
				{
          label: "Guides",
          items: [
            { label: "Quick Start", link: "/guides/quick-start/" },
            { label: "How it works", link: "/guides/how-it-works/" },
            { label: "The Library", link: "/guides/library/" },
            { label: "Campaigns & Modules", link: "/guides/campaigns-and-modules/" },
            { label: "Encounters & Combat", link: "/guides/encounters/" },
						{
              label: "Battle Maps",
              items: [
                { label: "Overview", link: "/guides/battle-maps/" },
                { label: "Tokens", link: "/guides/battle-maps/tokens/" },
                { label: "Line of Sight & Fog", link: "/guides/battle-maps/line-of-sight/" },
                { label: "Drawing, Markers & Effects", link: "/guides/battle-maps/drawing-and-effects/" },
                { label: "Assets", link: "/guides/battle-maps/assets/" },
              ],
            },
            { label: "The Player Screen", link: "/guides/player-screen/" },
            { label: "Remote Play", link: "/guides/remote-play/" },
            { label: "Writing Content", link: "/guides/writing-content/" },
            { label: "Dice & Roll Tables", link: "/guides/dice/" },
            { label: "Import and Export", link: "/guides/import-and-export/" },
            { label: "Game Systems", link: "/guides/game-systems/" },
            { label: "Tips & Tricks", link: "/guides/tips-and-tricks/" },
            { label: "Video Tutorials", link: "/guides/tutorials/" },
          ],
        },
				{
					label: 'Settings',
					items: [
						{ label: 'Overview', link: '/settings/overview/' },
						{ label: 'Content', link: '/settings/content/' },
						{ label: 'Combat', link: '/settings/combat/' },
						{ label: 'Dice Roller', link: '/settings/dice-roller/' },
						{ label: 'Battle Map', link: '/settings/battle-map/' },
						{ label: 'External Screen', link: '/settings/external-screen/' },
						{ label: 'Remote Play', link: '/settings/remote-play/' },
						{ label: 'Advanced', link: '/settings/advanced/' },
						{ label: 'Purchases', link: '/settings/purchases/' },
					],
				},
				{
					label: 'Reference',
					items: [
						{ label: 'Dice Expressions', link: '/reference/dice-expressions/' },
						{ label: 'File Types', link: '/reference/file-types/' },
						{ label: 'URL Scheme', link: '/reference/url-scheme/' },
						{ label: 'Server API', link: '/reference/server-api/' },
						{ label: 'Legacy XML', link: '/reference/legacy-xml/overview/' },
						...schemaReference,
					],
				},
				{
					label: 'Development',
					items: [
						{ label: 'Overview', link: '/development/' },
						{
							label: 'Custom System',
							collapsed: true,
							items: [
								{ label: 'Overview', link: '/system-development/' },
								{ label: 'System Structure', link: '/system-development/file-structure/' },
								{ label: 'Entity Definitions', link: '/system-development/entities/' },
								{ label: 'Types & Collections', link: '/system-development/types/' },
								{ label: 'Forms', link: '/system-development/forms/' },
								{ label: 'Views', link: '/system-development/views/' },
								{ label: 'Templates', link: '/system-development/templates/' },
								{ label: 'Themes', link: '/system-development/themes/' },
								{ label: 'Configuration & Filters', link: '/system-development/config/' },
								{ label: 'Migrations', link: '/system-development/migrations/' },
								{ label: 'Packaging', link: '/system-development/packaging/' },
							],
						},
					],
				},
			],
		}),
	],
});