126 lines
3.3 KiB
JavaScript
126 lines
3.3 KiB
JavaScript
// @ts-check
|
|
import { defineConfig } from 'astro/config';
|
|
import starlight from '@astrojs/starlight';
|
|
import sitemap from '@astrojs/sitemap';
|
|
import rehypeMarkdownLinks from './src/rehype-markdown-links.js';
|
|
import { getSiteUrl } from './src/lib/site-url.js';
|
|
|
|
const siteUrl = getSiteUrl();
|
|
const urlParts = new URL(siteUrl);
|
|
// Normalize basePath: ensure trailing slash so links can use `${BASE_URL}path`
|
|
const basePath = urlParts.pathname === '/' ? '/' : urlParts.pathname.endsWith('/') ? urlParts.pathname : urlParts.pathname + '/';
|
|
|
|
export default defineConfig({
|
|
site: `${urlParts.origin}${basePath}`,
|
|
base: basePath,
|
|
outDir: '../build/site',
|
|
|
|
// Disable aggressive caching in dev mode
|
|
vite: {
|
|
optimizeDeps: {
|
|
force: true, // Always re-bundle dependencies
|
|
},
|
|
server: {
|
|
watch: {
|
|
usePolling: false, // Set to true if file changes aren't detected
|
|
},
|
|
},
|
|
},
|
|
|
|
markdown: {
|
|
rehypePlugins: [rehypeMarkdownLinks],
|
|
},
|
|
|
|
integrations: [
|
|
sitemap(),
|
|
starlight({
|
|
title: 'BMAD Method',
|
|
tagline: 'AI-driven agile development with specialized agents and workflows that scale from bug fixes to enterprise platforms.',
|
|
|
|
logo: {
|
|
src: './public/img/logo.svg',
|
|
alt: 'BMAD Logo',
|
|
},
|
|
favicon: '/favicon.ico',
|
|
|
|
// Social links
|
|
social: [
|
|
{ icon: 'discord', label: 'Discord', href: 'https://discord.gg/gk8jAdXWmj' },
|
|
{ icon: 'github', label: 'GitHub', href: 'https://github.com/bmad-code-org/BMAD-METHOD' },
|
|
{ icon: 'youtube', label: 'YouTube', href: 'https://www.youtube.com/@BMadCode' },
|
|
],
|
|
|
|
// Show last updated timestamps
|
|
lastUpdated: true,
|
|
|
|
// Custom head tags for LLM discovery
|
|
head: [
|
|
{
|
|
tag: 'meta',
|
|
attrs: {
|
|
name: 'ai-terms',
|
|
content: `AI-optimized documentation: ${siteUrl}/llms-full.txt (plain text, ~100k tokens, complete BMAD reference). Index: ${siteUrl}/llms.txt`,
|
|
},
|
|
},
|
|
{
|
|
tag: 'meta',
|
|
attrs: {
|
|
name: 'llms-full',
|
|
content: `${siteUrl}/llms-full.txt`,
|
|
},
|
|
},
|
|
{
|
|
tag: 'meta',
|
|
attrs: {
|
|
name: 'llms',
|
|
content: `${siteUrl}/llms.txt`,
|
|
},
|
|
},
|
|
],
|
|
|
|
// Custom CSS
|
|
customCss: ['./src/styles/custom.css'],
|
|
|
|
// Sidebar configuration (Diataxis structure)
|
|
sidebar: [
|
|
{ label: 'Welcome', slug: 'index' },
|
|
{
|
|
label: 'Tutorials',
|
|
collapsed: false,
|
|
autogenerate: { directory: 'tutorials' },
|
|
},
|
|
{
|
|
label: 'How-To Guides',
|
|
collapsed: true,
|
|
autogenerate: { directory: 'how-to' },
|
|
},
|
|
{
|
|
label: 'Explanation',
|
|
collapsed: true,
|
|
autogenerate: { directory: 'explanation' },
|
|
},
|
|
{
|
|
label: 'Reference',
|
|
collapsed: true,
|
|
autogenerate: { directory: 'reference' },
|
|
},
|
|
],
|
|
|
|
// Credits in footer
|
|
credits: false,
|
|
|
|
// Pagination
|
|
pagination: true,
|
|
|
|
// Custom components
|
|
components: {
|
|
Header: './src/components/Header.astro',
|
|
MobileMenuFooter: './src/components/MobileMenuFooter.astro',
|
|
},
|
|
|
|
// Table of contents
|
|
tableOfContents: { minHeadingLevel: 2, maxHeadingLevel: 3 },
|
|
}),
|
|
],
|
|
});
|