@litodocs/cli 0.5.0 → 0.5.2

package/README.md

@@ -2,15 +2,20 @@
 
 Beautiful documentation sites from Markdown. Fast, simple, and open-source.
 
+> **Note:** This package was previously published as `@devrohit06/superdocs`. It has been renamed to `@litodocs/cli`.
+
 ## Features
 
-✨ **Simple Setup** - Point to your docs folder and go 
-🚀 **Astro-Powered** - Leverages Astro's speed and SEO optimization
-📝 **Markdown & MDX** - Full support for both formats with frontmatter
-🎨 **Customizable Templates** - Use GitHub-hosted or local templates
-🔥 **Hot Reload** - Dev server with live file watching
-⚡ **Fast Builds** - Static site generation for optimal performance
-🎯 **SEO Optimized** - Meta tags, semantic HTML, and proper structure
+- ✨ **Simple Setup** - Point to your docs folder and go
+- 🚀 **Astro-Powered** - Leverages Astro's speed and SEO optimization
+- 📝 **Markdown & MDX** - Full support for both formats with frontmatter
+- 🎨 **Customizable Templates** - Use GitHub-hosted or local templates
+- 🔥 **Hot Reload** - Dev server with live file watching
+- ⚡ **Fast Builds** - Static site generation for optimal performance
+- 🎯 **SEO Optimized** - Meta tags, semantic HTML, and proper structure
+- 🌍 **i18n Support** - Built-in internationalization with 40+ languages
+- 📚 **Versioning** - Documentation versioning with version switcher
+- 🎨 **Dynamic Theming** - OKLCH color palette generation from primary color
 
 ## Installation
 
@@ -20,14 +25,36 @@ Beautiful documentation sites from Markdown. Fast, simple, and open-source.
 npm install -g @litodocs/cli
 # or
 pnpm add -g @litodocs/cli
+# or
+yarn global add @litodocs/cli
 ```
 
 ### Local Development
 
+Clone the repository and link it locally:
+
 ```bash
-cd lito
+git clone https://github.com/Lito-docs/cli.git
+cd cli
 pnpm install
 chmod +x bin/cli.js
