flagon-io/g1t

// @ts-check
import starlight from '@astrojs/starlight';
import { defineConfig } from 'astro/config';

import { generateApiReference } from './scripts/api-reference.mjs';

// A page per REST operation, written from the OpenAPI document.
const apiGroups = generateApiReference();

export default defineConfig({
	site: 'https://docs.g1t.sh',
	integrations: [
		starlight({
			title: 'g1t docs',
			description: 'Guides and reference for g1t, where people and agents ship software together.',
			components: {
				Footer: './src/components/Footer.astro',
				Head: './src/components/Head.astro',
				Header: './src/components/Header.astro',
				PageTitle: './src/components/PageTitle.astro',
				SiteTitle: './src/components/SiteTitle.astro',
				SocialIcons: './src/components/SocialIcons.astro',
			},
			// Each tab under the header shows its own part of the sidebar.
			routeMiddleware: './src/route-data.ts',
			expressiveCode: {
				themes: ['github-dark-default'],
				// Plain panels with a copy button, without window chrome.
				defaultProps: { frame: 'none' },
				styleOverrides: {
					borderRadius: '0.75rem',
					borderColor: 'var(--g1t-line)',
					codeBackground: 'var(--g1t-surface)',
					codeFontSize: '0.8125rem',
					frames: {
						editorBackground: 'var(--g1t-surface)',
						terminalBackground: 'var(--g1t-surface)',
						terminalTitlebarBackground: 'var(--g1t-raised)',
						terminalTitlebarBorderBottomColor: 'var(--g1t-line)',
						editorTabBarBackground: 'var(--g1t-raised)',
						shadowColor: 'transparent',
					},
				},
			},
			logo: { src: '@g1t/theme/mark.svg', alt: '' },
			favicon: '/favicon.svg',
			customCss: ['@g1t/theme/fonts.css', '@g1t/theme/tokens.css', './src/styles/g1t.css'],
			editLink: {
				baseUrl: 'https://g1t.sh/flagon-io/g1t/blob/main/apps/docs/',
			},
			lastUpdated: true,
			head: [
				{ tag: 'link', attrs: { rel: 'icon', href: '/favicon.ico', sizes: '32x32' } },
				{ tag: 'link', attrs: { rel: 'icon', type: 'image/png', sizes: '192x192', href: '/icon-192.png' } },
				{ tag: 'link', attrs: { rel: 'apple-touch-icon', href: '/apple-touch-icon.png' } },
			],
			sidebar: [
				{
					label: 'Get started',
					items: [
						{ label: 'Quickstart', slug: 'quickstart' },
						{ label: 'How g1t works', slug: 'concepts/overview' },
						{ label: 'Search and Explore', slug: 'guides/search' },
						{ label: 'Status and incidents', slug: 'guides/status' },
					],
				},
				{
					label: 'Projects',
					items: [
						{ label: 'Projects', slug: 'guides/projects' },
						{ label: 'Deployments', slug: 'guides/deployments' },
						{ label: 'Secrets and variables', slug: 'guides/secrets-and-variables' },
						{ label: 'Security', slug: 'guides/security' },
					],
				},
				{
					label: 'Agents',
					items: [
						{ label: 'g1t agents', slug: 'guides/g1t-agents' },
						{ label: 'Guardrails', slug: 'guides/guardrails' },
						{ label: 'Outcomes and plans', slug: 'guides/outcomes' },
						{ label: 'Talking to agents', slug: 'guides/talking-to-agents' },
						{ label: 'Agents, sessions and memory', slug: 'guides/agents-and-memory' },
						{ label: 'Context hub', slug: 'guides/context-hub' },
						{ label: 'Bring your own agent', slug: 'guides/bring-your-own-agent' },
					],
				},
				{
					label: 'Connect your tools',
					items: [
						{ label: 'Integrations', slug: 'guides/integrations' },
						{ label: 'Model providers', slug: 'guides/models' },
						{ label: 'Webhooks', slug: 'guides/webhooks' },
						{ label: 'GitHub Actions', slug: 'guides/actions' },
					],
				},
				{
					label: 'Landing changes',
					items: [
						{ label: 'Pull requests and checks', slug: 'guides/pull-requests' },
						{ label: 'The merge queue', slug: 'guides/merge-queue' },
						{ label: 'Sessions and why-blame', slug: 'guides/why-blame' },
						{ label: 'Forks and branches', slug: 'concepts/forks' },
					],
				},
				{
					label: 'Workspaces',
					items: [
						{ label: 'Accounts and sign-in', slug: 'guides/authentication' },
						{ label: 'GitHub', slug: 'guides/github' },
						{ label: 'Workspaces and tokens', slug: 'guides/workspaces' },
						{ label: 'Access and roles', slug: 'guides/access-and-roles' },
						{ label: 'Managing a repository', slug: 'guides/managing-repositories' },
						{ label: 'Transferring a repository', slug: 'guides/transferring-repositories' },
						{ label: 'Audit log', slug: 'guides/audit-log' },
						{ label: 'Usage and billing', slug: 'guides/usage-and-billing' },
						{ label: 'Git', slug: 'guides/git' },
						{ label: 'Run g1t yourself', slug: 'guides/self-hosting' },
					],
				},
				{
					label: 'Reference',
					items: [
						{ label: 'API overview', slug: 'reference/api' },
						{ label: 'MCP tools', slug: 'reference/mcp' },
						{ label: 'Try it in the explorer', link: '/api/reference/', attrs: { target: '_self' } },
						{ label: 'OpenAPI document', link: 'https://api.g1t.sh/openapi.json' },
						{ label: 'llms.txt', link: 'https://g1t.sh/llms.txt' },
					],
				},
				...apiGroups,
			],
		}),
	],
});