veslx 0.1.23 → 0.1.24

package/index.html

@@ -9,14 +9,28 @@
     <script>
       (function() {
         var theme = localStorage.getItem('theme');
-        var isDark = theme === 'dark' || (!theme && window.matchMedia('(prefers-color-scheme: dark)').matches);
+        var prefersDark = window.matchMedia('(prefers-color-scheme: dark)').matches;
+        var isDark = theme === 'dark' || (theme !== 'light' && prefersDark);
         if (isDark) document.documentElement.classList.add('dark');
         document.documentElement.style.colorScheme = isDark ? 'dark' : 'light';
       })();
     </script>
     <style>
-      html { background: hsl(0 0% 100%); }
-      html.dark { background: hsl(0 0% 7%); }
+      /* Critical theme variables to prevent FOUC */
+      :root {
+        --background: 0 0% 100%;
+        --foreground: 240 10% 10%;
+      }
+      .dark {
+        --background: 0 0% 7%;
+        --foreground: 0 0% 93%;
+      }
+      html, body {
+        background-color: hsl(var(--background));
+        color: hsl(var(--foreground));
+        margin: 0;
+      }
+      body { visibility: hidden; }
     </style>
     <!-- Google Fonts: DM Sans + DM Mono -->
     <link rel="preconnect" href="https://fonts.googleapis.com">

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "veslx",
-  "version": "0.1.23",
+  "version": "0.1.24",
   "type": "module",
   "repository": {
     "type": "git",

package/plugin/src/plugin.ts

@@ -117,7 +117,67 @@ export default function contentPlugin(contentDir: string, config?: VeslxConfig,
 
   urlToDir.set('/raw', dir)
 
+  // Generate llms.txt content dynamically
+  function generateLlmsTxt(): string {
+    const frontmatters = extractFrontmatters(dir)
+    const entries: { path: string; title?: string; description?: string; date?: string; isSlides: boolean }[] = []
+
+    for (const [key, fm] of Object.entries(frontmatters)) {
+      const relativePath = key.replace('@content/', '')
+      const isSlides = relativePath.endsWith('SLIDES.mdx') || relativePath.endsWith('.slides.mdx')
+      entries.push({
+        path: relativePath,
+        title: fm.title,
+        description: fm.description,
+        date: fm.date,
+        isSlides,
+      })
+    }
+
+    entries.sort((a, b) => {
+      if (a.date && b.date) return b.date.localeCompare(a.date)
+      if (a.date) return -1
+      if (b.date) return 1
+      return a.path.localeCompare(b.path)
+    })
+
+    const lines: string[] = [`# ${siteConfig.name}`]
+    if (siteConfig.description) {
+      lines.push(siteConfig.description)
+    }
+    lines.push('')
+
+    // Links section
+    if (siteConfig.homepage) {
+      lines.push(`Homepage: ${siteConfig.homepage}`)
+    }
+    if (siteConfig.github) {
+      lines.push(`GitHub: https://github.com/${siteConfig.github}`)
+    }
+    lines.push('Install: bun install -g veslx')
+    lines.push('')
+
+    lines.push('Content is served as raw MDX files at /raw/{path}.')
+    lines.push('')
+
+    for (const entry of entries) {
+      const type = entry.isSlides ? '[slides]' : entry.date ? '[post]' : '[doc]'
+      const title = entry.title || entry.path.replace(/\.mdx?$/, '').split('/').pop()
+      const desc = entry.description ? ` - ${entry.description}` : ''
+      lines.push(`${type} ${title}: /raw/${entry.path}${desc}`)
+    }
+    lines.push('')
+    return lines.join('\n')
+  }
+
   const middleware: Connect.NextHandleFunction = (req: IncomingMessage, res: ServerResponse, next: Connect.NextFunction) => {
+    // Serve llms.txt dynamically
+    if (req.url === '/llms.txt') {
+      res.setHeader('Content-Type', 'text/plain')
+      res.end(generateLlmsTxt())
+      return
+    }
+
     // Check if URL matches any registered content directory
     for (const [urlBase, contentDir] of urlToDir.entries()) {
       if (req.url?.startsWith(urlBase + '/')) {
@@ -269,6 +329,11 @@ export const modules = import.meta.glob('@content/**/*.mdx');
       if (fs.existsSync(dir)) {
         copyDirSync(dir, destDir)
         console.log(`Content copied successfully`)
+
+        // Generate llms.txt for CLI tools and LLMs
+        const llmsTxtPath = path.join(outDir, 'llms.txt')
+        fs.writeFileSync(llmsTxtPath, generateLlmsTxt())
+        console.log(`Generated llms.txt`)
       } else {
         console.warn(`Content directory not found: ${dir}`)
       }

package/plugin/src/types.ts

@@ -4,6 +4,7 @@ export interface SiteConfig {
   name?: string;
   description?: string;
   github?: string;
+  homepage?: string;
   defaultView?: ContentView;
 }
 
@@ -16,6 +17,7 @@ export interface ResolvedSiteConfig {
   name: string;
   description: string;
   github: string;
+  homepage: string;
   defaultView: ContentView;
 }
 
@@ -23,5 +25,6 @@ export const DEFAULT_SITE_CONFIG: ResolvedSiteConfig = {
   name: 'veslx',
   description: '',
   github: '',
+  homepage: '',
   defaultView: 'all',
 };

package/src/index.css

@@ -435,3 +435,8 @@
     break-inside: avoid !important;
   }
 }
+
+/* FOUC prevention: CSS loaded, reveal content */
+body {
+  visibility: visible;
+}