+npm link
+```
+
+Now you can use `lito` command globally from your terminal.
+
+## Quick Start
+
+```bash
+# Create a docs folder with markdown files
+mkdir my-docs
+echo "# Hello World" > my-docs/index.md
+
+# Start dev server
+lito dev -i ./my-docs
+
+# Build for production
+lito build -i ./my-docs -o ./dist
 ```
 
 ## Usage
@@ -42,14 +69,16 @@ lito build --input ./my-docs --output ./dist
 
 **Options:**
 
-- `-i, --input <path>` (required) - Path to your docs folder
-- `-o, --output <path>` - Output directory (default: `./dist`)
-- `-t, --template <name>` - Template to use (see [Templates](#templates))
-- `-b, --base-url <url>` - Base URL for the site (default: `/`)
-- `--provider <name>` - optimize for hosting provider (vercel, netlify, cloudflare, static)
-- `--rendering <mode>` - Rendering mode (static, server, hybrid)
-- `--search` - Enable search functionality
-- `--refresh` - Force re-download template from GitHub
+| Option | Description | Default |
+|--------|-------------|---------|
+| `-i, --input <path>` | Path to your docs folder (required) | - |
+| `-o, --output <path>` | Output directory | `./dist` |
+| `-t, --template <name>` | Template to use | `default` |
+| `-b, --base-url <url>` | Base URL for the site | `/` |
+| `--provider <name>` | Hosting provider (vercel, netlify, cloudflare, static) | `static` |
+| `--rendering <mode>` | Rendering mode (static, server, hybrid) | `static` |
+| `--search` | Enable search functionality | `false` |
+| `--refresh` | Force re-download template | `false` |
 
 ### Dev Command
 
@@ -61,12 +90,14 @@ lito dev --input ./my-docs
 
 **Options:**
 
-- `-i, --input <path>` (required) - Path to your docs folder
-- `-t, --template <name>` - Template to use
-- `-b, --base-url <url>` - Base URL for the site
-- `-p, --port <number>` - Port for dev server (default: `4321`)
-- `--search` - Enable search functionality
-- `--refresh` - Force re-download template
+| Option | Description | Default |
+|--------|-------------|---------|
+| `-i, --input <path>` | Path to your docs folder (required) | - |
+| `-t, --template <name>` | Template to use | `default` |
+| `-b, --base-url <url>` | Base URL for the site | `/` |
+| `-p, --port <number>` | Port for dev server | `4321` |
+| `--search` | Enable search functionality | `false` |
+| `--refresh` | Force re-download template | `false` |
 
 ### Eject Command
 
@@ -81,21 +112,27 @@ lito eject --input ./my-docs --output ./my-project
 Lito includes built-in optimizations for major hosting providers. Use the `--provider` flag during build:
 
 ### Vercel
+
 ```bash
 lito build -i ./docs --provider vercel
 ```
+
 Generates `vercel.json` and optimizes for Vercel's edge network.
 
 ### Netlify
+
 ```bash
 lito build -i ./docs --provider netlify
 ```
+
 Generates `netlify.toml` with security headers.
 
 ### Cloudflare Pages
+
 ```bash
 lito build -i ./docs --provider cloudflare --rendering server
 ```
+
 Configures the project for Cloudflare's edge runtime with SSR support.
 
 ## Analytics
@@ -198,7 +235,7 @@ Your content here...
 
 ## Architecture
 
-The CLI tool:
+The CLI tool follows this pipeline:
 
 1. **Resolves Template** - Fetches from GitHub or uses local template
 2. **Scaffolds** - Creates a temporary Astro project from the template
@@ -207,46 +244,6 @@ The CLI tool:
 5. **Builds/Serves** - Spawns native Astro CLI commands
 6. **Watches** (dev mode) - Uses `chokidar` to monitor file changes
 
-## Development
-
-### Project Structure
-
-```
-lito/
-├── bin/
-│   └── cli.js              # CLI entry point
-├── src/
-│   ├── cli.js              # Commander setup
-│   ├── commands/
-│   │   ├── build.js        # Build command
-│   │   ├── dev.js          # Dev command with watcher
-│   │   ├── eject.js        # Eject command
-│   │   └── template.js     # Template management
-│   ├── core/
-│   │   ├── scaffold.js     # Project scaffolding
-│   │   ├── sync.js         # File syncing
-│   │   ├── config.js       # Config generation
-│   │   ├── astro.js        # Astro CLI spawning
-│   │   ├── template-fetcher.js   # GitHub template fetching
-│   │   └── template-registry.js  # Template name registry
-│   └── template/           # Bundled fallback template
-└── package.json
-```
-
-### Running Tests
-
-```bash
-# Create sample docs
-mkdir sample-docs
-echo "# Hello\n\nWelcome!" > sample-docs/index.md
-
-# Test build
-node bin/cli.js build -i sample-docs -o test-output
-
-# Test dev server
-node bin/cli.js dev -i sample-docs
-```
-
 ## Contributing
 
 Contributions are welcome! Please feel free to submit a Pull Request.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@litodocs/cli",
-  "version": "0.5.0",
+  "version": "0.5.2",
   "description": "Beautiful documentation sites from Markdown. Fast, simple, and open-source.",
   "main": "src/index.js",
   "type": "module",

package/src/cli.js

@@ -7,16 +7,20 @@ import {
   templateListCommand,
   templateCacheCommand,
 } from "./commands/template.js";
+import { checkForUpdates, upgradeCommand } from "./core/update-check.js";
 
 export async function cli() {
   const program = new Command();
 
+  // Check for updates in the background (non-blocking)
+  checkForUpdates();
+
   program
     .name("lito")
     .description(
       "Beautiful documentation sites from Markdown. Fast, simple, and open-source."
     )
-    .version("0.5.0");
+    .version("0.5.2");
 
   program
     .command("build")
@@ -107,6 +111,11 @@ export async function cli() {
     .option("--clear", "Clear all cached templates")
     .action(templateCacheCommand);
 
+  program
+    .command("upgrade")
+    .description("Check for updates and upgrade to the latest version")
+    .action(upgradeCommand);
+
   try {
     await program.parseAsync(process.argv);
   } catch (error) {

package/src/core/update-check.js

@@ -0,0 +1,138 @@
+import { exec } from 'child_process';
+import { promisify } from 'util';
+import pc from 'picocolors';
+import { confirm } from '@clack/prompts';
+
+const execAsync = promisify(exec);
+
+const PACKAGE_NAME = '@litodocs/cli';
+
+/**
+ * Get the current installed version from package.json
+ */
+export function getCurrentVersion() {
+  return '0.5.2';
+}
+
+/**
+ * Fetch the latest version from npm registry
+ */
+async function getLatestVersion() {
+  try {
+    const { stdout } = await execAsync(`npm view ${PACKAGE_NAME} version`, {
+      timeout: 5000,
+    });
+    return stdout.trim();
+  } catch {
+    return null;
+  }
+}
+
+/**
+ * Compare two semver versions
+ * Returns: 1 if v1 > v2, -1 if v1 < v2, 0 if equal
+ */
+function compareVersions(v1, v2) {
+  const parts1 = v1.split('.').map(Number);
+  const parts2 = v2.split('.').map(Number);
+
+  for (let i = 0; i < 3; i++) {
+    const p1 = parts1[i] || 0;
+    const p2 = parts2[i] || 0;
+    if (p1 > p2) return 1;
+    if (p1 < p2) return -1;
+  }
+  return 0;
+}
+
+/**
+ * Upgrade the package using the detected package manager
+ */
+async function upgradePackage() {
+  const packageManagers = ['pnpm', 'yarn', 'npm'];
+
+  for (const pm of packageManagers) {
+    try {
+      await execAsync(`${pm} --version`, { timeout: 2000 });
+
+      console.log(pc.cyan(`\nUpgrading using ${pm}...`));
+
+      const command = pm === 'yarn'
+        ? `yarn global add ${PACKAGE_NAME}@latest`
+        : `${pm} install -g ${PACKAGE_NAME}@latest`;
+
+      const { stdout, stderr } = await execAsync(command, { timeout: 60000 });
+
+      if (stdout) console.log(stdout);
+
+      console.log(pc.green(`\n✓ Successfully upgraded ${PACKAGE_NAME}!`));
+      console.log(pc.dim('Please restart your terminal or run the command again.\n'));
+      return true;
+    } catch {
+      continue;
+    }
+  }
+
+  console.log(pc.yellow('\nCould not auto-upgrade. Please run manually:'));
+  console.log(pc.cyan(`  npm install -g ${PACKAGE_NAME}@latest\n`));
+  return false;
+}
+
+/**
+ * Check for updates and prompt user to upgrade
+ */
+export async function checkForUpdates() {
+  try {
+    const currentVersion = getCurrentVersion();
+    const latestVersion = await getLatestVersion();
+
+    if (!latestVersion) {
+      return; // Silently fail if we can't check
+    }
+
+    if (compareVersions(latestVersion, currentVersion) > 0) {
+      console.log('');
+      console.log(pc.yellow('╭─────────────────────────────────────────────────╮'));
+      console.log(pc.yellow('│') + '  Update available! ' + pc.dim(`${currentVersion}`) + ' → ' + pc.green(`${latestVersion}`) + pc.yellow('            │'));
+      console.log(pc.yellow('│') + pc.dim(`  Run: lito upgrade`) + pc.yellow('                              │'));
+      console.log(pc.yellow('╰─────────────────────────────────────────────────╯'));
+      console.log('');
+    }
+  } catch {
+    // Silently fail - don't interrupt the user's workflow
+  }
+}
+
+/**
+ * Upgrade command handler
+ */
+export async function upgradeCommand() {
+  console.log(pc.cyan('\n🔍 Checking for updates...\n'));
+
+  const currentVersion = getCurrentVersion();
+  const latestVersion = await getLatestVersion();
+
+  if (!latestVersion) {
+    console.log(pc.yellow('Could not check for updates. Please check your internet connection.\n'));
+    return;
+  }
+
+  console.log(`  Current version: ${pc.dim(currentVersion)}`);
+  console.log(`  Latest version:  ${pc.green(latestVersion)}\n`);
+
+  if (compareVersions(latestVersion, currentVersion) <= 0) {
+    console.log(pc.green('✓ You are already on the latest version!\n'));
+    return;
+  }
+
+  const shouldUpgrade = await confirm({
+    message: `Upgrade from ${currentVersion} to ${latestVersion}?`,
+    initialValue: true,
+  });
+
+  if (shouldUpgrade) {
+    await upgradePackage();
+  } else {
+    console.log(pc.dim('\nUpgrade cancelled.\n'));
+  }
+}