create-velocity-astro 1.5.3 → 1.6.0

package/dist/index.js

@@ -3,13 +3,13 @@
 // src/cli.ts
 import mri from "mri";
 import { resolve as resolve2 } from "path";
-import { existsSync as existsSync5 } from "fs";
-import * as p3 from "@clack/prompts";
+import { existsSync as existsSync8 } from "fs";
+import * as p5 from "@clack/prompts";
 import pc4 from "picocolors";
 
 // src/prompts.ts
 import * as p from "@clack/prompts";
-import pc2 from "picocolors";
+import pc from "picocolors";
 
 // src/utils/validate.ts
 function validateProjectName(name) {
@@ -163,38 +163,6 @@ function getSelectionStats(resolved, registry) {
   };
 }
 
-// src/display.ts
-import gradient from "gradient-string";
-import figures from "figures";
-import pc from "picocolors";
-var velocityGrad = gradient(["#FF6B35", "#F94C10", "#E63900"]);
-var successGrad = gradient(["#22c55e", "#10b981"]);
-var BANNER = `
- \u2588 \u2588 \u2588\u2580\u2580 \u2588   \u2588\u2580\u2588 \u2588\u2580\u2580 \u2588 \u2580\u2588\u2580 \u2588 \u2588
- \u2580\u2584\u2580 \u2588\u2588\u2584 \u2588\u2584\u2584 \u2588\u2584\u2588 \u2588\u2584\u2584 \u2588  \u2588  \u2580\u2584\u2580
-`;
-function showBanner() {
-  console.log();
-  console.log(velocityGrad.multiline(BANNER));
-  console.log(pc.dim("  Astro 6 & Tailwind v4 Starter Kit"));
-  console.log();
-}
-var symbols = {
-  rocket: "\u{1F680}",
-  sparkles: "\u2728",
-  package: "\u{1F4E6}",
-  check: figures.tick,
-  pointer: figures.pointer
-};
-function showSuccessBanner() {
-  console.log();
-  console.log(successGrad("  \u2728 Project created successfully! \u2728"));
-  console.log();
-}
-function velocityGradient(text2) {
-  return velocityGrad(text2);
-}
-
 // src/prompts.ts
 function parsePageNames(input) {
   if (!input.trim()) return [];
@@ -207,7 +175,7 @@ async function promptComponentMode() {
       {
         value: "all",
         label: "All",
-        hint: "Include all 26 optional components"
+        hint: "Include all 24 optional components"
       },
       {
         value: "categories",
@@ -323,7 +291,7 @@ async function getComponentSelection(defaultSelection) {
       const resolved = resolveDependencies(selection, registry);
       const stats = getSelectionStats(resolved, registry);
       p.log.info(
-        pc2.dim(`Selected ${stats.componentCount} components (${resolved.files.length} files)`)
+        pc.dim(`Selected ${stats.componentCount} components (${resolved.files.length} files)`)
       );
       return selection;
     }
@@ -334,13 +302,13 @@ async function getComponentSelection(defaultSelection) {
       const stats = getSelectionStats(resolved, registry);
       if (resolved.components.length > components.length) {
         p.log.info(
-          pc2.dim(
+          pc.dim(
             `Selected ${components.length} components + ${resolved.components.length - components.length} dependencies (${resolved.files.length} files)`
           )
         );
       } else {
         p.log.info(
-          pc2.dim(`Selected ${stats.componentCount} components (${resolved.files.length} files)`)
+          pc.dim(`Selected ${stats.componentCount} components (${resolved.files.length} files)`)
         );
       }
       return selection;
@@ -481,37 +449,35 @@ async function runPrompts(defaults = {}) {
   };
 }
 function showIntro() {
-  showBanner();
+  console.log();
+  p.intro(pc.bgCyan(pc.black(" Create Velocity ")));
 }
 function showOutro(projectName, packageManager) {
   const runCmd = packageManager === "npm" ? "npm run" : packageManager;
-  showSuccessBanner();
-  console.log(pc2.bold("  Next steps:"));
-  console.log();
-  console.log(`  ${pc2.dim("$")} ${pc2.cyan(`cd ${projectName}`)}`);
-  console.log(`  ${pc2.dim("$")} ${pc2.cyan(`${runCmd} dev`)}`);
-  console.log();
-  console.log(`  ${pc2.dim("Docs:")} ${pc2.cyan("https://docs.deployvelocity.com")}`);
-  console.log();
-  console.log(velocityGradient("  Happy building! \u{1F680}"));
-  console.log();
+  p.note(
+    [
+      `cd ${projectName}`,
+      `${runCmd} dev`
+    ].join("\n"),
+    "Next steps"
+  );
+  p.outro(pc.green("Happy building!"));
 }
 function showError(message) {
-  p.log.error(pc2.red(message));
+  p.log.error(pc.red(message));
 }
 function showWarning(message) {
-  p.log.warn(pc2.yellow(message));
+  p.log.warn(pc.yellow(message));
 }
 function showSuccess(message) {
-  p.log.success(pc2.green(message));
+  p.log.success(pc.green(message));
 }
 
 // src/scaffold.ts
-import { existsSync as existsSync3, mkdirSync as mkdirSync2, readdirSync, copyFileSync, readFileSync as readFileSync2, writeFileSync as writeFileSync2, rmSync } from "fs";
-import { join as join2, dirname as dirname2 } from "path";
+import { existsSync as existsSync5, mkdirSync as mkdirSync3, readdirSync as readdirSync2, copyFileSync as copyFileSync2, readFileSync as readFileSync3, writeFileSync as writeFileSync3, rmSync } from "fs";
+import { join as join4, dirname as dirname3 } from "path";
 import * as p2 from "@clack/prompts";
 import { execa as execa2 } from "execa";
-import pc3 from "picocolors";
 import { downloadTemplate } from "giget";
 
 // src/template.ts
@@ -627,23 +593,18 @@ function addI18nRouteEntry(targetDir, pageName) {
 }
 function addI18nTranslationKeys(targetDir, routeId, title) {
   const locales = ["en", "es", "fr"];
-  const defaultLocale = "en";
   for (const locale of locales) {
     const translationPath = join(targetDir, "src", "i18n", "translations", `${locale}.ts`);
     if (!existsSync2(translationPath)) {
       continue;
     }
     let content = readFileSync(translationPath, "utf-8");
-    const isDefaultLocale = locale === defaultLocale;
-    const navLabel = isDefaultLocale ? title : `[TODO: Translate] ${title}`;
-    const pageTitle = isDefaultLocale ? title : `[TODO: Translate] ${title}`;
-    const pageDesc = isDefaultLocale ? `Add your ${title.toLowerCase()} page description here.` : `[TODO: Translate] Add your ${title.toLowerCase()} page description here.`;
     if (!content.includes(`${routeId}:`)) {
       const navSectionMatch = content.match(/nav:\s*\{([^}]+)\}/);
       if (navSectionMatch) {
         const navSection = navSectionMatch[0];
         const insertPoint = navSection.lastIndexOf("}");
-        const newNavSection = navSection.slice(0, insertPoint) + `    ${routeId}: '${navLabel}',
+        const newNavSection = navSection.slice(0, insertPoint) + `    ${routeId}: '${title}',
   ` + navSection.slice(insertPoint);
         content = content.replace(navSection, newNavSection);
       }
@@ -655,8 +616,8 @@ function addI18nTranslationKeys(targetDir, routeId, title) {
         const pageTranslations = `
   // ${title} page
   ${routeId}: {
-    title: '${pageTitle}',
-    description: '${pageDesc}',
+    title: '${title}',
+    description: 'Add your ${title.toLowerCase()} page description here.',
   },
 
 `;
@@ -696,47 +657,6 @@ import ${layoutName} from '@/layouts/${layoutName}.astro';
 </${layoutName}>
 `;
 }
-function generateI18nDefaultLocaleTemplate(pageName, layout) {
-  const title = toTitle(pageName);
-  const layoutName = layout === "landing" ? "LandingLayout" : "PageLayout";
-  const routeId = toRouteId(pageName);
-  const titleKey = `${routeId}.title`;
-  const descKey = `${routeId}.description`;
-  return `---
-import ${layoutName} from '@/layouts/${layoutName}.astro';
-import { defaultLocale } from '@/i18n/config';
-import { useTranslations } from '@/i18n/index';
-
-const t = useTranslations(defaultLocale);
----
-
-<${layoutName}
-  title={t('${titleKey}') || '${title}'}
-  description={t('${descKey}') || 'Add your description here'}
-  lang={defaultLocale}
-  routeId="${routeId}"
->
-  <!-- Hero Section -->
-  <section class="py-20 bg-secondary">
-    <div class="container">
-      <h1 class="text-4xl font-bold text-foreground">
-        {t('${titleKey}') || '${title}'}
-      </h1>
-      <p class="mt-4 text-foreground-muted max-w-2xl">
-        {t('${descKey}') || 'Add your content here.'}
-      </p>
-    </div>
-  </section>
-
-  <!-- Content Section -->
-  <section class="py-16">
-    <div class="container">
-      <!-- Your content -->
-    </div>
-  </section>
-</${layoutName}>
-`;
-}
 function generateI18nPageTemplate(pageName, layout) {
   const title = toTitle(pageName);
   const layoutName = layout === "landing" ? "LandingLayout" : "PageLayout";
@@ -808,7 +728,7 @@ async function generatePages(targetDir, pages, layout, isI18n) {
   }
   for (const pageName of pages) {
     const filePath = join(pagesDir, `${pageName}.astro`);
-    const template = isI18n ? generateI18nDefaultLocaleTemplate(pageName, layout) : generatePageTemplate(pageName, layout);
+    const template = generatePageTemplate(pageName, layout);
     writeFileSync(filePath, template);
     generatedFiles.push(`src/pages/${pageName}.astro`);
     if (!isI18n) {
@@ -832,6 +752,68 @@ async function generatePages(targetDir, pages, layout, isI18n) {
   return generatedFiles;
 }
 
+// src/utils/velocity-config.ts
+import { existsSync as existsSync4 } from "fs";
+import { join as join3 } from "path";
+
+// src/utils/fs.ts
+import { existsSync as existsSync3, mkdirSync as mkdirSync2, readdirSync, statSync, copyFileSync, readFileSync as readFileSync2, writeFileSync as writeFileSync2 } from "fs";
+import { join as join2, dirname as dirname2 } from "path";
+function isEmptyDir(path) {
+  if (!existsSync3(path)) return true;
+  const files = readdirSync(path);
+  return files.length === 0 || files.length === 1 && files[0] === ".git";
+}
+function readJson(path) {
+  const content = readFileSync2(path, "utf-8");
+  return JSON.parse(content);
+}
+function writeJson(path, data) {
+  writeFileSync2(path, JSON.stringify(data, null, 2) + "\n");
+}
+
+// src/utils/velocity-config.ts
+var CONFIG_FILENAME = ".velocity.json";
+function readVelocityConfig(projectDir) {
+  const configPath = join3(projectDir, CONFIG_FILENAME);
+  if (!existsSync4(configPath)) {
+    return null;
+  }
+  return readJson(configPath);
+}
+function writeVelocityConfig(projectDir, config) {
+  const configPath = join3(projectDir, CONFIG_FILENAME);
+  writeJson(configPath, config);
+}
+function createInitialConfig(options, version) {
+  const today = (/* @__PURE__ */ new Date()).toISOString().slice(0, 10);
+  let componentsValue;
+  switch (options.componentSelection.mode) {
+    case "all":
+      componentsValue = "all";
+      break;
+    case "none":
+      componentsValue = "none";
+      break;
+    case "categories":
+      componentsValue = `categories:${options.componentSelection.categories?.join(",") ?? ""}`;
+      break;
+    case "individual":
+      componentsValue = `individual:${options.componentSelection.components?.join(",") ?? ""}`;
+      break;
+  }
+  return {
+    version,
+    createdAt: today,
+    updatedAt: today,
+    features: {
+      demo: options.demo,
+      i18n: options.i18n,
+      components: componentsValue
+    }
+  };
+}
+
 // src/scaffold.ts
 var TEMPLATE_REPO = "github:southwellmedia/velocity";
 var CLEANUP_ITEMS = [
@@ -842,8 +824,9 @@ var CLEANUP_ITEMS = [
   ".git"
 ];
 var DEMO_CONTENT = [
-  // Landing page components (NOT hero - that's a core component)
+  // Landing page components
   "src/components/landing",
+  "src/components/hero",
   // Landing-specific pages (base paths)
   "src/pages/index.astro",
   "src/pages/about.astro",
@@ -868,24 +851,24 @@ var OPTIONAL_COMPONENT_DIRS = [
   "src/components/hero"
 ];
 function copyTemplateFiles(src, dest) {
-  if (!existsSync3(dest)) {
-    mkdirSync2(dest, { recursive: true });
+  if (!existsSync5(dest)) {
+    mkdirSync3(dest, { recursive: true });
   }
-  const entries = readdirSync(src, { withFileTypes: true });
+  const entries = readdirSync2(src, { withFileTypes: true });
   for (const entry of entries) {
-    const srcPath = join2(src, entry.name);
-    const destPath = join2(dest, entry.name);
+    const srcPath = join4(src, entry.name);
+    const destPath = join4(dest, entry.name);
     if (entry.isDirectory()) {
       copyTemplateFiles(srcPath, destPath);
     } else {
-      copyFileSync(srcPath, destPath);
+      copyFileSync2(srcPath, destPath);
     }
   }
 }
 function removeItems(targetDir, items) {
   for (const item of items) {
-    const itemPath = join2(targetDir, item);
-    if (existsSync3(itemPath)) {
+    const itemPath = join4(targetDir, item);
+    if (existsSync5(itemPath)) {
       try {
         rmSync(itemPath, { recursive: true, force: true });
       } catch {
@@ -900,22 +883,22 @@ function keepOnlyFiles(targetDir, filesToKeep) {
     "src/components/hero"
   ];
   for (const dir of componentDirs) {
-    const dirPath = join2(targetDir, dir);
-    if (!existsSync3(dirPath)) continue;
-    const entries = readdirSync(dirPath, { withFileTypes: true });
+    const dirPath = join4(targetDir, dir);
+    if (!existsSync5(dirPath)) continue;
+    const entries = readdirSync2(dirPath, { withFileTypes: true });
     for (const entry of entries) {
       if (entry.isFile()) {
         const relativePath = `${dir}/${entry.name}`;
         if (!filesToKeep.has(relativePath)) {
           try {
-            rmSync(join2(dirPath, entry.name), { force: true });
+            rmSync(join4(dirPath, entry.name), { force: true });
           } catch {
           }
         }
       }
     }
     try {
-      const remaining = readdirSync(dirPath);
+      const remaining = readdirSync2(dirPath);
       if (remaining.length === 0) {
         rmSync(dirPath, { recursive: true, force: true });
       }
@@ -924,21 +907,21 @@ function keepOnlyFiles(targetDir, filesToKeep) {
   }
 }
 function updatePackageJson(targetDir, projectName) {
-  const pkgPath = join2(targetDir, "package.json");
-  if (!existsSync3(pkgPath)) {
+  const pkgPath = join4(targetDir, "package.json");
+  if (!existsSync5(pkgPath)) {
     throw new Error("package.json not found in template");
   }
-  const pkg = JSON.parse(readFileSync2(pkgPath, "utf-8"));
+  const pkg = JSON.parse(readFileSync3(pkgPath, "utf-8"));
   pkg.name = projectName;
   pkg.version = "0.1.0";
   delete pkg.repository;
   delete pkg.bugs;
   delete pkg.homepage;
-  writeFileSync2(pkgPath, JSON.stringify(pkg, null, 2) + "\n");
+  writeFileSync3(pkgPath, JSON.stringify(pkg, null, 2) + "\n");
 }
 function applyBaseTemplate(targetDir) {
   const baseTemplate = getBaseTemplatePath();
-  if (existsSync3(baseTemplate)) {
+  if (existsSync5(baseTemplate)) {
     copyTemplateFiles(baseTemplate, targetDir);
   }
 }
@@ -946,25 +929,15 @@ function applyI18nOverlay(targetDir) {
   const i18nTemplate = getI18nTemplatePath();
   copyTemplateFiles(i18nTemplate, targetDir);
 }
-function removeComponentsRoute(targetDir, isI18n) {
-  const routesPath = isI18n ? join2(targetDir, "src", "i18n", "routes.ts") : join2(targetDir, "src", "config", "routes.ts");
-  if (!existsSync3(routesPath)) return;
-  let content = readFileSync2(routesPath, "utf-8");
-  content = content.replace(
-    /\n\s*\/\/ Components showcase\n\s*components:\s*\{[^}]+\},?\n/g,
-    "\n"
-  );
-  writeFileSync2(routesPath, content);
-}
 function createContentDirectories(targetDir) {
   const contentDirs = [
     "src/content/blog"
   ];
   for (const dir of contentDirs) {
-    const dirPath = join2(targetDir, dir);
-    if (!existsSync3(dirPath)) {
-      mkdirSync2(dirPath, { recursive: true });
-      writeFileSync2(join2(dirPath, ".gitkeep"), "");
+    const dirPath = join4(targetDir, dir);
+    if (!existsSync5(dirPath)) {
+      mkdirSync3(dirPath, { recursive: true });
+      writeFileSync3(join4(dirPath, ".gitkeep"), "");
     }
   }
 }
@@ -987,142 +960,569 @@ async function applyComponentSelection(targetDir, selection) {
   const filesToKeep = new Set(resolved.files);
   keepOnlyFiles(targetDir, filesToKeep);
   if (resolved.utilities.includes("cn")) {
-    const cnPath = join2(targetDir, "src/lib/cn.ts");
-    const cnDir = dirname2(cnPath);
-    if (!existsSync3(cnDir)) {
-      mkdirSync2(cnDir, { recursive: true });
+    const cnPath = join4(targetDir, "src/lib/cn.ts");
+    const cnDir = dirname3(cnPath);
+    if (!existsSync5(cnDir)) {
+      mkdirSync3(cnDir, { recursive: true });
     }
   }
 }
 async function scaffold(options) {
   const { projectName, targetDir, demo, componentSelection, i18n, pages, pageLayout, packageManager } = options;
-  const spinner2 = p2.spinner();
-  spinner2.start("Downloading template from GitHub...");
+  const spinner3 = p2.spinner();
+  spinner3.start("Downloading template from GitHub...");
   try {
     await downloadTemplate(TEMPLATE_REPO, {
       dir: targetDir,
       force: true
     });
     removeItems(targetDir, CLEANUP_ITEMS);
-    spinner2.stop("Template downloaded");
+    spinner3.stop("Template downloaded");
   } catch (error) {
-    spinner2.stop("Failed to download template");
+    spinner3.stop("Failed to download template");
     throw new Error(
       `Could not download template from GitHub. Please check your internet connection.
 ${error instanceof Error ? error.message : ""}`
     );
   }
   if (componentSelection.mode !== "all") {
-    spinner2.start("Configuring components...");
+    spinner3.start("Configuring components...");
     try {
       await applyComponentSelection(targetDir, componentSelection);
-      spinner2.stop("Components configured");
+      spinner3.stop("Components configured");
     } catch (error) {
-      spinner2.stop("Failed to configure components");
+      spinner3.stop("Failed to configure components");
       throw error;
     }
   }
   if (i18n) {
-    spinner2.start("Adding i18n support...");
+    spinner3.start("Adding i18n support...");
     try {
       applyI18nOverlay(targetDir);
-      spinner2.stop("i18n support added");
+      spinner3.stop("i18n support added");
     } catch (error) {
-      spinner2.stop("Failed to add i18n support");
+      spinner3.stop("Failed to add i18n support");
       throw error;
     }
   }
   if (!demo) {
-    spinner2.start("Configuring minimal template...");
+    spinner3.start("Configuring minimal template...");
     removeItems(targetDir, DEMO_CONTENT);
     applyBaseTemplate(targetDir);
     createContentDirectories(targetDir);
-    removeComponentsRoute(targetDir, i18n);
-    spinner2.stop("Minimal template configured");
+    spinner3.stop("Minimal template configured");
   }
   if (pages.length > 0) {
-    spinner2.start(`Generating ${pages.length} starter page${pages.length > 1 ? "s" : ""}...`);
+    spinner3.start(`Generating ${pages.length} starter page${pages.length > 1 ? "s" : ""}...`);
     try {
       const generatedFiles = await generatePages(targetDir, pages, pageLayout, i18n);
-      spinner2.stop(`Generated ${generatedFiles.length} page file${generatedFiles.length > 1 ? "s" : ""}`);
-      if (i18n) {
-        showWarning(`i18n pages created with English-only content.
-
-You must manually:
-  1. Translate URL slugs in src/i18n/routes.ts
-  2. Add translations to src/i18n/translations/es.ts
-  3. Add translations to src/i18n/translations/fr.ts
-
-Look for [TODO: Translate] markers in the translation files.`);
-      }
+      spinner3.stop(`Generated ${generatedFiles.length} page file${generatedFiles.length > 1 ? "s" : ""}`);
     } catch (error) {
-      spinner2.stop("Failed to generate pages");
+      spinner3.stop("Failed to generate pages");
       throw error;
     }
   }
-  spinner2.start("Configuring project...");
+  spinner3.start("Configuring project...");
   try {
     updatePackageJson(targetDir, projectName);
-    spinner2.stop("Project configured");
+    spinner3.stop("Project configured");
   } catch (error) {
-    spinner2.stop("Failed to configure project");
+    spinner3.stop("Failed to configure project");
     throw error;
   }
-  spinner2.start("Initializing git repository...");
+  try {
+    let templateVersion = "0.1.0-beta";
+    const manifestPath = join4(targetDir, "velocity-manifest.json");
+    const pkgPath = join4(targetDir, "package.json");
+    if (existsSync5(manifestPath)) {
+      const manifest = readJson(manifestPath);
+      if (manifest.version) templateVersion = manifest.version;
+    } else if (existsSync5(pkgPath)) {
+      const pkg = readJson(pkgPath);
+      if (pkg.version) templateVersion = pkg.version;
+    }
+    const velocityConfig = createInitialConfig(options, templateVersion);
+    writeVelocityConfig(targetDir, velocityConfig);
+  } catch {
+  }
+  spinner3.start("Initializing git repository...");
   const gitInitialized = await initGit(targetDir);
   if (gitInitialized) {
-    spinner2.stop("Git repository initialized");
+    spinner3.stop("Git repository initialized");
   } else {
-    spinner2.stop("Git not available, skipping");
+    spinner3.stop("Git not available, skipping");
   }
-  console.log();
-  p2.log.step(`Installing dependencies with ${packageManager}...`);
-  console.log(pc3.dim("\u2500".repeat(50)));
+  spinner3.start(`Installing dependencies with ${packageManager}...`);
   try {
     const installCmd = getInstallCommand(packageManager);
     const [cmd, ...args] = installCmd.split(" ");
-    await execa2(cmd, args, {
+    await execa2(cmd, args, { cwd: targetDir });
+    spinner3.stop("Dependencies installed");
+  } catch {
+    spinner3.stop("Failed to install dependencies");
+    showWarning(`Run "${getInstallCommand(packageManager)}" manually to install dependencies`);
+  }
+  showSuccess(`Project "${projectName}" created successfully!`);
+}
+
+// src/upgrade.ts
+import { existsSync as existsSync7, readFileSync as readFileSync5, writeFileSync as writeFileSync4, mkdirSync as mkdirSync4, copyFileSync as copyFileSync3, readdirSync as readdirSync4, rmSync as rmSync2, statSync as statSync3 } from "fs";
+import { execSync } from "child_process";
+import { join as join6, dirname as dirname4, relative as relative2 } from "path";
+import { tmpdir } from "os";
+import * as p4 from "@clack/prompts";
+import pc3 from "picocolors";
+import { downloadTemplate as downloadTemplate2 } from "giget";
+
+// src/utils/diff.ts
+import { existsSync as existsSync6, readFileSync as readFileSync4, readdirSync as readdirSync3, statSync as statSync2 } from "fs";
+import { join as join5, relative } from "path";
+function walkDir(dir, baseDir) {
+  const results = [];
+  if (!existsSync6(dir)) return results;
+  const entries = readdirSync3(dir, { withFileTypes: true });
+  for (const entry of entries) {
+    const fullPath = join5(dir, entry.name);
+    if (entry.isDirectory()) {
+      results.push(...walkDir(fullPath, baseDir));
+    } else {
+      results.push(relative(baseDir, fullPath));
+    }
+  }
+  return results;
+}
+function expandPaths(paths, freshDir) {
+  const files = [];
+  for (const p6 of paths) {
+    const fullPath = join5(freshDir, p6);
+    if (p6.endsWith("/") || existsSync6(fullPath) && statSync2(fullPath).isDirectory()) {
+      files.push(...walkDir(fullPath, freshDir));
+    } else {
+      files.push(p6);
+    }
+  }
+  return [...new Set(files)];
+}
+function diffProjects(currentDir, freshDir, manifest) {
+  const diffs = [];
+  const safeFiles = expandPaths(manifest.files.safe, freshDir);
+  for (const filePath of safeFiles) {
+    const currentPath = join5(currentDir, filePath);
+    const freshPath = join5(freshDir, filePath);
+    if (!existsSync6(freshPath)) continue;
+    if (!existsSync6(currentPath)) {
+      diffs.push({ path: filePath, status: "added", category: "safe" });
+    } else {
+      const currentContent = readFileSync4(currentPath);
+      const freshContent = readFileSync4(freshPath);
+      if (Buffer.compare(currentContent, freshContent) === 0) {
+        diffs.push({ path: filePath, status: "unchanged", category: "safe" });
+      } else {
+        diffs.push({ path: filePath, status: "modified", category: "safe" });
+      }
+    }
+  }
+  return diffs;
+}
+function summarizeDiffs(diffs) {
+  let added = 0;
+  let modified = 0;
+  let unchanged = 0;
+  for (const diff of diffs) {
+    switch (diff.status) {
+      case "added":
+        added++;
+        break;
+      case "modified":
+        modified++;
+        break;
+      case "unchanged":
+        unchanged++;
+        break;
+    }
+  }
+  return { added, modified, unchanged };
+}
+
+// src/upgrade-prompts.ts
+import * as p3 from "@clack/prompts";
+import pc2 from "picocolors";
+function showUpgradeIntro(currentVersion, latestVersion) {
+  console.log();
+  p3.intro(pc2.bgCyan(pc2.black(" Velocity Upgrade ")));
+  p3.log.info(
+    `Current version: ${pc2.dim(`v${currentVersion}`)}
+Latest version:  ${pc2.green(`v${latestVersion}`)}`
+  );
+}
+function showChangeSummary(diffs, manifest) {
+  const { added, modified } = summarizeDiffs(diffs);
+  const depUpdated = Object.keys(manifest.dependencies.update).length;
+  const depRemoved = manifest.dependencies.remove.length;
+  const depAdded = Object.keys(manifest.dependencies.add).length;
+  const migrationCount = manifest.migrations.length;
+  const lines = [];
+  if (modified > 0) {
+    lines.push(`  ${pc2.yellow(`${modified}`)} file${modified !== 1 ? "s" : ""} modified ${pc2.dim("(framework components, layouts, utilities)")}`);
+  }
+  if (added > 0) {
+    lines.push(`  ${pc2.green(`${added}`)} file${added !== 1 ? "s" : ""} added ${pc2.dim("(new framework files)")}`);
+  }
+  if (depUpdated > 0) {
+    lines.push(`  ${pc2.cyan(`${depUpdated}`)} dependenc${depUpdated !== 1 ? "ies" : "y"} updated`);
+  }
+  if (depRemoved > 0) {
+    lines.push(`  ${pc2.red(`${depRemoved}`)} dependenc${depRemoved !== 1 ? "ies" : "y"} removed`);
+  }
+  if (depAdded > 0) {
+    lines.push(`  ${pc2.green(`${depAdded}`)} dependenc${depAdded !== 1 ? "ies" : "y"} added`);
+  }
+  if (migrationCount > 0) {
+    lines.push(`  ${pc2.yellow(`${migrationCount}`)} manual migration step${migrationCount !== 1 ? "s" : ""}`);
+  }
+  if (lines.length > 0) {
+    p3.log.message(pc2.bold("Changes to apply:") + "\n" + lines.join("\n"));
+  }
+}
+async function confirmUpgrade(dryRun) {
+  if (dryRun) {
+    p3.log.info(pc2.dim("Dry run \u2014 no changes will be made."));
+    return false;
+  }
+  const proceed = await p3.confirm({
+    message: "Proceed with upgrade?",
+    initialValue: true
+  });
+  if (p3.isCancel(proceed) || !proceed) {
+    p3.cancel("Upgrade cancelled.");
+    return false;
+  }
+  return true;
+}
+function showManualSteps(migrations, matchResults) {
+  if (migrations.length === 0) return;
+  const lines = [];
+  for (let i = 0; i < migrations.length; i++) {
+    const step = migrations[i];
+    const matches = matchResults.get(step.title) ?? [];
+    lines.push(`${pc2.bold(`${i + 1}. ${step.title}`)}`);
+    lines.push(`   ${step.description}`);
+    if (matches.length > 0) {
+      lines.push(`   ${pc2.yellow("\u26A0")} Found matches in: ${matches.join(", ")}`);
+    }
+    lines.push("");
+  }
+  p3.log.warning(pc2.bold("Manual steps required:") + "\n\n" + lines.join("\n"));
+}
+function showUpgradeOutro(hasDepChanges) {
+  if (hasDepChanges) {
+    p3.log.info(`Run ${pc2.cyan("pnpm install")} to update dependencies.`);
+  }
+  p3.outro(pc2.green("Upgrade complete! Review the manual steps above."));
+}
+async function warnDirtyGit(yes) {
+  if (yes) {
+    p3.log.warn(pc2.yellow("You have uncommitted changes. Proceeding anyway (--yes)."));
+    return true;
+  }
+  p3.log.warn(pc2.yellow("You have uncommitted changes. We recommend committing or stashing first."));
+  const proceed = await p3.confirm({
+    message: "Continue anyway?",
+    initialValue: false
+  });
+  if (p3.isCancel(proceed) || !proceed) {
+    p3.cancel("Upgrade cancelled.");
+    return false;
+  }
+  return true;
+}
+
+// src/upgrade.ts
+var TEMPLATE_REPO2 = "github:southwellmedia/velocity";
+var CLI_VERSION = "1.6.0";
+var FALLBACK_SAFE_FILES = [
+  "src/components/ui/",
+  "src/components/seo/",
+  "src/components/layout/",
+  "src/layouts/",
+  "src/lib/",
+  "src/styles/tokens/",
+  "src/styles/global.css",
+  "src/content.config.ts",
+  "tsconfig.json",
+  "eslint.config.js",
+  ".prettierrc",
+  ".prettierignore"
+];
+function hasUncommittedChanges(targetDir) {
+  try {
+    const result = execSync("git status --porcelain", {
       cwd: targetDir,
-      stdio: "inherit",
-      // Stream output to terminal
-      shell: process.platform === "win32"
-      // Windows compatibility
+      encoding: "utf-8"
     });
-    console.log(pc3.dim("\u2500".repeat(50)));
-    showSuccess("Dependencies installed");
+    return result.trim().length > 0;
+  } catch {
+    return false;
+  }
+}
+function isVersionLessThan(current, required) {
+  const parse = (v) => v.replace(/^v/, "").split(/[-.]/).map((p6) => {
+    const n = parseInt(p6, 10);
+    return isNaN(n) ? 0 : n;
+  });
+  const a = parse(current);
+  const b = parse(required);
+  const len = Math.max(a.length, b.length);
+  for (let i = 0; i < len; i++) {
+    const av = a[i] ?? 0;
+    const bv = b[i] ?? 0;
+    if (av < bv) return true;
+    if (av > bv) return false;
+  }
+  return false;
+}
+function scanForMigrationPatterns(targetDir, migrations) {
+  const results = /* @__PURE__ */ new Map();
+  for (const migration of migrations) {
+    if (!migration.pattern) {
+      results.set(migration.title, []);
+      continue;
+    }
+    const regex = new RegExp(migration.pattern);
+    const matches = [];
+    const searchPaths = migration.searchPaths?.length ? migration.searchPaths : ["src/"];
+    for (const searchPath of searchPaths) {
+      const fullPath = join6(targetDir, searchPath);
+      if (!existsSync7(fullPath)) continue;
+      const files = walkFiles(fullPath);
+      for (const file of files) {
+        try {
+          const content = readFileSync5(file, "utf-8");
+          if (regex.test(content)) {
+            matches.push(relative2(targetDir, file));
+          }
+        } catch {
+        }
+      }
+    }
+    results.set(migration.title, matches);
+  }
+  return results;
+}
+function walkFiles(dir) {
+  const results = [];
+  if (!existsSync7(dir)) return results;
+  const stat = statSync3(dir);
+  if (!stat.isDirectory()) {
+    return [dir];
+  }
+  const entries = readdirSync4(dir, { withFileTypes: true });
+  for (const entry of entries) {
+    const fullPath = join6(dir, entry.name);
+    if (entry.isDirectory()) {
+      if (entry.name === "node_modules" || entry.name === ".git") continue;
+      results.push(...walkFiles(fullPath));
+    } else {
+      results.push(fullPath);
+    }
+  }
+  return results;
+}
+function mergePackageJsonDeps(targetDir, manifest) {
+  const pkgPath = join6(targetDir, "package.json");
+  if (!existsSync7(pkgPath)) return;
+  const pkg = JSON.parse(readFileSync5(pkgPath, "utf-8"));
+  for (const [name, version] of Object.entries(manifest.dependencies.update)) {
+    if (pkg.dependencies?.[name] !== void 0) {
+      pkg.dependencies[name] = version;
+    } else if (pkg.devDependencies?.[name] !== void 0) {
+      pkg.devDependencies[name] = version;
+    } else {
+      if (!pkg.dependencies) pkg.dependencies = {};
+      pkg.dependencies[name] = version;
+    }
+  }
+  for (const name of manifest.dependencies.remove) {
+    if (pkg.dependencies?.[name] !== void 0) {
+      delete pkg.dependencies[name];
+    }
+    if (pkg.devDependencies?.[name] !== void 0) {
+      delete pkg.devDependencies[name];
+    }
+  }
+  for (const [name, version] of Object.entries(manifest.dependencies.add)) {
+    if (!pkg.dependencies) pkg.dependencies = {};
+    pkg.dependencies[name] = version;
+  }
+  writeFileSync4(pkgPath, JSON.stringify(pkg, null, 2) + "\n");
+}
+async function upgrade(options) {
+  const { targetDir, dryRun, yes } = options;
+  const config = readVelocityConfig(targetDir);
+  if (!config) {
+    p4.log.error(
+      pc3.red(
+        "This doesn't appear to be a Velocity project.\nRun this command from a project created with create-velocity-astro."
+      )
+    );
+    process.exit(1);
+  }
+  if (hasUncommittedChanges(targetDir)) {
+    const proceed = await warnDirtyGit(yes);
+    if (!proceed) return;
+  }
+  const spinner3 = p4.spinner();
+  spinner3.start("Downloading latest template...");
+  const tempDir = join6(tmpdir(), `velocity-upgrade-${Date.now()}`);
+  try {
+    await downloadTemplate2(TEMPLATE_REPO2, {
+      dir: tempDir,
+      force: true
+    });
+    spinner3.stop("Template downloaded");
   } catch (error) {
-    console.log(pc3.dim("\u2500".repeat(50)));
-    showWarning("Failed to install dependencies");
-    const execaError = error;
-    if (execaError.message) {
-      console.log(pc3.dim(`
-Error: ${execaError.message}`));
+    spinner3.stop("Failed to download template");
+    p4.log.error(
+      pc3.red(
+        "Could not download template. Check your internet connection.\n" + (error instanceof Error ? error.message : "")
+      )
+    );
+    cleanup(tempDir);
+    process.exit(1);
+  }
+  let manifest;
+  const manifestPath = join6(tempDir, "velocity-manifest.json");
+  if (existsSync7(manifestPath)) {
+    manifest = readJson(manifestPath);
+  } else {
+    p4.log.warn(pc3.yellow("Manifest not found in template. Using fallback file list."));
+    let templateVersion = config.version;
+    const templatePkgPath = join6(tempDir, "package.json");
+    if (existsSync7(templatePkgPath)) {
+      const templatePkg = readJson(templatePkgPath);
+      if (templatePkg.version) {
+        templateVersion = templatePkg.version;
+      }
     }
-    console.log();
-    console.log(pc3.yellow("To install manually, run:"));
-    console.log(`  ${pc3.cyan(getInstallCommand(packageManager))}`);
+    manifest = {
+      version: templateVersion,
+      minCliVersion: "1.0.0",
+      files: {
+        safe: FALLBACK_SAFE_FILES,
+        protected: []
+      },
+      dependencies: {
+        update: {},
+        remove: [],
+        add: {}
+      },
+      migrations: []
+    };
   }
-  showSuccess(`Project "${projectName}" created successfully!`);
+  if (isVersionLessThan(CLI_VERSION, manifest.minCliVersion)) {
+    p4.log.error(
+      pc3.red(
+        `This upgrade requires create-velocity-astro >= ${manifest.minCliVersion}.
+Run \`npm update -g create-velocity-astro\` to update.`
+      )
+    );
+    cleanup(tempDir);
+    process.exit(1);
+  }
+  if (config.version === manifest.version) {
+    showUpgradeIntro(config.version, manifest.version);
+    p4.log.info(pc3.green(`Already on v${manifest.version}. Nothing to upgrade.`));
+    p4.outro("");
+    cleanup(tempDir);
+    return;
+  }
+  const diffs = diffProjects(targetDir, tempDir, manifest);
+  const { added, modified } = summarizeDiffs(diffs);
+  if (added === 0 && modified === 0 && Object.keys(manifest.dependencies.update).length === 0 && manifest.dependencies.remove.length === 0 && Object.keys(manifest.dependencies.add).length === 0) {
+    showUpgradeIntro(config.version, manifest.version);
+    p4.log.info(pc3.green("All files are up to date. Updating version marker only."));
+    if (!dryRun) {
+      writeVelocityConfig(targetDir, {
+        ...config,
+        version: manifest.version,
+        updatedAt: (/* @__PURE__ */ new Date()).toISOString().slice(0, 10)
+      });
+    }
+    p4.outro("");
+    cleanup(tempDir);
+    return;
+  }
+  showUpgradeIntro(config.version, manifest.version);
+  showChangeSummary(diffs, manifest);
+  const shouldProceed = await confirmUpgrade(dryRun);
+  if (dryRun) {
+    const matchResults2 = scanForMigrationPatterns(targetDir, manifest.migrations);
+    showManualSteps(manifest.migrations, matchResults2);
+    p4.outro(pc3.dim("Dry run complete. No changes were made."));
+    cleanup(tempDir);
+    return;
+  }
+  if (!shouldProceed) {
+    cleanup(tempDir);
+    return;
+  }
+  spinner3.start("Applying changes...");
+  const changedDiffs = diffs.filter((d) => d.status === "added" || d.status === "modified");
+  for (const diff of changedDiffs) {
+    const src = join6(tempDir, diff.path);
+    const dest = join6(targetDir, diff.path);
+    const destDir = dirname4(dest);
+    if (!existsSync7(destDir)) {
+      mkdirSync4(destDir, { recursive: true });
+    }
+    copyFileSync3(src, dest);
+  }
+  const hasDepChanges = Object.keys(manifest.dependencies.update).length > 0 || manifest.dependencies.remove.length > 0 || Object.keys(manifest.dependencies.add).length > 0;
+  if (hasDepChanges) {
+    mergePackageJsonDeps(targetDir, manifest);
+  }
+  writeVelocityConfig(targetDir, {
+    ...config,
+    version: manifest.version,
+    updatedAt: (/* @__PURE__ */ new Date()).toISOString().slice(0, 10)
+  });
+  spinner3.stop("Changes applied");
+  if (modified > 0) {
+    p4.log.success(pc3.green(`Updated ${modified} framework file${modified !== 1 ? "s" : ""}`));
+  }
+  if (added > 0) {
+    p4.log.success(pc3.green(`Added ${added} new file${added !== 1 ? "s" : ""}`));
+  }
+  if (hasDepChanges) {
+    p4.log.success(pc3.green("Updated package.json dependencies"));
+  }
+  p4.log.success(pc3.green("Updated .velocity.json"));
+  const matchResults = scanForMigrationPatterns(targetDir, manifest.migrations);
+  showManualSteps(manifest.migrations, matchResults);
+  showUpgradeOutro(hasDepChanges);
+  cleanup(tempDir);
 }
-
-// src/utils/fs.ts
-import { existsSync as existsSync4, mkdirSync as mkdirSync3, readdirSync as readdirSync2, statSync, copyFileSync as copyFileSync2, readFileSync as readFileSync3, writeFileSync as writeFileSync3 } from "fs";
-import { join as join3, dirname as dirname3 } from "path";
-function isEmptyDir(path) {
-  if (!existsSync4(path)) return true;
-  const files = readdirSync2(path);
-  return files.length === 0 || files.length === 1 && files[0] === ".git";
+function cleanup(tempDir) {
+  try {
+    if (existsSync7(tempDir)) {
+      rmSync2(tempDir, { recursive: true, force: true });
+    }
+  } catch {
+  }
 }
 
 // src/cli.ts
 var HELP_TEXT = `
-${pc4.bold("create-velocity-astro")} - Create a new Velocity project
+${pc4.bold("create-velocity-astro")} - Create and upgrade Velocity projects
 
 ${pc4.bold("Usage:")}
   npm create velocity-astro@latest [project-name] [options]
   pnpm create velocity-astro [project-name] [options]
-  yarn create velocity-astro [project-name] [options]
-  bun create velocity-astro [project-name] [options]
+
+${pc4.bold("Commands:")}
+  ${pc4.cyan("upgrade")}             Upgrade an existing Velocity project to the latest version
+    --dry-run           Preview changes without applying them
+    --yes, -y           Skip confirmation prompts
 
 ${pc4.bold("Options:")}
   --demo              Include demo landing page and sample content
@@ -1144,11 +1544,13 @@ ${pc4.bold("Examples:")}
   npm create velocity-astro@latest my-site
   npm create velocity-astro@latest my-site --demo --components
   npm create velocity-astro@latest my-site --components=ui,patterns
-  npm create velocity-astro@latest my-site --components=none
-  npm create velocity-astro@latest my-site --i18n --pages
   pnpm create velocity-astro my-site -y
+
+  ${pc4.dim("# Upgrade an existing project")}
+  pnpm create velocity-astro upgrade
+  pnpm create velocity-astro upgrade --dry-run
 `;
-var VERSION = "1.4.2";
+var VERSION = "1.6.0";
 function parseComponentsFlag(value) {
   if (value === void 0) {
     return void 0;
@@ -1175,7 +1577,7 @@ function parseComponentsFlag(value) {
 }
 async function run(argv) {
   const args = mri(argv, {
-    boolean: ["demo", "i18n", "pages", "help", "version", "yes"],
+    boolean: ["demo", "i18n", "pages", "help", "version", "yes", "dry-run"],
     string: ["components"],
     alias: {
       h: "help",
@@ -1191,13 +1593,23 @@ async function run(argv) {
     console.log(VERSION);
     return;
   }
+  const subcommand = args._[0];
+  if (subcommand === "upgrade") {
+    const targetDir2 = resolve2(process.cwd());
+    await upgrade({
+      targetDir: targetDir2,
+      dryRun: args["dry-run"] || false,
+      yes: args.yes || false
+    });
+    return;
+  }
   showIntro();
   const argProjectName = args._[0];
   const componentSelection = parseComponentsFlag(args.components);
   if (args.yes) {
     const projectName2 = toValidProjectName(argProjectName || "my-velocity-site");
     const targetDir2 = resolve2(process.cwd(), projectName2);
-    if (existsSync5(targetDir2) && !isEmptyDir(targetDir2)) {
+    if (existsSync8(targetDir2) && !isEmptyDir(targetDir2)) {
       showError(`Directory "${projectName2}" already exists and is not empty.`);
       process.exit(1);
     }
@@ -1226,13 +1638,13 @@ async function run(argv) {
   }
   const { projectName, demo, componentSelection: selectedComponents, i18n, pages, pageLayout, packageManager } = answers;
   const targetDir = resolve2(process.cwd(), projectName);
-  if (existsSync5(targetDir) && !isEmptyDir(targetDir)) {
-    const shouldOverwrite = await p3.confirm({
+  if (existsSync8(targetDir) && !isEmptyDir(targetDir)) {
+    const shouldOverwrite = await p5.confirm({
       message: `Directory "${projectName}" already exists. Continue and overwrite?`,
       initialValue: false
     });
-    if (!shouldOverwrite || p3.isCancel(shouldOverwrite)) {
-      p3.cancel("Operation cancelled.");
+    if (!shouldOverwrite || p5.isCancel(shouldOverwrite)) {
+      p5.cancel("Operation cancelled.");
       process.exit(0);
     }
   }