@litodocs/cli 1.0.0 → 1.2.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@litodocs/cli",
-  "version": "1.0.0",
+  "version": "1.2.0",
   "description": "Beautiful documentation sites from Markdown. Fast, simple, and open-source.",
   "type": "module",
   "bin": {

package/src/core/framework-runner.js

@@ -60,6 +60,18 @@ const DEFAULT_FRAMEWORK_CONFIGS = {
     // HMR trigger file that will be updated when content changes
     hmrTriggerFile: 'src/.lito-hmr-trigger.js',
   },
+  nuxt: {
+    name: 'nuxt',
+    commands: {
+      dev: ['nuxt', ['dev']],
+      build: ['nuxt', ['build']],
+    },
+    contentDir: 'content',
+    publicDir: 'public',
+    configFile: 'nuxt.config.ts',
+    layoutInjection: false,
+    useMDX: true,
+  },
 };
 
 /**
@@ -99,6 +111,11 @@ export async function detectFramework(projectDir) {
     return DEFAULT_FRAMEWORK_CONFIGS.astro;
   }
 
+  if (await pathExists(join(projectDir, 'nuxt.config.ts')) ||
+      await pathExists(join(projectDir, 'nuxt.config.js'))) {
+    return DEFAULT_FRAMEWORK_CONFIGS.nuxt;
+  }
+
   if (await pathExists(join(projectDir, 'next.config.js')) ||
       await pathExists(join(projectDir, 'next.config.mjs')) ||
       await pathExists(join(projectDir, 'next.config.ts'))) {
@@ -113,6 +130,7 @@ export async function detectFramework(projectDir) {
       const deps = { ...packageJson.dependencies, ...packageJson.devDependencies };
 
       if (deps['next']) return DEFAULT_FRAMEWORK_CONFIGS.next;
+      if (deps['nuxt']) return DEFAULT_FRAMEWORK_CONFIGS.nuxt;
       if (deps['astro']) return DEFAULT_FRAMEWORK_CONFIGS.astro;
       if (deps['vue'] && deps['vite']) return DEFAULT_FRAMEWORK_CONFIGS.vue;
       if (deps['react'] && deps['vite']) return DEFAULT_FRAMEWORK_CONFIGS.react;
@@ -162,6 +180,8 @@ export async function runFrameworkDev(projectDir, frameworkConfig, port = '4321'
     devArgs.push('--port', port);
   } else if (frameworkConfig.name === 'next') {
     devArgs.push('-p', port);
+  } else if (frameworkConfig.name === 'nuxt') {
+    devArgs.push('--port', port);
   } else {
     // Vite-based frameworks
     devArgs.push('--port', port);
@@ -189,6 +209,8 @@ export function getOutputDir(frameworkConfig) {
       return 'dist';
     case 'next':
       return '.next';
+    case 'nuxt':
+      return '.output/public';
     case 'react':
     case 'vue':
       return 'dist';
@@ -202,7 +224,7 @@ export function getOutputDir(frameworkConfig) {
  */
 export function needsSearchIndex(frameworkConfig) {
   // Only static-output frameworks need pagefind
-  return ['astro', 'react', 'vue'].includes(frameworkConfig.name);
+  return ['astro', 'react', 'vue', 'nuxt'].includes(frameworkConfig.name);
 }
 
 export { DEFAULT_FRAMEWORK_CONFIGS };

package/src/core/landing-sync.js

