', '');
+ const slug = outputSlug(relativeFile);
+ const outPath = path.join(outputDir, `${slug}.md`);
+ await fs.mkdir(path.dirname(outPath), { recursive: true });
+ const title = data.title || titleFromSlug(slug);
+ const hasOwnHeading = /]/.test(rendered);
+ const heading = hasOwnHeading ? '' : `# ${title}`;
+ const description = !hasOwnHeading && data.description ? `\n\n${escapeHtml(data.description)}
` : '';
+ await fs.writeFile(outPath, `${heading}${description}\n\n${rendered.trim()}\n\n\n\n`);
+ }
+
+ for (const type of ['success', 'error', 'info', 'warning']) {
+ const source = await fs.readFile(path.join(sourceDir, 'fragments/toast', `${type}.njk`), 'utf8');
+ const rendered = await renderTemplate(env, source, context);
+ const outPath = path.join(fragmentsDir, 'toast', `${type}.html`);
+ await fs.mkdir(path.dirname(outPath), { recursive: true });
+ await fs.writeFile(outPath, rendered.trim());
+ }
+}
+
+
+function titleFromSlug(slug) {
+ const last = slug.split('/').at(-1) || slug;
+ return last.replaceAll('-', ' ').replace(/\b\w/g, (letter) => letter.toUpperCase());
+}
+
+function escapeHtml(value) {
+ return String(value || '').replaceAll('&', '&').replaceAll('<', '<').replaceAll('>', '>').replaceAll('"', '"');
+}
+
+await main();
diff --git a/scripts/prepare-rsd-assets.js b/scripts/prepare-rsd-assets.js
new file mode 100644
index 0000000..1d679fc
--- /dev/null
+++ b/scripts/prepare-rsd-assets.js
@@ -0,0 +1,28 @@
+import { cp, mkdir, rm } from 'node:fs/promises';
+
+const fontFiles = [
+ 'geist-sans-latin-400-normal.woff2',
+ 'geist-sans-latin-500-normal.woff2',
+ 'geist-sans-latin-600-normal.woff2',
+ 'geist-sans-latin-700-normal.woff2',
+ 'geist-mono-latin-400-normal.woff2',
+ 'geist-mono-latin-500-normal.woff2',
+ 'geist-mono-latin-600-normal.woff2',
+ 'geist-mono-latin-700-normal.woff2',
+];
+
+await rm('./public/assets', { recursive: true, force: true });
+await mkdir('./public/assets', { recursive: true });
+await cp('./docs/src/assets', './public/assets', {
+ recursive: true,
+ filter: (source) => !source.endsWith('.DS_Store') && !/styles(?:-[a-z]+)?\.css$/.test(source),
+});
+
+await mkdir('./public/assets/js', { recursive: true });
+await cp('./node_modules/htmx.org/dist/htmx.min.js', './public/assets/js/htmx.min.js');
+
+await mkdir('./public/assets/fonts/geist', { recursive: true });
+for (const file of fontFiles) {
+ const packageName = file.startsWith('geist-sans') ? 'geist-sans' : 'geist-mono';
+ await cp(`./node_modules/@fontsource/${packageName}/files/${file}`, `./public/assets/fonts/geist/${file}`);
+}
diff --git a/src/components/SidebarHeader.astro b/src/components/SidebarHeader.astro
new file mode 100644
index 0000000..b5a7fc6
--- /dev/null
+++ b/src/components/SidebarHeader.astro
@@ -0,0 +1,14 @@
+---
+const { site } = Astro.props;
+const logo = site.logo?.svg || '';
+---
+
+
+
+
+ {site.title}
+ {site.subtitle && {site.subtitle}}
+
+
diff --git a/src/docs.css b/src/docs.css
new file mode 100644
index 0000000..71cdadb
--- /dev/null
+++ b/src/docs.css
@@ -0,0 +1,39 @@
+@import "../docs/css/fonts.css";
+@import "../docs/css/themes/claude.css";
+@import "../docs/css/themes/doom-64.css";
+@import "../docs/css/themes/supabase.css";
+
+:root {
+ --font-sans: "Geist Sans", ui-sans-serif, system-ui, sans-serif;
+ --font-heading: "Geist Sans", ui-sans-serif, system-ui, sans-serif;
+ --font-mono: "Geist Mono", ui-monospace, SFMono-Regular, Menlo, Monaco, Consolas, monospace;
+}
+
+.preview {
+ @apply flex min-h-[350px] w-full items-center justify-center p-10;
+}
+
+.prose {
+ > .relative.my-6 {
+ @apply my-6;
+ }
+
+ pre.scrollbar {
+ @apply grid max-h-[650px] overflow-y-auto rounded-lg bg-muted/40 text-sm;
+ }
+
+ pre.scrollbar > code {
+ @apply block rounded-[inherit] bg-transparent p-3.5 font-mono;
+ }
+}
+
+.htmx-indicator {
+ @apply invisible opacity-0 transition-discrete transition-all;
+}
+.htmx-indicator:not(.htmx-request) {
+ @apply hidden;
+}
+.htmx-request,
+.htmx-request.htmx-indicator {
+ @apply visible opacity-100;
+}
diff --git a/src/eleventy/llm-exports.js b/src/eleventy/llm-exports.js
deleted file mode 100644
index 1b79ca0..0000000
--- a/src/eleventy/llm-exports.js
+++ /dev/null
@@ -1,129 +0,0 @@
-import fs from 'node:fs/promises';
-import path from 'node:path';
-
-import { collectMenuSlugs, docUrl, fallbackLabelFromSlug } from './menu.js';
-
-export const registerLlmExports = (eleventyConfig, options) => {
- const collectFiles = async (dir, predicate) => {
- const entries = await fs.readdir(dir, { withFileTypes: true });
- const out = [];
-
- for (const entry of entries) {
- const fullPath = path.join(dir, entry.name);
- if (entry.isDirectory()) out.push(...(await collectFiles(fullPath, predicate)));
- else if (entry.isFile() && predicate(fullPath)) out.push(fullPath);
- }
-
- return out;
- };
-
- const writeTextFile = async (outputDir, relativePath, content) => {
- const outPath = path.join(outputDir, relativePath);
- await fs.mkdir(path.dirname(outPath), { recursive: true });
- await fs.writeFile(outPath, content, 'utf8');
- };
-
- const stripFrontMatter = (source) => {
- if (!source.startsWith('---')) return source;
- const match = source.match(/^---\s*\n[\s\S]*?\n---\s*\n?/);
- return match ? source.slice(match[0].length) : source;
- };
-
- const readFrontMatterField = (source, key) => {
- if (!source.startsWith('---')) return null;
- const match = source.match(/^---\s*\n([\s\S]*?)\n---\s*\n?/);
- if (!match) return null;
- const line = match[1]
- .split('\n')
- .map((l) => l.trim())
- .find((l) => l.startsWith(`${key}:`));
- if (!line) return null;
- let value = line.slice(`${key}:`.length).trim();
- if ((value.startsWith('"') && value.endsWith('"')) || (value.startsWith("'") && value.endsWith("'"))) {
- value = value.slice(1, -1);
- }
- return value || null;
- };
-
- eleventyConfig.on('afterBuild', async (eventsArg) => {
- const outputDir = eventsArg?.directories?.output || eventsArg?.dir?.output;
- const inputDir = eventsArg?.directories?.input || eventsArg?.dir?.input;
- if (!outputDir || !inputDir) return;
-
- const docsRoot = path.resolve(inputDir);
- const siteUrl = options.getSiteUrl();
- const siteTitle = options.getSiteTitle();
-
- let docsConfig = null;
- for (const docsConfigPath of [path.join(docsRoot, '_data', 'docs.json'), path.join(docsRoot, 'docs.json')]) {
- try {
- docsConfig = JSON.parse(await fs.readFile(docsConfigPath, 'utf8'));
- break;
- } catch (_) {}
- }
- const menu = docsConfig?.menu || [];
- const menuSlugs = collectMenuSlugs(menu);
-
- const sourceFiles = await collectFiles(docsRoot, (filePath) => filePath.endsWith('.md'));
- const docs = (
- await Promise.all(
- sourceFiles.map(async (filePath) => {
- const source = await fs.readFile(filePath, 'utf8');
- const relative = path.relative(docsRoot, filePath).replaceAll(path.sep, '/');
- const slug = relative.replace(/\.md$/, '') === 'index' ? 'index' : relative.replace(/\.md$/, '');
- const url = docUrl(slug);
- const title = readFrontMatterField(source, 'title') || fallbackLabelFromSlug(slug);
- const description = (readFrontMatterField(source, 'description') || '').trim();
- const content = stripFrontMatter(source).trim();
- return { slug, url, title: title.trim(), description, content };
- }),
- )
- ).sort((a, b) => a.url.localeCompare(b.url));
-
- const docsBySlug = new Map(docs.map((d) => [d.slug, d]));
- const docsInMenu = menuSlugs.map((slug) => docsBySlug.get(slug)).filter(Boolean);
- const docsNotInMenu = docs.filter((doc) => !docsInMenu.includes(doc));
- const orderedDocs = [...docsInMenu, ...docsNotInMenu];
-
- const markdownExportPathFromSlug = (slug) => {
- if (slug === 'index') return 'index.md';
- if (slug.endsWith('/index')) return `${slug.slice(0, -'/index'.length)}.md`;
- return `${slug}.md`;
- };
-
- await Promise.all(
- docs.map(async (doc) => {
- const parts = [`# ${doc.title}`];
- if (doc.description) parts.push(doc.description);
- if (doc.content) parts.push(doc.content);
- await writeTextFile(outputDir, markdownExportPathFromSlug(doc.slug), parts.join('\n\n') + '\n');
- }),
- );
-
- const llmsLines = [`# ${siteTitle}`, '', '## Docs', ''];
- menu.forEach((group) => {
- if (group?.type !== 'group') return;
- llmsLines.push(`### ${group.label || 'Docs'}`, '');
- const addSlug = (slug) => {
- const doc = docsBySlug.get(slug);
- if (!doc) return;
- const fullUrl = `${siteUrl}${doc.url}`;
- llmsLines.push(doc.description ? `- [${doc.title}](${fullUrl}): ${doc.description}` : `- [${doc.title}](${fullUrl})`);
- };
- (group.items || []).forEach((item) => {
- if (typeof item === 'string') addSlug(item);
- else if (item?.type === 'submenu' && Array.isArray(item.items)) item.items.forEach(addSlug);
- });
- llmsLines.push('');
- });
- await writeTextFile(outputDir, 'llms.txt', llmsLines.join('\n'));
-
- const fullLines = [];
- orderedDocs.forEach((doc) => {
- fullLines.push(`# ${doc.title}`, `Source: ${siteUrl}${doc.url}`, '');
- if (doc.description) fullLines.push(doc.description, '');
- fullLines.push(doc.content, '', '---', '');
- });
- await writeTextFile(outputDir, 'llms-full.txt', fullLines.join('\n'));
- });
-};
diff --git a/src/eleventy/menu.js b/src/eleventy/menu.js
deleted file mode 100644
index 3d4fc3d..0000000
--- a/src/eleventy/menu.js
+++ /dev/null
@@ -1,41 +0,0 @@
-export const docUrl = (slug) => {
- if (slug === 'index') return '/';
- if (slug.endsWith('/index')) return '/' + slug.replace(/\/index$/, '/');
- return '/' + slug + '/';
-};
-
-export const flattenMenuSlugs = (menu) => {
- const out = [];
-
- const walk = (items) => {
- (items || []).forEach((item) => {
- if (typeof item === 'string') {
- out.push(item);
- return;
- }
-
- if (item?.type === 'submenu' && Array.isArray(item.items)) {
- walk(item.items);
- }
- });
- };
-
- (menu || []).forEach((group) => {
- if (group?.type !== 'group') return;
- walk(group.items);
- });
-
- return out;
-};
-
-export const collectMenuSlugs = (menu) => {
- return [...new Set(flattenMenuSlugs(menu))];
-};
-
-export const fallbackLabelFromSlug = (slug) => {
- if (slug === 'index') return 'Introduction';
- const parts = String(slug).split('/');
- const last = parts[parts.length - 1];
- const base = last === 'index' && parts.length > 1 ? parts[parts.length - 2] : last;
- return base.replace(/-/g, ' ').replace(/\b\w/g, (l) => l.toUpperCase());
-};
diff --git a/src/eleventy/navigation.js b/src/eleventy/navigation.js
deleted file mode 100644
index 8eb11b1..0000000
--- a/src/eleventy/navigation.js
+++ /dev/null
@@ -1,152 +0,0 @@
-import { docUrl, fallbackLabelFromSlug, flattenMenuSlugs } from './menu.js';
-
-export const registerNavigationFilters = (eleventyConfig, lucideIcons) => {
- const brandIcons = {
- github:
- '',
- discord:
- '',
- };
-
- const lucideSvg = (iconName) => {
- if (!iconName) return null;
- const pascalName = iconName
- .split('-')
- .map((part) => part.charAt(0).toUpperCase() + part.slice(1))
- .join('');
- const iconComponent = lucideIcons?.[pascalName];
- if (!iconComponent) return null;
- return iconComponent;
- };
-
- const resolveIcon = (icon) => {
- if (!icon) return null;
- if (typeof icon !== 'string') return icon;
- const trimmed = icon.trim();
- if (!trimmed) return null;
- if (trimmed.startsWith(' collections?.all || collections?.docs || [];
-
- const buildMenus = (menu, collections, currentUrl = '') => {
- const docs = docsForCollections(collections);
- const docsByUrl = new Map(docs.map((doc) => [doc.url, doc]));
-
- const processSlug = (slug) => {
- const url = docUrl(slug);
- const doc = docsByUrl.get(url);
- const title = doc?.data?.title ? String(doc.data.title) : fallbackLabelFromSlug(slug);
- const description = doc?.data?.description ? String(doc.data.description) : '';
- const iconSvg = resolveIcon(doc?.data?.icon) || null;
-
- const sidebarItem = {
- icon: iconSvg,
- url,
- label: title,
- description,
- current: url.replace(/\/$/, '') === String(currentUrl).replace(/\/$/, ''),
- };
-
- const keywords = [title, description].filter(Boolean).join(' ');
- const iconHtml = iconSvg || '';
- const commandItem = {
- type: 'item',
- label: `${iconHtml}${title}`,
- keywords,
- attrs: {
- onclick: `window.location.href='${url}'; this.closest('dialog')?.close();`,
- },
- };
-
- return { sidebar: sidebarItem, command: commandItem };
- };
-
- const processItem = (item) => {
- if (typeof item === 'string') return processSlug(item);
-
- if (item?.type === 'submenu') {
- const submenuIcon = resolveIcon(item.icon) || null;
- const processed = (item.items || []).map((sub) => processItem(sub));
- const commandItems = processed.map((entry) => entry.command).filter(Boolean);
- return {
- sidebar: {
- ...item,
- icon: submenuIcon,
- open: item.open ?? processed.some((entry) => entry.sidebar?.current),
- items: processed.map((entry) => entry.sidebar).filter(Boolean),
- },
- command: commandItems.length ? {
- type: 'group',
- label: item.label,
- items: commandItems,
- } : null,
- };
- }
-
- if (item?.url) {
- const iconSvg = resolveIcon(item.icon) || null;
- return {
- sidebar: { ...item, icon: iconSvg, current: item.url === currentUrl },
- command: item.external
- ? null
- : {
- type: 'item',
- label: `${iconSvg || ''}${item.label}`,
- attrs: { onclick: `window.location.href='${item.url}'; this.closest('dialog')?.close();` },
- },
- };
- }
-
- return { sidebar: null, command: null };
- };
-
- const processedGroups = (menu || []).map((group) => {
- if (group?.type !== 'group') return { sidebar: group, command: group };
-
- const processed = (group.items || []).map((item) => processItem(item));
- return {
- sidebar: { ...group, items: processed.map((entry) => entry.sidebar).filter(Boolean) },
- command: { type: 'group', label: group.label, items: processed.map((entry) => entry.command).filter(Boolean) },
- };
- });
-
- return {
- sidebar: processedGroups.map((p) => p.sidebar),
- command: processedGroups.map((p) => p.command),
- };
- };
-
- eleventyConfig.addFilter('getNavigation', function getNavigation(menu, collections) {
- const flattened = flattenMenuSlugs(menu);
- const currentUrl = this.page.url;
- const index = flattened.findIndex((slug) => docUrl(slug) === currentUrl);
- if (index === -1) return { prev: null, next: null };
-
- const docs = docsForCollections(collections);
- const labelFor = (slug) => {
- const url = docUrl(slug);
- const doc = docs.find((d) => d.url === url);
- if (doc?.data?.title) return String(doc.data.title);
- return fallbackLabelFromSlug(slug);
- };
-
- return {
- prev: index > 0 ? { url: docUrl(flattened[index - 1]), label: labelFor(flattened[index - 1]) } : null,
- next:
- index < flattened.length - 1
- ? { url: docUrl(flattened[index + 1]), label: labelFor(flattened[index + 1]) }
- : null,
- };
- });
-
- eleventyConfig.addFilter('sidebarMenu', function sidebarMenu(menu, collections) {
- return buildMenus(menu, collections, this.page.url).sidebar;
- });
-
- eleventyConfig.addFilter('commandMenu', function commandMenu(menu, collections) {
- return buildMenus(menu, collections, this.page.url).command;
- });
-};
diff --git a/src/pages/fragments/toast/[type].ts b/src/pages/fragments/toast/[type].ts
new file mode 100644
index 0000000..f68f30c
--- /dev/null
+++ b/src/pages/fragments/toast/[type].ts
@@ -0,0 +1,15 @@
+import fs from 'node:fs';
+import path from 'node:path';
+
+const types = ['success', 'error', 'info', 'warning'];
+
+export function getStaticPaths() {
+ return types.map((type) => ({ params: { type } }));
+}
+
+export function GET({ params }) {
+ const type = String(params.type || '');
+ if (!types.includes(type)) return new Response('Not found', { status: 404 });
+ const html = fs.readFileSync(path.resolve('docs/generated/fragments/toast', `${type}.html`), 'utf8');
+ return new Response(html, { headers: { 'content-type': 'text/html; charset=utf-8' } });
+}
diff --git a/src/pages/robots.txt.ts b/src/pages/robots.txt.ts
new file mode 100644
index 0000000..7d23bcf
--- /dev/null
+++ b/src/pages/robots.txt.ts
@@ -0,0 +1,6 @@
+export function GET({ site }) {
+ const origin = site?.toString().replace(/\/$/, '') || 'https://basecoatui.com';
+ return new Response(`User-agent: *\nAllow: /\n\nSitemap: ${origin}/sitemap.xml\n`, {
+ headers: { 'content-type': 'text/plain; charset=utf-8' },
+ });
+}
diff --git a/src/pages/sitemap.xml.ts b/src/pages/sitemap.xml.ts
new file mode 100644
index 0000000..478284b
--- /dev/null
+++ b/src/pages/sitemap.xml.ts
@@ -0,0 +1,26 @@
+import fs from 'node:fs';
+import path from 'node:path';
+
+const routePath = (slug) => slug === 'index' ? '/' : `/${slug.replace(/^\/+|\/+$/g, '')}/`;
+
+function flatten(menu) {
+ const out = [];
+ const walk = (items = []) => {
+ for (const item of items) {
+ if (typeof item === 'string') out.push(item);
+ else if (item?.slug) out.push(item.slug);
+ else if (item?.type === 'submenu') walk(item.items || []);
+ }
+ };
+ for (const group of menu || []) if (group?.type === 'group') walk(group.items || []);
+ return out;
+}
+
+export function GET({ site }) {
+ const origin = site?.toString().replace(/\/$/, '') || 'https://basecoatui.com';
+ const manifest = JSON.parse(fs.readFileSync(path.resolve('docs/generated/docs.json'), 'utf8'));
+ const urls = flatten(manifest.menu).map((slug) => ` ${origin}${routePath(slug)} \n${urls}\n \n`, {
+ headers: { 'content-type': 'application/xml; charset=utf-8' },
+ });
+}
diff --git a/wrangler.jsonc b/wrangler.jsonc
index c29b7d0..f3b120b 100644
--- a/wrangler.jsonc
+++ b/wrangler.jsonc
@@ -3,7 +3,7 @@
"name": "basecoat",
"compatibility_date": "2026-06-02",
"assets": {
- "directory": "./_site",
+ "directory": "./dist",
"not_found_handling": "404-page"
}
}