create-velocity-astro 1.0.0

package/README.md

@@ -0,0 +1,79 @@
+# create-velocity-astro
+
+Scaffold production-ready [Velocity](https://github.com/southwell-media/velocity) projects in seconds.
+
+Velocity is an opinionated Astro 6 + Tailwind CSS v4 starter kit used by Southwell Media to deliver production client sites.
+
+## Usage
+
+```bash
+# npm
+npm create velocity-astro@latest my-site
+
+# pnpm
+pnpm create velocity-astro my-site
+
+# yarn
+yarn create velocity-astro my-site
+
+# bun
+bun create velocity-astro my-site
+```
+
+## Options
+
+| Flag | Description |
+|------|-------------|
+| `--i18n` | Add internationalization support with locale routing |
+| `--yes`, `-y` | Skip prompts and use default options |
+| `--help`, `-h` | Show help message |
+| `--version`, `-v` | Show version number |
+
+## Examples
+
+### Create a basic project
+
+```bash
+npm create velocity-astro@latest my-site
+```
+
+### Create a project with i18n support
+
+```bash
+npm create velocity-astro@latest my-site --i18n
+```
+
+This adds:
+- Locale routing (`/en`, `/es`, `/fr`)
+- Translation utilities with type-safe keys
+- Language switcher component
+- SEO hreflang tags
+
+### Skip prompts with defaults
+
+```bash
+npm create velocity-astro@latest my-site -y
+```
+
+## What's Included
+
+Every Velocity project comes with:
+
+- **Astro 6** - The web framework for content-driven websites
+- **Tailwind CSS v4** - Utility-first CSS framework
+- **TypeScript** - Type safety out of the box
+- **React** - For interactive islands
+- **MDX** - Write content with JSX components
+- **SEO** - Meta tags, Open Graph, JSON-LD schemas
+- **Sitemap** - Auto-generated sitemap.xml
+- **ESLint + Prettier** - Code quality and formatting
+- **Deployment configs** - Vercel, Netlify, Cloudflare ready
+
+## Requirements
+
+- Node.js 18.0.0 or higher
+- pnpm, npm, yarn, or bun
+
+## License
+
+MIT - Southwell Media

package/dist/index.d.ts

@@ -0,0 +1,2 @@
+
+export {  }

package/dist/index.js

@@ -0,0 +1,417 @@
+#!/usr/bin/env node
+
+// src/cli.ts
+import mri from "mri";
+import { resolve as resolve2 } from "path";
+import { existsSync as existsSync4 } from "fs";
+import * as p3 from "@clack/prompts";
+import pc2 from "picocolors";
+
+// src/prompts.ts
+import * as p from "@clack/prompts";
+import pc from "picocolors";
+
+// src/utils/validate.ts
+function validateProjectName(name) {
+  if (!name || name.trim() === "") {
+    return { valid: false, message: "Project name cannot be empty" };
+  }
+  if (name !== name.toLowerCase()) {
+    return { valid: false, message: "Project name must be lowercase" };
+  }
+  if (name.startsWith(".") || name.startsWith("_")) {
+    return { valid: false, message: "Project name cannot start with . or _" };
+  }
+  if (/\s/.test(name)) {
+    return { valid: false, message: "Project name cannot contain spaces" };
+  }
+  if (!/^(@[a-z0-9-~][a-z0-9-._~]*\/)?[a-z0-9-~][a-z0-9-._~]*$/.test(name)) {
+    return {
+      valid: false,
+      message: "Project name can only contain lowercase letters, numbers, hyphens, and underscores"
+    };
+  }
+  if (name.length > 214) {
+    return { valid: false, message: "Project name must be 214 characters or fewer" };
+  }
+  return { valid: true };
+}
+function toValidProjectName(name) {
+  return name.trim().toLowerCase().replace(/\s+/g, "-").replace(/[^a-z0-9-_~.]/g, "-").replace(/^[-._]+/, "").replace(/[-._]+$/, "").replace(/-+/g, "-");
+}
+
+// src/utils/package-manager.ts
+function detectPackageManager() {
+  const userAgent = process.env.npm_config_user_agent || "";
+  if (userAgent.startsWith("pnpm")) return "pnpm";
+  if (userAgent.startsWith("yarn")) return "yarn";
+  if (userAgent.startsWith("bun")) return "bun";
+  return "npm";
+}
+function getInstallCommand(pm) {
+  switch (pm) {
+    case "pnpm":
+      return "pnpm install";
+    case "yarn":
+      return "yarn";
+    case "bun":
+      return "bun install";
+    case "npm":
+    default:
+      return "npm install";
+  }
+}
+
+// src/prompts.ts
+async function runPrompts(defaultProjectName, defaultI18n) {
+  const detectedPm = detectPackageManager();
+  const answers = await p.group(
+    {
+      projectName: () => p.text({
+        message: "What is your project name?",
+        placeholder: defaultProjectName || "my-velocity-site",
+        defaultValue: defaultProjectName,
+        validate: (value) => {
+          const name = value || defaultProjectName || "my-velocity-site";
+          const result = validateProjectName(toValidProjectName(name));
+          if (!result.valid) return result.message;
+        }
+      }),
+      i18n: defaultI18n !== void 0 ? () => Promise.resolve(defaultI18n) : () => p.select({
+        message: "Add internationalization (i18n)?",
+        options: [
+          {
+            value: false,
+            label: "No",
+            hint: "English only (default)"
+          },
+          {
+            value: true,
+            label: "Yes",
+            hint: "Locale routing, translations"
+          }
+        ],
+        initialValue: false
+      }),
+      packageManager: () => p.select({
+        message: "Which package manager?",
+        options: [
+          {
+            value: "pnpm",
+            label: "pnpm",
+            hint: detectedPm === "pnpm" ? "detected" : "recommended"
+          },
+          {
+            value: "npm",
+            label: "npm",
+            hint: detectedPm === "npm" ? "detected" : void 0
+          },
+          {
+            value: "yarn",
+            label: "yarn",
+            hint: detectedPm === "yarn" ? "detected" : void 0
+          },
+          {
+            value: "bun",
+            label: "bun",
+            hint: detectedPm === "bun" ? "detected" : void 0
+          }
+        ],
+        initialValue: detectedPm
+      })
+    },
+    {
+      onCancel: () => {
+        p.cancel("Operation cancelled.");
+        process.exit(0);
+      }
+    }
+  );
+  return {
+    projectName: toValidProjectName(answers.projectName || defaultProjectName || "my-velocity-site"),
+    i18n: answers.i18n,
+    packageManager: answers.packageManager
+  };
+}
+function showIntro() {
+  console.log();
+  p.intro(pc.bgCyan(pc.black(" Create Velocity ")));
+}
+function showOutro(projectName, packageManager) {
+  const runCmd = packageManager === "npm" ? "npm run" : packageManager;
+  p.note(
+    [
+      `cd ${projectName}`,
+      `${runCmd} dev`
+    ].join("\n"),
+    "Next steps"
+  );
+  p.outro(pc.green("Happy building!"));
+}
+function showError(message) {
+  p.log.error(pc.red(message));
+}
+function showWarning(message) {
+  p.log.warn(pc.yellow(message));
+}
+function showSuccess(message) {
+  p.log.success(pc.green(message));
+}
+
+// src/scaffold.ts
+import { existsSync as existsSync2, mkdirSync, readdirSync, copyFileSync, readFileSync, writeFileSync } from "fs";
+import { join, relative } from "path";
+import * as p2 from "@clack/prompts";
+import { execa as execa2 } from "execa";
+
+// src/template.ts
+import { existsSync } from "fs";
+import { resolve, dirname } from "path";
+import { fileURLToPath } from "url";
+var __dirname2 = dirname(fileURLToPath(import.meta.url));
+var TEMPLATE_IGNORE = [
+  "node_modules",
+  ".git",
+  "dist",
+  ".astro",
+  ".vercel",
+  ".netlify",
+  ".wrangler",
+  "pnpm-lock.yaml",
+  "package-lock.json",
+  "yarn.lock",
+  "bun.lockb",
+  "packages",
+  "pnpm-workspace.yaml",
+  ".claude",
+  ".playwright-mcp",
+  "southwell-astro-boilerplate-docs.md",
+  "southwell-astro-boilerplate-prd.md",
+  "nul"
+];
+function getBaseTemplatePath() {
+  const monorepoRoot = resolve(__dirname2, "..", "..", "..");
+  if (existsSync(resolve(monorepoRoot, "astro.config.mjs"))) {
+    return monorepoRoot;
+  }
+  const packageTemplate = resolve(__dirname2, "..", "templates", "base");
+  if (existsSync(packageTemplate)) {
+    return packageTemplate;
+  }
+  throw new Error(
+    "Could not find base template. Please ensure you are running from the Velocity monorepo."
+  );
+}
+function getI18nTemplatePath() {
+  const templatePath = resolve(__dirname2, "..", "templates", "i18n");
+  if (existsSync(templatePath)) {
+    return templatePath;
+  }
+  throw new Error("Could not find i18n template. Package may be corrupted.");
+}
+
+// src/utils/git.ts
+import { execa } from "execa";
+async function initGit(targetDir) {
+  try {
+    await execa("git", ["init"], { cwd: targetDir });
+    await execa("git", ["add", "-A"], { cwd: targetDir });
+    await execa("git", ["commit", "-m", "Initial commit from create-velocity"], {
+      cwd: targetDir
+    });
+    return true;
+  } catch {
+    return false;
+  }
+}
+
+// src/scaffold.ts
+function copyTemplateFiles(src, dest, ignore) {
+  if (!existsSync2(dest)) {
+    mkdirSync(dest, { recursive: true });
+  }
+  const entries = readdirSync(src, { withFileTypes: true });
+  for (const entry of entries) {
+    if (ignore.includes(entry.name)) continue;
+    const srcPath = join(src, entry.name);
+    const destPath = join(dest, entry.name);
+    if (entry.isDirectory()) {
+      copyTemplateFiles(srcPath, destPath, ignore);
+    } else {
+      const destDir = join(dest, relative(src, srcPath).split("/").slice(0, -1).join("/"));
+      if (destDir && !existsSync2(destDir)) {
+        mkdirSync(destDir, { recursive: true });
+      }
+      copyFileSync(srcPath, destPath);
+    }
+  }
+}
+function updatePackageJson(targetDir, projectName) {
+  const pkgPath = join(targetDir, "package.json");
+  if (!existsSync2(pkgPath)) {
+    throw new Error("package.json not found in template");
+  }
+  const pkg = JSON.parse(readFileSync(pkgPath, "utf-8"));
+  pkg.name = projectName;
+  pkg.version = "0.1.0";
+  delete pkg.repository;
+  delete pkg.bugs;
+  delete pkg.homepage;
+  writeFileSync(pkgPath, JSON.stringify(pkg, null, 2) + "\n");
+}
+function applyI18nOverlay(targetDir) {
+  const i18nTemplate = getI18nTemplatePath();
+  copyTemplateFiles(i18nTemplate, targetDir, []);
+}
+async function scaffold(options) {
+  const { projectName, targetDir, i18n, packageManager } = options;
+  const spinner2 = p2.spinner();
+  spinner2.start("Copying template files...");
+  try {
+    const baseTemplate = getBaseTemplatePath();
+    copyTemplateFiles(baseTemplate, targetDir, TEMPLATE_IGNORE);
+    spinner2.stop("Template files copied");
+  } catch (error) {
+    spinner2.stop("Failed to copy template");
+    throw error;
+  }
+  if (i18n) {
+    spinner2.start("Adding i18n support...");
+    try {
+      applyI18nOverlay(targetDir);
+      spinner2.stop("i18n support added");
+    } catch (error) {
+      spinner2.stop("Failed to add i18n support");
+      throw error;
+    }
+  }
+  spinner2.start("Configuring project...");
+  try {
+    updatePackageJson(targetDir, projectName);
+    spinner2.stop("Project configured");
+  } catch (error) {
+    spinner2.stop("Failed to configure project");
+    throw error;
+  }
+  spinner2.start("Initializing git repository...");
+  const gitInitialized = await initGit(targetDir);
+  if (gitInitialized) {
+    spinner2.stop("Git repository initialized");
+  } else {
+    spinner2.stop("Git not available, skipping");
+  }
+  spinner2.start(`Installing dependencies with ${packageManager}...`);
+  try {
+    const installCmd = getInstallCommand(packageManager);
+    const [cmd, ...args] = installCmd.split(" ");
+    await execa2(cmd, args, { cwd: targetDir });
+    spinner2.stop("Dependencies installed");
+  } catch (error) {
+    spinner2.stop("Failed to install dependencies");
+    showWarning(`Run "${getInstallCommand(packageManager)}" manually to install dependencies`);
+  }
+  showSuccess(`Project "${projectName}" created successfully!`);
+}
+
+// src/utils/fs.ts
+import { existsSync as existsSync3, mkdirSync as mkdirSync2, readdirSync as readdirSync2, statSync, copyFileSync as copyFileSync2, 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 = readdirSync2(path);
+  return files.length === 0 || files.length === 1 && files[0] === ".git";
+}
+
+// src/cli.ts
+var HELP_TEXT = `
+${pc2.bold("create-velocity-astro")} - Create a new Velocity project
+
+${pc2.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]
+
+${pc2.bold("Options:")}
+  --i18n          Add internationalization support
+  --yes, -y       Skip prompts and use defaults
+  --help, -h      Show this help message
+  --version, -v   Show version number
+
+${pc2.bold("Examples:")}
+  npm create velocity-astro@latest my-site
+  npm create velocity-astro@latest my-site --i18n
+  pnpm create velocity-astro my-site -y
+`;
+var VERSION = "1.0.0";
+async function run(argv) {
+  const args = mri(argv, {
+    boolean: ["i18n", "help", "version", "yes"],
+    alias: {
+      h: "help",
+      v: "version",
+      y: "yes"
+    }
+  });
+  if (args.help) {
+    console.log(HELP_TEXT);
+    return;
+  }
+  if (args.version) {
+    console.log(VERSION);
+    return;
+  }
+  showIntro();
+  const argProjectName = args._[0];
+  if (args.yes) {
+    const projectName2 = toValidProjectName(argProjectName || "my-velocity-site");
+    const targetDir2 = resolve2(process.cwd(), projectName2);
+    if (existsSync4(targetDir2) && !isEmptyDir(targetDir2)) {
+      showError(`Directory "${projectName2}" already exists and is not empty.`);
+      process.exit(1);
+    }
+    await scaffold({
+      projectName: projectName2,
+      targetDir: targetDir2,
+      i18n: args.i18n || false,
+      packageManager: "pnpm"
+    });
+    showOutro(projectName2, "pnpm");
+    return;
+  }
+  const answers = await runPrompts(argProjectName, args.i18n);
+  if (typeof answers === "symbol") {
+    return;
+  }
+  const { projectName, i18n, packageManager } = answers;
+  const targetDir = resolve2(process.cwd(), projectName);
+  if (existsSync4(targetDir) && !isEmptyDir(targetDir)) {
+    const shouldOverwrite = await p3.confirm({
+      message: `Directory "${projectName}" already exists. Continue and overwrite?`,
+      initialValue: false
+    });
+    if (!shouldOverwrite || p3.isCancel(shouldOverwrite)) {
+      p3.cancel("Operation cancelled.");
+      process.exit(0);
+    }
+  }
+  try {
+    await scaffold({
+      projectName,
+      targetDir,
+      i18n,
+      packageManager
+    });
+    showOutro(projectName, packageManager);
+  } catch (error) {
+    showError(error instanceof Error ? error.message : "An unexpected error occurred");
+    process.exit(1);
+  }
+}
+
+// src/index.ts
+run(process.argv.slice(2)).catch((error) => {
+  console.error(error);
+  process.exit(1);
+});
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/cli.ts","../src/prompts.ts","../src/utils/validate.ts","../src/utils/package-manager.ts","../src/scaffold.ts","../src/template.ts","../src/utils/git.ts","../src/utils/fs.ts","../src/index.ts"],"sourcesContent":["import mri from 'mri';\nimport { resolve } from 'node:path';\nimport { existsSync } from 'node:fs';\nimport * as p from '@clack/prompts';\nimport pc from 'picocolors';\nimport type { CliOptions } from './types.js';\nimport { runPrompts, showIntro, showOutro, showError } from './prompts.js';\nimport { scaffold } from './scaffold.js';\nimport { isEmptyDir } from './utils/fs.js';\nimport { toValidProjectName } from './utils/validate.js';\n\nconst HELP_TEXT = `\n${pc.bold('create-velocity-astro')} - Create a new Velocity project\n\n${pc.bold('Usage:')}\n  npm create velocity-astro@latest [project-name] [options]\n  pnpm create velocity-astro [project-name] [options]\n  yarn create velocity-astro [project-name] [options]\n  bun create velocity-astro [project-name] [options]\n\n${pc.bold('Options:')}\n  --i18n          Add internationalization support\n  --yes, -y       Skip prompts and use defaults\n  --help, -h      Show this help message\n  --version, -v   Show version number\n\n${pc.bold('Examples:')}\n  npm create velocity-astro@latest my-site\n  npm create velocity-astro@latest my-site --i18n\n  pnpm create velocity-astro my-site -y\n`;\n\nconst VERSION = '1.0.0';\n\nexport async function run(argv: string[]): Promise<void> {\n  const args = mri<CliOptions>(argv, {\n    boolean: ['i18n', 'help', 'version', 'yes'],\n    alias: {\n      h: 'help',\n      v: 'version',\n      y: 'yes',\n    },\n  });\n\n  // Handle help\n  if (args.help) {\n    console.log(HELP_TEXT);\n    return;\n  }\n\n  // Handle version\n  if (args.version) {\n    console.log(VERSION);\n    return;\n  }\n\n  showIntro();\n\n  // Get project name from args or prompt\n  const argProjectName = args._[0] as string | undefined;\n\n  // Skip prompts mode\n  if (args.yes) {\n    const projectName = toValidProjectName(argProjectName || 'my-velocity-site');\n    const targetDir = resolve(process.cwd(), projectName);\n\n    if (existsSync(targetDir) && !isEmptyDir(targetDir)) {\n      showError(`Directory \"${projectName}\" already exists and is not empty.`);\n      process.exit(1);\n    }\n\n    await scaffold({\n      projectName,\n      targetDir,\n      i18n: args.i18n || false,\n      packageManager: 'pnpm',\n    });\n\n    showOutro(projectName, 'pnpm');\n    return;\n  }\n\n  // Interactive mode\n  const answers = await runPrompts(argProjectName, args.i18n);\n\n  // User cancelled\n  if (typeof answers === 'symbol') {\n    return;\n  }\n\n  const { projectName, i18n, packageManager } = answers;\n  const targetDir = resolve(process.cwd(), projectName);\n\n  // Check if directory exists and is not empty\n  if (existsSync(targetDir) && !isEmptyDir(targetDir)) {\n    const shouldOverwrite = await p.confirm({\n      message: `Directory \"${projectName}\" already exists. Continue and overwrite?`,\n      initialValue: false,\n    });\n\n    if (!shouldOverwrite || p.isCancel(shouldOverwrite)) {\n      p.cancel('Operation cancelled.');\n      process.exit(0);\n    }\n  }\n\n  // Run scaffold\n  try {\n    await scaffold({\n      projectName,\n      targetDir,\n      i18n,\n      packageManager,\n    });\n\n    showOutro(projectName, packageManager);\n  } catch (error) {\n    showError(error instanceof Error ? error.message : 'An unexpected error occurred');\n    process.exit(1);\n  }\n}\n","import * as p from '@clack/prompts';\nimport pc from 'picocolors';\nimport type { PackageManager, PromptAnswers } from './types.js';\nimport { validateProjectName, toValidProjectName } from './utils/validate.js';\nimport { detectPackageManager } from './utils/package-manager.js';\n\nexport async function runPrompts(\n  defaultProjectName?: string,\n  defaultI18n?: boolean\n): Promise<PromptAnswers | symbol> {\n  const detectedPm = detectPackageManager();\n\n  const answers = await p.group(\n    {\n      projectName: () =>\n        p.text({\n          message: 'What is your project name?',\n          placeholder: defaultProjectName || 'my-velocity-site',\n          defaultValue: defaultProjectName,\n          validate: (value) => {\n            const name = value || defaultProjectName || 'my-velocity-site';\n            const result = validateProjectName(toValidProjectName(name));\n            if (!result.valid) return result.message;\n          },\n        }),\n\n      i18n:\n        defaultI18n !== undefined\n          ? () => Promise.resolve(defaultI18n)\n          : () =>\n              p.select({\n                message: 'Add internationalization (i18n)?',\n                options: [\n                  {\n                    value: false,\n                    label: 'No',\n                    hint: 'English only (default)',\n                  },\n                  {\n                    value: true,\n                    label: 'Yes',\n                    hint: 'Locale routing, translations',\n                  },\n                ],\n                initialValue: false,\n              }),\n\n      packageManager: () =>\n        p.select({\n          message: 'Which package manager?',\n          options: [\n            {\n              value: 'pnpm' as PackageManager,\n              label: 'pnpm',\n              hint: detectedPm === 'pnpm' ? 'detected' : 'recommended',\n            },\n            {\n              value: 'npm' as PackageManager,\n              label: 'npm',\n              hint: detectedPm === 'npm' ? 'detected' : undefined,\n            },\n            {\n              value: 'yarn' as PackageManager,\n              label: 'yarn',\n              hint: detectedPm === 'yarn' ? 'detected' : undefined,\n            },\n            {\n              value: 'bun' as PackageManager,\n              label: 'bun',\n              hint: detectedPm === 'bun' ? 'detected' : undefined,\n            },\n          ],\n          initialValue: detectedPm,\n        }),\n    },\n    {\n      onCancel: () => {\n        p.cancel('Operation cancelled.');\n        process.exit(0);\n      },\n    }\n  );\n\n  return {\n    projectName: toValidProjectName(answers.projectName || defaultProjectName || 'my-velocity-site'),\n    i18n: answers.i18n as boolean,\n    packageManager: answers.packageManager as PackageManager,\n  };\n}\n\nexport function showIntro(): void {\n  console.log();\n  p.intro(pc.bgCyan(pc.black(' Create Velocity ')));\n}\n\nexport function showOutro(projectName: string, packageManager: PackageManager): void {\n  const runCmd = packageManager === 'npm' ? 'npm run' : packageManager;\n\n  p.note(\n    [\n      `cd ${projectName}`,\n      `${runCmd} dev`,\n    ].join('\\n'),\n    'Next steps'\n  );\n\n  p.outro(pc.green('Happy building!'));\n}\n\nexport function showError(message: string): void {\n  p.log.error(pc.red(message));\n}\n\nexport function showWarning(message: string): void {\n  p.log.warn(pc.yellow(message));\n}\n\nexport function showSuccess(message: string): void {\n  p.log.success(pc.green(message));\n}\n\nexport function showStep(message: string): void {\n  p.log.step(message);\n}\n","/**\n * Validates a project name for npm package naming conventions\n */\nexport function validateProjectName(name: string): { valid: boolean; message?: string } {\n  if (!name || name.trim() === '') {\n    return { valid: false, message: 'Project name cannot be empty' };\n  }\n\n  // Must be lowercase\n  if (name !== name.toLowerCase()) {\n    return { valid: false, message: 'Project name must be lowercase' };\n  }\n\n  // Cannot start with . or _\n  if (name.startsWith('.') || name.startsWith('_')) {\n    return { valid: false, message: 'Project name cannot start with . or _' };\n  }\n\n  // Cannot contain spaces\n  if (/\\s/.test(name)) {\n    return { valid: false, message: 'Project name cannot contain spaces' };\n  }\n\n  // Cannot contain special characters except - and @/\n  if (!/^(@[a-z0-9-~][a-z0-9-._~]*\\/)?[a-z0-9-~][a-z0-9-._~]*$/.test(name)) {\n    return {\n      valid: false,\n      message: 'Project name can only contain lowercase letters, numbers, hyphens, and underscores',\n    };\n  }\n\n  // Length check\n  if (name.length > 214) {\n    return { valid: false, message: 'Project name must be 214 characters or fewer' };\n  }\n\n  return { valid: true };\n}\n\n/**\n * Sanitizes a string to be a valid project name\n */\nexport function toValidProjectName(name: string): string {\n  return name\n    .trim()\n    .toLowerCase()\n    .replace(/\\s+/g, '-')\n    .replace(/[^a-z0-9-_~.]/g, '-')\n    .replace(/^[-._]+/, '')\n    .replace(/[-._]+$/, '')\n    .replace(/-+/g, '-');\n}\n","import type { PackageManager } from '../types.js';\n\n/**\n * Detects the package manager used to run this command\n */\nexport function detectPackageManager(): PackageManager {\n  const userAgent = process.env.npm_config_user_agent || '';\n\n  if (userAgent.startsWith('pnpm')) return 'pnpm';\n  if (userAgent.startsWith('yarn')) return 'yarn';\n  if (userAgent.startsWith('bun')) return 'bun';\n  return 'npm';\n}\n\n/**\n * Gets the install command for a package manager\n */\nexport function getInstallCommand(pm: PackageManager): string {\n  switch (pm) {\n    case 'pnpm':\n      return 'pnpm install';\n    case 'yarn':\n      return 'yarn';\n    case 'bun':\n      return 'bun install';\n    case 'npm':\n    default:\n      return 'npm install';\n  }\n}\n\n/**\n * Gets the run command for a package manager\n */\nexport function getRunCommand(pm: PackageManager): string {\n  switch (pm) {\n    case 'pnpm':\n      return 'pnpm';\n    case 'yarn':\n      return 'yarn';\n    case 'bun':\n      return 'bun';\n    case 'npm':\n    default:\n      return 'npm run';\n  }\n}\n","import { existsSync, mkdirSync, readdirSync, copyFileSync, readFileSync, writeFileSync } from 'node:fs';\nimport { join, relative } from 'node:path';\nimport * as p from '@clack/prompts';\nimport { execa } from 'execa';\nimport type { ScaffoldOptions } from './types.js';\nimport { getBaseTemplatePath, getI18nTemplatePath, TEMPLATE_IGNORE } from './template.js';\nimport { getInstallCommand } from './utils/package-manager.js';\nimport { initGit } from './utils/git.js';\nimport { showSuccess, showWarning } from './prompts.js';\n\n/**\n * Copies template files recursively, excluding ignored paths\n */\nfunction copyTemplateFiles(src: string, dest: string, ignore: string[]): void {\n  if (!existsSync(dest)) {\n    mkdirSync(dest, { recursive: true });\n  }\n\n  const entries = readdirSync(src, { withFileTypes: true });\n\n  for (const entry of entries) {\n    if (ignore.includes(entry.name)) continue;\n\n    const srcPath = join(src, entry.name);\n    const destPath = join(dest, entry.name);\n\n    if (entry.isDirectory()) {\n      copyTemplateFiles(srcPath, destPath, ignore);\n    } else {\n      const destDir = join(dest, relative(src, srcPath).split('/').slice(0, -1).join('/'));\n      if (destDir && !existsSync(destDir)) {\n        mkdirSync(destDir, { recursive: true });\n      }\n      copyFileSync(srcPath, destPath);\n    }\n  }\n}\n\n/**\n * Updates the package.json with the new project name\n */\nfunction updatePackageJson(targetDir: string, projectName: string): void {\n  const pkgPath = join(targetDir, 'package.json');\n\n  if (!existsSync(pkgPath)) {\n    throw new Error('package.json not found in template');\n  }\n\n  const pkg = JSON.parse(readFileSync(pkgPath, 'utf-8'));\n  pkg.name = projectName;\n  pkg.version = '0.1.0';\n  delete pkg.repository;\n  delete pkg.bugs;\n  delete pkg.homepage;\n\n  writeFileSync(pkgPath, JSON.stringify(pkg, null, 2) + '\\n');\n}\n\n/**\n * Applies the i18n overlay to the project\n */\nfunction applyI18nOverlay(targetDir: string): void {\n  const i18nTemplate = getI18nTemplatePath();\n  copyTemplateFiles(i18nTemplate, targetDir, []);\n}\n\n/**\n * Main scaffold function\n */\nexport async function scaffold(options: ScaffoldOptions): Promise<void> {\n  const { projectName, targetDir, i18n, packageManager } = options;\n  const spinner = p.spinner();\n\n  // Step 1: Copy base template\n  spinner.start('Copying template files...');\n\n  try {\n    const baseTemplate = getBaseTemplatePath();\n    copyTemplateFiles(baseTemplate, targetDir, TEMPLATE_IGNORE);\n    spinner.stop('Template files copied');\n  } catch (error) {\n    spinner.stop('Failed to copy template');\n    throw error;\n  }\n\n  // Step 2: Apply i18n overlay if requested\n  if (i18n) {\n    spinner.start('Adding i18n support...');\n    try {\n      applyI18nOverlay(targetDir);\n      spinner.stop('i18n support added');\n    } catch (error) {\n      spinner.stop('Failed to add i18n support');\n      throw error;\n    }\n  }\n\n  // Step 3: Update package.json\n  spinner.start('Configuring project...');\n  try {\n    updatePackageJson(targetDir, projectName);\n    spinner.stop('Project configured');\n  } catch (error) {\n    spinner.stop('Failed to configure project');\n    throw error;\n  }\n\n  // Step 4: Initialize git\n  spinner.start('Initializing git repository...');\n  const gitInitialized = await initGit(targetDir);\n  if (gitInitialized) {\n    spinner.stop('Git repository initialized');\n  } else {\n    spinner.stop('Git not available, skipping');\n  }\n\n  // Step 5: Install dependencies\n  spinner.start(`Installing dependencies with ${packageManager}...`);\n  try {\n    const installCmd = getInstallCommand(packageManager);\n    const [cmd, ...args] = installCmd.split(' ');\n    await execa(cmd!, args, { cwd: targetDir });\n    spinner.stop('Dependencies installed');\n  } catch (error) {\n    spinner.stop('Failed to install dependencies');\n    showWarning(`Run \"${getInstallCommand(packageManager)}\" manually to install dependencies`);\n  }\n\n  showSuccess(`Project \"${projectName}\" created successfully!`);\n}\n","import { existsSync } from 'node:fs';\nimport { resolve, dirname } from 'node:path';\nimport { fileURLToPath } from 'node:url';\n\nconst __dirname = dirname(fileURLToPath(import.meta.url));\n\n/**\n * Files and directories to exclude when copying the base template\n */\nexport const TEMPLATE_IGNORE = [\n  'node_modules',\n  '.git',\n  'dist',\n  '.astro',\n  '.vercel',\n  '.netlify',\n  '.wrangler',\n  'pnpm-lock.yaml',\n  'package-lock.json',\n  'yarn.lock',\n  'bun.lockb',\n  'packages',\n  'pnpm-workspace.yaml',\n  '.claude',\n  '.playwright-mcp',\n  'southwell-astro-boilerplate-docs.md',\n  'southwell-astro-boilerplate-prd.md',\n  'nul',\n];\n\n/**\n * Resolves the path to the base template (velocity root)\n * In development, this is the parent repo\n * In production (published package), the template is bundled\n */\nexport function getBaseTemplatePath(): string {\n  // When running from the CLI package in the monorepo\n  // Go up from packages/create-velocity/dist to the repo root\n  const monorepoRoot = resolve(__dirname, '..', '..', '..');\n\n  if (existsSync(resolve(monorepoRoot, 'astro.config.mjs'))) {\n    return monorepoRoot;\n  }\n\n  // Fallback: look for template in the package\n  const packageTemplate = resolve(__dirname, '..', 'templates', 'base');\n  if (existsSync(packageTemplate)) {\n    return packageTemplate;\n  }\n\n  throw new Error(\n    'Could not find base template. Please ensure you are running from the Velocity monorepo.'\n  );\n}\n\n/**\n * Resolves the path to the i18n overlay template\n */\nexport function getI18nTemplatePath(): string {\n  // In the package templates directory\n  const templatePath = resolve(__dirname, '..', 'templates', 'i18n');\n\n  if (existsSync(templatePath)) {\n    return templatePath;\n  }\n\n  throw new Error('Could not find i18n template. Package may be corrupted.');\n}\n","import { execa } from 'execa';\n\n/**\n * Initializes a git repository in the target directory\n */\nexport async function initGit(targetDir: string): Promise<boolean> {\n  try {\n    await execa('git', ['init'], { cwd: targetDir });\n    await execa('git', ['add', '-A'], { cwd: targetDir });\n    await execa('git', ['commit', '-m', 'Initial commit from create-velocity'], {\n      cwd: targetDir,\n    });\n    return true;\n  } catch {\n    // Git may not be installed or configured\n    return false;\n  }\n}\n\n/**\n * Checks if git is available\n */\nexport async function isGitInstalled(): Promise<boolean> {\n  try {\n    await execa('git', ['--version']);\n    return true;\n  } catch {\n    return false;\n  }\n}\n","import { existsSync, mkdirSync, readdirSync, statSync, copyFileSync, readFileSync, writeFileSync } from 'node:fs';\nimport { join, dirname } from 'node:path';\n\n/**\n * Recursively copies a directory\n */\nexport function copyDirectory(src: string, dest: string, overwrite = false): void {\n  if (!existsSync(src)) {\n    throw new Error(`Source directory does not exist: ${src}`);\n  }\n\n  if (!existsSync(dest)) {\n    mkdirSync(dest, { recursive: true });\n  }\n\n  const entries = readdirSync(src, { withFileTypes: true });\n\n  for (const entry of entries) {\n    const srcPath = join(src, entry.name);\n    const destPath = join(dest, entry.name);\n\n    if (entry.isDirectory()) {\n      copyDirectory(srcPath, destPath, overwrite);\n    } else {\n      if (overwrite || !existsSync(destPath)) {\n        const destDir = dirname(destPath);\n        if (!existsSync(destDir)) {\n          mkdirSync(destDir, { recursive: true });\n        }\n        copyFileSync(srcPath, destPath);\n      }\n    }\n  }\n}\n\n/**\n * Checks if a directory is empty\n */\nexport function isEmptyDir(path: string): boolean {\n  if (!existsSync(path)) return true;\n  const files = readdirSync(path);\n  return files.length === 0 || (files.length === 1 && files[0] === '.git');\n}\n\n/**\n * Reads a JSON file and parses it\n */\nexport function readJson<T = Record<string, unknown>>(path: string): T {\n  const content = readFileSync(path, 'utf-8');\n  return JSON.parse(content) as T;\n}\n\n/**\n * Writes an object as JSON to a file\n */\nexport function writeJson(path: string, data: unknown): void {\n  writeFileSync(path, JSON.stringify(data, null, 2) + '\\n');\n}\n\n/**\n * Checks if path exists and is a directory\n */\nexport function isDirectory(path: string): boolean {\n  return existsSync(path) && statSync(path).isDirectory();\n}\n","import { run } from './cli.js';\n\nrun(process.argv.slice(2)).catch((error) => {\n  console.error(error);\n  process.exit(1);\n});\n"],"mappings":"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","names":["resolve","existsSync","p","pc","existsSync","p","execa","__dirname","existsSync","spinner","execa","existsSync","mkdirSync","readdirSync","copyFileSync","readFileSync","writeFileSync","join","dirname","existsSync","readdirSync","pc","projectName","targetDir","resolve","existsSync"]}

package/package.json

@@ -0,0 +1,66 @@
+{
+  "name": "create-velocity-astro",
+  "version": "1.0.0",
+  "description": "Create Velocity - A CLI to scaffold production-ready Astro 6 + Tailwind v4 projects",
+  "type": "module",
+  "license": "MIT",
+  "author": "Southwell Media <info@southwellmedia.com>",
+  "homepage": "https://github.com/southwell-media/velocity#readme",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/southwell-media/velocity.git",
+    "directory": "packages/create-velocity"
+  },
+  "bugs": {
+    "url": "https://github.com/southwell-media/velocity/issues"
+  },
+  "keywords": [
+    "create",
+    "velocity",
+    "astro",
+    "tailwind",
+    "starter",
+    "template",
+    "boilerplate",
+    "cli",
+    "scaffold",
+    "i18n",
+    "internationalization"
+  ],
+  "bin": {
+    "create-velocity-astro": "./dist/index.js"
+  },
+  "files": [
+    "dist",
+    "templates"
+  ],
+  "exports": {
+    ".": {
+      "import": "./dist/index.js"
+    }
+  },
+  "scripts": {
+    "build": "tsup",
+    "dev": "tsup --watch",
+    "start": "node dist/index.js",
+    "typecheck": "tsc --noEmit",
+    "test": "vitest",
+    "prepublishOnly": "npm run build"
+  },
+  "dependencies": {
+    "@clack/prompts": "^0.8.2",
+    "picocolors": "^1.1.1",
+    "mri": "^1.2.0",
+    "execa": "^9.5.2"
+  },
+  "devDependencies": {
+    "@types/mri": "^1.1.4",
+    "@types/node": "^22.10.0",
+    "tsup": "^8.3.5",
+    "typescript": "^5.7.0",
+    "vitest": "^2.1.0"
+  },
+  "engines": {
+    "node": ">=18.0.0"
+  }
+}

package/templates/i18n/astro.config.mjs

@@ -0,0 +1,57 @@
+import { defineConfig } from 'astro/config';
+import mdx from '@astrojs/mdx';
+import sitemap from '@astrojs/sitemap';
+import react from '@astrojs/react';
+import tailwindcss from '@tailwindcss/vite';
+
+export default defineConfig({
+  site: process.env.SITE_URL || 'https://example.com',
+
+  // i18n configuration
+  i18n: {
+    defaultLocale: 'en',
+    locales: ['en', 'es', 'fr'],
+    routing: {
+      prefixDefaultLocale: false,
+    },
+  },
+
+  integrations: [
+    react(),
+    mdx(),
+    sitemap({
+      i18n: {
+        defaultLocale: 'en',
+        locales: {
+          en: 'en',
+          es: 'es',
+          fr: 'fr',
+        },
+      },
+    }),
+  ],
+
+  vite: {
+    plugins: [tailwindcss()],
+  },
+
+  security: {
+    checkOrigin: true,
+  },
+
+  experimental: {
+    contentIntellisense: true,
+  },
+
+  markdown: {
+    shikiConfig: {
+      theme: 'github-dark',
+      wrap: true,
+    },
+  },
+
+  prefetch: {
+    prefetchAll: true,
+    defaultStrategy: 'viewport',
+  },
+});

package/templates/i18n/src/components/i18n/LanguageSwitcher.astro

@@ -0,0 +1,120 @@
+---
+/**
+ * Language Switcher Component
+ * Allows users to switch between available locales
+ */
+
+import { locales, localeNames, localeFlags, type Locale, localePath, getLocaleFromPath } from '@/i18n/config';
+
+interface Props {
+  class?: string;
+}
+
+const { class: className } = Astro.props;
+
+const currentPath = Astro.url.pathname;
+const currentLocale = getLocaleFromPath(currentPath);
+---
+
+<div class:list={['relative inline-block', className]}>
+  <button
+    type="button"
+    id="language-switcher-btn"
+    class="flex items-center gap-2 rounded-md border border-border bg-background px-3 py-2 text-sm font-medium text-foreground transition-colors hover:bg-muted focus:outline-none focus:ring-2 focus:ring-primary focus:ring-offset-2"
+    aria-expanded="false"
+    aria-haspopup="true"
+  >
+    <span class="text-base">{localeFlags[currentLocale]}</span>
+    <span>{localeNames[currentLocale]}</span>
+    <svg
+      class="h-4 w-4 transition-transform"
+      xmlns="http://www.w3.org/2000/svg"
+      viewBox="0 0 20 20"
+      fill="currentColor"
+      aria-hidden="true"
+    >
+      <path
+        fill-rule="evenodd"
+        d="M5.23 7.21a.75.75 0 011.06.02L10 11.168l3.71-3.938a.75.75 0 111.08 1.04l-4.25 4.5a.75.75 0 01-1.08 0l-4.25-4.5a.75.75 0 01.02-1.06z"
+        clip-rule="evenodd"></path>
+    </svg>
+  </button>
+
+  <div
+    id="language-switcher-menu"
+    class="absolute right-0 z-50 mt-2 hidden w-40 origin-top-right rounded-md border border-border bg-background shadow-lg ring-1 ring-black ring-opacity-5 focus:outline-none"
+    role="menu"
+    aria-orientation="vertical"
+    aria-labelledby="language-switcher-btn"
+  >
+    <div class="py-1" role="none">
+      {
+        locales.map((locale) => {
+          const isActive = locale === currentLocale;
+          const href = localePath(currentPath, locale);
+
+          return (
+            <a
+              href={href}
+              class:list={[
+                'flex items-center gap-2 px-4 py-2 text-sm transition-colors',
+                isActive
+                  ? 'bg-primary/10 text-primary font-medium'
+                  : 'text-foreground hover:bg-muted',
+              ]}
+              role="menuitem"
+              aria-current={isActive ? 'page' : undefined}
+            >
+              <span class="text-base">{localeFlags[locale]}</span>
+              <span>{localeNames[locale]}</span>
+              {isActive && (
+                <svg
+                  class="ml-auto h-4 w-4"
+                  xmlns="http://www.w3.org/2000/svg"
+                  viewBox="0 0 20 20"
+                  fill="currentColor"
+                >
+                  <path
+                    fill-rule="evenodd"
+                    d="M16.704 4.153a.75.75 0 01.143 1.052l-8 10.5a.75.75 0 01-1.127.075l-4.5-4.5a.75.75 0 011.06-1.06l3.894 3.893 7.48-9.817a.75.75 0 011.05-.143z"
+                    clip-rule="evenodd"
+                  />
+                </svg>
+              )}
+            </a>
+          );
+        })
+      }
+    </div>
+  </div>
+</div>
+
+<script>
+  const btn = document.getElementById('language-switcher-btn');
+  const menu = document.getElementById('language-switcher-menu');
+
+  if (btn && menu) {
+    // Toggle menu
+    btn.addEventListener('click', () => {
+      const isOpen = menu.classList.contains('hidden');
+      menu.classList.toggle('hidden', !isOpen);
+      btn.setAttribute('aria-expanded', String(isOpen));
+    });
+
+    // Close when clicking outside
+    document.addEventListener('click', (e) => {
+      if (!btn.contains(e.target as Node) && !menu.contains(e.target as Node)) {
+        menu.classList.add('hidden');
+        btn.setAttribute('aria-expanded', 'false');
+      }
+    });
+
+    // Close on escape
+    document.addEventListener('keydown', (e) => {
+      if (e.key === 'Escape') {
+        menu.classList.add('hidden');
+        btn.setAttribute('aria-expanded', 'false');
+      }
+    });
+  }
+</script>

package/templates/i18n/src/i18n/config.ts

@@ -0,0 +1,67 @@
+/**
+ * i18n Configuration
+ * Defines supported locales and default language settings
+ */
+
+export const locales = ['en', 'es', 'fr'] as const;
+export type Locale = (typeof locales)[number];
+
+export const defaultLocale: Locale = 'en';
+
+export const localeNames: Record<Locale, string> = {
+  en: 'English',
+  es: 'Español',
+  fr: 'Français',
+};
+
+export const localeFlags: Record<Locale, string> = {
+  en: '🇺🇸',
+  es: '🇪🇸',
+  fr: '🇫🇷',
+};
+
+/**
+ * Check if a string is a valid locale
+ */
+export function isValidLocale(locale: string): locale is Locale {
+  return locales.includes(locale as Locale);
+}
+
+/**
+ * Get locale from URL path
+ */
+export function getLocaleFromPath(path: string): Locale {
+  const segments = path.split('/').filter(Boolean);
+  const firstSegment = segments[0];
+
+  if (firstSegment && isValidLocale(firstSegment)) {
+    return firstSegment;
+  }
+
+  return defaultLocale;
+}
+
+/**
+ * Remove locale prefix from path
+ */
+export function removeLocaleFromPath(path: string): string {
+  const segments = path.split('/').filter(Boolean);
+  const firstSegment = segments[0];
+
+  if (firstSegment && isValidLocale(firstSegment)) {
+    return '/' + segments.slice(1).join('/');
+  }
+
+  return path;
+}
+
+/**
+ * Add locale prefix to path
+ */
+export function localePath(path: string, locale: Locale): string {
+  const cleanPath = removeLocaleFromPath(path);
+  if (locale === defaultLocale) {
+    return cleanPath || '/';
+  }
+  return `/${locale}${cleanPath}`;
+}

package/templates/i18n/src/i18n/index.ts

@@ -0,0 +1,85 @@
+/**
+ * i18n Utilities
+ * Translation functions and helpers
+ */
+
+import { type Locale, defaultLocale, locales } from './config';
+import { en } from './translations/en';
+import { es } from './translations/es';
+import { fr } from './translations/fr';
+
+// Translation map
+const translations = {
+  en,
+  es,
+  fr,
+} as const;
+
+type NestedKeyOf<T> = T extends object
+  ? {
+      [K in keyof T]: K extends string
+        ? T[K] extends object
+          ? `${K}.${NestedKeyOf<T[K]>}`
+          : K
+        : never;
+    }[keyof T]
+  : never;
+
+export type TranslationKey = NestedKeyOf<typeof en>;
+
+/**
+ * Get a nested value from an object using dot notation
+ */
+function getNestedValue(obj: Record<string, unknown>, path: string): string {
+  const keys = path.split('.');
+  let result: unknown = obj;
+
+  for (const key of keys) {
+    if (result && typeof result === 'object' && key in result) {
+      result = (result as Record<string, unknown>)[key];
+    } else {
+      return path; // Return the key if not found
+    }
+  }
+
+  return typeof result === 'string' ? result : path;
+}
+
+/**
+ * Get translation for a key
+ */
+export function t(
+  key: TranslationKey,
+  locale: Locale = defaultLocale,
+  params?: Record<string, string | number>
+): string {
+  const translation = translations[locale] || translations[defaultLocale];
+  let text = getNestedValue(translation as unknown as Record<string, unknown>, key);
+
+  // Replace parameters like {year}, {name}
+  if (params) {
+    Object.entries(params).forEach(([param, value]) => {
+      text = text.replace(new RegExp(`\\{${param}\\}`, 'g'), String(value));
+    });
+  }
+
+  return text;
+}
+
+/**
+ * Create a translation function bound to a specific locale
+ */
+export function useTranslations(locale: Locale) {
+  return (key: TranslationKey, params?: Record<string, string | number>) =>
+    t(key, locale, params);
+}
+
+/**
+ * Get all translations for a locale
+ */
+export function getTranslations(locale: Locale) {
+  return translations[locale] || translations[defaultLocale];
+}
+
+// Re-export config
+export { locales, defaultLocale, type Locale } from './config';

package/templates/i18n/src/i18n/translations/en.ts

@@ -0,0 +1,53 @@
+/**
+ * English translations
+ */
+export const en = {
+  // Site
+  site: {
+    name: 'Velocity',
+    description: 'A modern Astro starter template',
+  },
+
+  // Navigation
+  nav: {
+    home: 'Home',
+    about: 'About',
+    blog: 'Blog',
+    contact: 'Contact',
+  },
+
+  // Common
+  common: {
+    readMore: 'Read more',
+    loading: 'Loading...',
+    error: 'An error occurred',
+    notFound: 'Page not found',
+    backHome: 'Back to home',
+  },
+
+  // Home page
+  home: {
+    title: 'Welcome to Velocity',
+    subtitle: 'The opinionated Astro starter you actually want to use',
+    cta: 'Get Started',
+  },
+
+  // Footer
+  footer: {
+    copyright: '© {year} Velocity. All rights reserved.',
+    madeWith: 'Made with',
+  },
+
+  // Forms
+  form: {
+    name: 'Name',
+    email: 'Email',
+    message: 'Message',
+    submit: 'Submit',
+    sending: 'Sending...',
+    success: 'Message sent successfully!',
+    error: 'Failed to send message. Please try again.',
+  },
+} as const;
+
+export type TranslationKeys = typeof en;

package/templates/i18n/src/i18n/translations/es.ts

@@ -0,0 +1,53 @@
+import type { TranslationKeys } from './en';
+
+/**
+ * Spanish translations
+ */
+export const es: TranslationKeys = {
+  // Site
+  site: {
+    name: 'Velocity',
+    description: 'Una plantilla moderna de inicio con Astro',
+  },
+
+  // Navigation
+  nav: {
+    home: 'Inicio',
+    about: 'Acerca de',
+    blog: 'Blog',
+    contact: 'Contacto',
+  },
+
+  // Common
+  common: {
+    readMore: 'Leer más',
+    loading: 'Cargando...',
+    error: 'Ocurrió un error',
+    notFound: 'Página no encontrada',
+    backHome: 'Volver al inicio',
+  },
+
+  // Home page
+  home: {
+    title: 'Bienvenido a Velocity',
+    subtitle: 'El starter de Astro con opiniones que realmente quieres usar',
+    cta: 'Comenzar',
+  },
+
+  // Footer
+  footer: {
+    copyright: '© {year} Velocity. Todos los derechos reservados.',
+    madeWith: 'Hecho con',
+  },
+
+  // Forms
+  form: {
+    name: 'Nombre',
+    email: 'Correo electrónico',
+    message: 'Mensaje',
+    submit: 'Enviar',
+    sending: 'Enviando...',
+    success: '¡Mensaje enviado con éxito!',
+    error: 'Error al enviar el mensaje. Por favor, inténtalo de nuevo.',
+  },
+} as const;

package/templates/i18n/src/i18n/translations/fr.ts

@@ -0,0 +1,53 @@
+import type { TranslationKeys } from './en';
+
+/**
+ * French translations
+ */
+export const fr: TranslationKeys = {
+  // Site
+  site: {
+    name: 'Velocity',
+    description: 'Un template de démarrage Astro moderne',
+  },
+
+  // Navigation
+  nav: {
+    home: 'Accueil',
+    about: 'À propos',
+    blog: 'Blog',
+    contact: 'Contact',
+  },
+
+  // Common
+  common: {
+    readMore: 'Lire la suite',
+    loading: 'Chargement...',
+    error: 'Une erreur est survenue',
+    notFound: 'Page non trouvée',
+    backHome: "Retour à l'accueil",
+  },
+
+  // Home page
+  home: {
+    title: 'Bienvenue sur Velocity',
+    subtitle: "Le starter Astro opinioné que vous voulez vraiment utiliser",
+    cta: 'Commencer',
+  },
+
+  // Footer
+  footer: {
+    copyright: '© {year} Velocity. Tous droits réservés.',
+    madeWith: 'Fait avec',
+  },
+
+  // Forms
+  form: {
+    name: 'Nom',
+    email: 'E-mail',
+    message: 'Message',
+    submit: 'Envoyer',
+    sending: 'Envoi en cours...',
+    success: 'Message envoyé avec succès !',
+    error: "Échec de l'envoi du message. Veuillez réessayer.",
+  },
+} as const;

package/templates/i18n/src/layouts/BaseLayout.astro

@@ -0,0 +1,121 @@
+---
+import '@/styles/global.css';
+import SEO from '@/components/seo/SEO.astro';
+import JsonLd from '@/components/seo/JsonLd.astro';
+import { createWebsiteSchema, createOrganizationSchema } from '@/lib/schema';
+import type { WebSite, Organization, WithContext } from 'schema-dts';
+import siteConfig from '@/config/site.config';
+import { type Locale, defaultLocale, getLocaleFromPath } from '@/i18n/config';
+
+interface Props {
+  title?: string;
+  description?: string;
+  image?: string;
+  imageAlt?: string;
+  article?: {
+    publishedTime?: Date;
+    modifiedTime?: Date;
+    authors?: string[];
+    tags?: string[];
+  };
+  noindex?: boolean;
+  nofollow?: boolean;
+  includeOrgSchema?: boolean;
+  lang?: Locale;
+}
+
+const {
+  title,
+  description,
+  image,
+  imageAlt,
+  article,
+  noindex = false,
+  nofollow = false,
+  includeOrgSchema = false,
+  lang,
+} = Astro.props;
+
+// Get locale from props or URL path
+const currentLocale = lang || getLocaleFromPath(Astro.url.pathname);
+
+// Build JSON-LD schemas
+const schemas: Array<WithContext<WebSite> | WithContext<Organization>> = [createWebsiteSchema()];
+if (includeOrgSchema) {
+  schemas.push(createOrganizationSchema());
+}
+---
+
+<!doctype html>
+<html lang={currentLocale} class="scroll-smooth">
+  <head>
+    <meta charset="UTF-8" />
+    <meta name="viewport" content="width=device-width, initial-scale=1.0" />
+    <meta name="generator" content={Astro.generator} />
+
+    <!-- Velocity Fonts: Outfit (display), Manrope (body), JetBrains Mono (code) -->
+    <link rel="preconnect" href="https://fonts.googleapis.com" />
+    <link rel="preconnect" href="https://fonts.gstatic.com" crossorigin />
+    <link href="https://fonts.googleapis.com/css2?family=JetBrains+Mono:wght@400;500&family=Manrope:wght@400;500;600;700&family=Outfit:wght@400;500;600;700&display=swap" rel="stylesheet" />
+
+    <!-- Favicon -->
+    <link rel="icon" type="image/svg+xml" href="/favicon.svg" />
+    <link rel="apple-touch-icon" href="/apple-touch-icon.png" />
+    <link rel="manifest" href="/manifest.webmanifest" />
+
+    <!-- SEO -->
+    <SEO
+      title={title}
+      description={description}
+      image={image}
+      imageAlt={imageAlt}
+      article={article}
+      noindex={noindex}
+      nofollow={nofollow}
+    />
+
+    <!-- Canonical URL -->
+    <link rel="canonical" href={new URL(Astro.url.pathname, siteConfig.url).toString()} />
+
+    <!-- Alternate language links for SEO -->
+    <link rel="alternate" hreflang="en" href={new URL(Astro.url.pathname.replace(/^\/(es|fr)/, ''), siteConfig.url).toString()} />
+    <link rel="alternate" hreflang="es" href={new URL(`/es${Astro.url.pathname.replace(/^\/(en|es|fr)/, '')}`, siteConfig.url).toString()} />
+    <link rel="alternate" hreflang="fr" href={new URL(`/fr${Astro.url.pathname.replace(/^\/(en|es|fr)/, '')}`, siteConfig.url).toString()} />
+    <link rel="alternate" hreflang="x-default" href={new URL(Astro.url.pathname.replace(/^\/(es|fr)/, ''), siteConfig.url).toString()} />
+
+    <!-- JSON-LD Structured Data -->
+    <JsonLd schema={schemas} />
+
+    <!-- Theme script (runs before render to prevent flash) -->
+    <script is:inline>
+      (function () {
+        const theme = localStorage.getItem('theme');
+        const systemDark = window.matchMedia('(prefers-color-scheme: dark)').matches;
+
+        if (theme === 'dark' || (!theme && systemDark)) {
+          document.documentElement.classList.add('dark');
+        } else {
+          document.documentElement.classList.remove('dark');
+        }
+      })();
+    </script>
+  </head>
+
+  <body class="min-h-screen bg-background text-foreground antialiased">
+    <!-- Skip to content link -->
+    <a
+      href="#main-content"
+      class="sr-only focus:not-sr-only focus:fixed focus:left-4 focus:top-4 focus:z-50 focus:rounded-md focus:bg-primary focus:px-4 focus:py-2 focus:text-primary-foreground"
+    >
+      Skip to content
+    </a>
+
+    <slot name="header" />
+
+    <main id="main-content" class="flex-1">
+      <slot />
+    </main>
+
+    <slot name="footer" />
+  </body>
+</html>

package/templates/i18n/src/pages/[lang]/index.astro

@@ -0,0 +1,36 @@
+---
+import LandingLayout from '@/layouts/LandingLayout.astro';
+import Hero from '@/components/landing/Hero.astro';
+import TechStack from '@/components/landing/TechStack.astro';
+import FeatureTabs from '@/components/landing/FeatureTabs.tsx';
+import Credibility from '@/components/landing/Credibility.astro';
+import CTA from '@/components/landing/CTA.astro';
+import { locales, isValidLocale, type Locale } from '@/i18n/config';
+import { useTranslations } from '@/i18n/index';
+
+export function getStaticPaths() {
+  return locales.map((lang) => ({
+    params: { lang },
+  }));
+}
+
+const { lang } = Astro.params;
+
+if (!lang || !isValidLocale(lang)) {
+  return Astro.redirect('/');
+}
+
+const t = useTranslations(lang as Locale);
+---
+
+<LandingLayout
+  title={t('home.title')}
+  description={t('home.subtitle')}
+  lang={lang as Locale}
+>
+  <Hero />
+  <TechStack />
+  <FeatureTabs client:visible />
+  <Credibility />
+  <CTA />
+</LandingLayout>