@@ -98,11 +98,17 @@ export async function syncCustomLanding(sourcePath, projectDir, frameworkConfig,
   // Read all files from _landing/
   const files = await readdir(landingSource, { withFileTypes: true });
 
+  // Check if navbar/footer are explicitly hidden
+  const navbarHidden = landingConfig.navbar === false;
+  const footerHidden = landingConfig.footer === false;
+
   // Separate files by type
   const htmlFiles = [];
   const cssFiles = [];
   const jsFiles = [];
   const assetFiles = [];
+  let navbarHtml = null;
+  let footerHtml = null;
 
   for (const file of files) {
     if (file.isDirectory()) {
@@ -114,8 +120,17 @@ export async function syncCustomLanding(sourcePath, projectDir, frameworkConfig,
     }
 
     const ext = extname(file.name).toLowerCase();
+    const name = basename(file.name, ext).toLowerCase();
+
     if (ext === '.html' || ext === '.htm') {
-      htmlFiles.push(file.name);
+      // Detect custom navbar/footer HTML files (skip if hidden)
+      if (!navbarHidden && (name === 'navbar' || name === 'nav' || name === 'header')) {
+        navbarHtml = file.name;
+      } else if (!footerHidden && name === 'footer') {
+        footerHtml = file.name;
+      } else if (!((name === 'navbar' || name === 'nav' || name === 'header') || name === 'footer')) {
+        htmlFiles.push(file.name);
+      }
     } else if (ext === '.css') {
       cssFiles.push(file.name);
     } else if (ext === '.js' || ext === '.mjs') {
@@ -123,6 +138,31 @@ export async function syncCustomLanding(sourcePath, projectDir, frameworkConfig,
     }
   }
 
+  // Read custom navbar/footer content if present
+  let navbarContent = navbarHidden ? '__hidden__' : null;
+  let footerContent = footerHidden ? '__hidden__' : null;
+
+  if (!navbarHidden && navbarHtml) {
+    navbarContent = await readFile(join(landingSource, navbarHtml), 'utf-8');
+  }
+  if (!footerHidden && footerHtml) {
+    footerContent = await readFile(join(landingSource, footerHtml), 'utf-8');
+  }
+
+  // Also check config for custom navbar/footer (skip if hidden)
+  if (!navbarHidden && !navbarContent && landingConfig.navbar?.html) {
+    const navPath = join(landingSource, '..', landingConfig.navbar.html);
+    if (await pathExists(navPath)) {
+      navbarContent = await readFile(navPath, 'utf-8');
+    }
+  }
+  if (!footerHidden && !footerContent && landingConfig.footer?.html) {
+    const footerPath = join(landingSource, '..', landingConfig.footer.html);
+    if (await pathExists(footerPath)) {
+      footerContent = await readFile(footerPath, 'utf-8');
+    }
+  }
+
   // Generate landing page based on framework
   await generateLandingForFramework(
     projectDir,
@@ -133,6 +173,8 @@ export async function syncCustomLanding(sourcePath, projectDir, frameworkConfig,
       cssFiles,
       jsFiles,
       assetFiles,
+      navbarContent,
+      footerContent,
       config: landingConfig,
     }
   );
@@ -170,12 +212,55 @@ export async function syncSectionsLanding(sourcePath, projectDir, frameworkConfi
     }
   }
 
+  // Check if navbar/footer are explicitly hidden
+  const navbarHidden = landingConfig.navbar === false;
+  const footerHidden = landingConfig.footer === false;
+
+  // Check for custom navbar/footer in _landing/ folder
+  const landingSource = join(sourcePath, landingConfig.source || '_landing');
+  let navbarContent = navbarHidden ? '__hidden__' : null;
+  let footerContent = footerHidden ? '__hidden__' : null;
+
+  if (!navbarHidden) {
+    const navbarNames = ['navbar.html', 'nav.html', 'header.html'];
+    for (const name of navbarNames) {
+      const navPath = join(landingSource, name);
+      if (await pathExists(navPath)) {
+        navbarContent = await readFile(navPath, 'utf-8');
+        break;
+      }
+    }
+  }
+
+  if (!footerHidden) {
+    const footerPath = join(landingSource, 'footer.html');
+    if (await pathExists(footerPath)) {
+      footerContent = await readFile(footerPath, 'utf-8');
+    }
+  }
+
+  // Also check config for custom navbar/footer (skip if hidden)
+  if (!navbarHidden && !navbarContent && landingConfig.navbar?.html) {
+    const navPath = join(sourcePath, landingConfig.navbar.html);
+    if (await pathExists(navPath)) {
+      navbarContent = await readFile(navPath, 'utf-8');
+    }
+  }
+  if (!footerHidden && !footerContent && landingConfig.footer?.html) {
+    const fPath = join(sourcePath, landingConfig.footer.html);
+    if (await pathExists(fPath)) {
+      footerContent = await readFile(fPath, 'utf-8');
+    }
+  }
+
   // Generate sections landing for framework
   await generateSectionsLandingForFramework(
     projectDir,
     frameworkConfig,
     {
       sections: processedSections,
+      navbarContent,
+      footerContent,
       config: landingConfig,
     }
   );
@@ -213,7 +298,7 @@ async function generateLandingForFramework(projectDir, frameworkConfig, landingD
  * Generate Astro landing page (standalone, no template imports)
  */
 async function generateAstroLanding(projectDir, landingData) {
-  const { sourcePath, htmlFiles, cssFiles, jsFiles, config } = landingData;
+  const { sourcePath, htmlFiles, cssFiles, jsFiles, navbarContent, footerContent, config } = landingData;
 
   // Read main HTML file
   const mainHtml = htmlFiles.includes('index.html') ? 'index.html' : htmlFiles[0];
@@ -224,13 +309,17 @@ async function generateAstroLanding(projectDir, landingData) {
 
   let htmlContent = await readFile(join(sourcePath, mainHtml), 'utf-8');
 
-  // Read CSS files
+  // Read CSS files and write to a separate file
   let cssContent = '';
   for (const cssFile of cssFiles) {
     const css = await readFile(join(sourcePath, cssFile), 'utf-8');
     cssContent += `/* ${cssFile} */\n${css}\n\n`;
   }
 
+  // Write landing CSS to a separate file so Vite processes it through the full pipeline
+  const landingCssPath = join(projectDir, 'src', 'styles', 'landing.css');
+  await writeFile(landingCssPath, cssContent, 'utf-8');
+
   // Read JS files
   let jsContent = '';
   for (const jsFile of jsFiles) {
@@ -238,13 +327,33 @@ async function generateAstroLanding(projectDir, landingData) {
     jsContent += `// ${jsFile}\n${js}\n\n`;
   }
 
+  // Determine header/footer: hidden ('__hidden__'), custom (string HTML), or default (null)
+  const navbarIsHidden = navbarContent === '__hidden__';
+  const footerIsHidden = footerContent === '__hidden__';
+  const hasCustomNavbar = !navbarIsHidden && !!navbarContent;
+  const hasCustomFooter = !footerIsHidden && !!footerContent;
+
+  const headerImport = navbarIsHidden || hasCustomNavbar ? '' : "import Header from '../components/Header.astro';";
+  const footerImport = footerIsHidden || hasCustomFooter ? '' : "import Footer from '../components/Footer.astro';";
+  const headerRender = navbarIsHidden
+    ? ''
+    : hasCustomNavbar
+      ? `<header class="landing-custom-navbar">\n      ${navbarContent}\n    </header>`
+      : '<Header />';
+  const footerRender = footerIsHidden
+    ? ''
+    : hasCustomFooter
+      ? `<footer class="landing-custom-footer">\n      ${footerContent}\n    </footer>`
+      : '<Footer />';
+
   // Generate standalone Astro component
   const astroContent = `---
 // Custom landing page - auto-generated by Lito CLI
 // Source: _landing/ folder
 import '../styles/global.css';
-import Header from '../components/Header.astro';
-import Footer from '../components/Footer.astro';
+import '../styles/landing.css';
+${headerImport}
+${footerImport}
 import { getConfigFile } from '../utils/config';
 
 const config = await getConfigFile();
@@ -269,18 +378,15 @@ const config = await getConfigFile();
         document.documentElement.classList.add('light');
       }
     </script>
-    <style>
-      ${cssContent}
-    </style>
   </head>
   <body class="bg-background text-foreground font-sans antialiased">
-    <Header />
+    ${headerRender}
 
     <main class="landing-custom">
       ${htmlContent}
     </main>
 
-    <Footer />
+    ${footerRender}
 
     ${jsContent ? `<script>\n${jsContent}\n</script>` : ''}
   </body>
@@ -571,7 +677,7 @@ async function generateSectionsLandingForFramework(projectDir, frameworkConfig,
  * Generate Astro sections landing page
  */
 async function generateAstroSectionsLanding(projectDir, landingData) {
-  const { sections, config } = landingData;
+  const { sections, navbarContent, footerContent, config } = landingData;
 
   // Generate section renders
   const sectionRenders = sections.map((section, index) => {
@@ -591,11 +697,30 @@ async function generateAstroSectionsLanding(projectDir, landingData) {
     }
   }).join('\n');
 
+  // Determine header/footer: hidden ('__hidden__'), custom (string HTML), or default (null)
+  const navbarIsHidden = navbarContent === '__hidden__';
+  const footerIsHidden = footerContent === '__hidden__';
+  const hasCustomNavbar = !navbarIsHidden && !!navbarContent;
+  const hasCustomFooter = !footerIsHidden && !!footerContent;
+
+  const headerImport = navbarIsHidden || hasCustomNavbar ? '' : "import Header from '../components/Header.astro';";
+  const footerImport = footerIsHidden || hasCustomFooter ? '' : "import Footer from '../components/Footer.astro';";
+  const headerRender = navbarIsHidden
+    ? ''
+    : hasCustomNavbar
+      ? `<header class="landing-custom-navbar">\n      ${navbarContent}\n    </header>`
+      : '<Header />';
+  const footerRender = footerIsHidden
+    ? ''
+    : hasCustomFooter
+      ? `<footer class="landing-custom-footer">\n      ${footerContent}\n    </footer>`
+      : '<Footer />';
+
   const astroContent = `---
 // Sections-based landing page - auto-generated by Lito CLI
 import '../styles/global.css';
-import Header from '../components/Header.astro';
-import Footer from '../components/Footer.astro';
+${headerImport}
+${footerImport}
 import { getConfigFile } from '../utils/config';
 
 const config = await getConfigFile();
@@ -621,13 +746,13 @@ const config = await getConfigFile();
     </script>
   </head>
   <body class="bg-background text-foreground font-sans antialiased">
-    <Header />
+    ${headerRender}
 
     <main class="landing-sections">
       ${sectionRenders}
     </main>
 
-    <Footer />
+    ${footerRender}
   </body>
 </html>
 `;

package/src/core/scaffold.js

@@ -1,6 +1,6 @@
 import pkg from 'fs-extra';
 const { ensureDir, emptyDir, copy, remove } = pkg;
-import { tmpdir } from 'os';
+import { homedir } from 'os';
 import { join, basename } from 'path';
 import { fileURLToPath } from 'url';
 import { dirname } from 'path';
@@ -8,8 +8,9 @@ import { dirname } from 'path';
 const __filename = fileURLToPath(import.meta.url);
 const __dirname = dirname(__filename);
 
-// Use a consistent directory path instead of random temp directories
-const LITO_DIR = join(tmpdir(), '.lito');
+// Use a directory under the user's home to avoid resolution issues
+// with bundlers (e.g. Turbopack) that fail to resolve node_modules from /tmp
+const LITO_DIR = join(homedir(), '.lito', 'dev-project');
 
 export async function scaffoldProject(customTemplatePath = null) {
   // Ensure the directory exists (creates if it doesn't)

package/src/core/sync.js

@@ -13,7 +13,7 @@ const KNOWN_LOCALES = [
 ];
 
 // Special folders that are not content
-const SPECIAL_FOLDERS = ['_assets', '_css', '_images', '_static', '_landing', 'public'];
+const SPECIAL_FOLDERS = ['_assets', '_css', '_images', '_static', '_landing', '_navbar', '_footer', 'public'];
 
 /**
  * Get i18n configuration from docs-config.json