create-ardo 3.1.0 → 3.2.0

package/dist/index.js

@@ -1,329 +1,311 @@
 #!/usr/bin/env node
-
-// src/index.ts
-import fs2 from "fs";
-import path2 from "path";
+import { blue, cyan, dim, green, red, reset, yellow } from "kolorist";
+import fs from "node:fs";
+import path from "node:path";
 import prompts from "prompts";
-import { blue, cyan, green, red, reset, yellow, dim } from "kolorist";
-
-// src/scaffold.ts
-import fs from "fs";
-import path from "path";
-import { fileURLToPath } from "url";
-var __dirname = path.dirname(fileURLToPath(import.meta.url));
-var templatesRoot = path.resolve(__dirname, "..", "templates");
-var packageJsonPath = path.resolve(__dirname, "..", "package.json");
+//#region src/scaffold.ts
+const __dirname = import.meta.dirname;
+const templatesRoot = path.resolve(__dirname, "..", "templates");
+const packageJsonPath = path.resolve(__dirname, "..", "package.json");
 function getCliVersion() {
-  const pkg = JSON.parse(fs.readFileSync(packageJsonPath, "utf-8"));
-  return pkg.version;
+	const pkg = readJsonObject(packageJsonPath);
+	return typeof pkg?.version === "string" ? pkg.version : "0.0.0";
 }
-var templates = [
-  {
-    name: "minimal",
-    display: "Minimal",
-    description: "Basic setup with essential files only"
-  }
-];
+const templates = [{
+	name: "minimal",
+	display: "Minimal",
+	description: "Basic setup with essential files only"
+}];
 function createProjectStructure(root, template, options) {
-  const templateDir = path.join(templatesRoot, template);
-  const vars = {
-    SITE_TITLE: options.siteTitle,
-    PROJECT_NAME: options.projectName,
-    ARDO_VERSION: getCliVersion(),
-    TYPEDOC_CONFIG: options.typedoc ? "typedoc: true," : "// typedoc: true, // Uncomment to enable API docs",
-    GITHUB_PAGES_CONFIG: options.githubPages ? "// GitHub Pages: base path auto-detected from git remote" : "githubPages: false, // Disabled for non-GitHub Pages deployment",
-    GITHUB_PAGES_BASENAME_IMPORT: options.githubPages ? 'import { detectGitHubBasename } from "ardo/vite"' : "",
-    GITHUB_PAGES_BASENAME: options.githubPages ? "basename: detectGitHubBasename()," : "// basename: detectGitHubBasename(), // Uncomment for GitHub Pages",
-    DESCRIPTION: options.description,
-    TYPEDOC_NAV: options.typedoc ? "{ text: 'API', link: '/api-reference' }," : "",
-    TYPEDOC_SIDEBAR: options.typedoc ? "{ text: 'API Reference', link: '/api-reference' }," : ""
-  };
-  copyDir(templateDir, root, vars);
+	copyDir(path.join(templatesRoot, template), root, {
+		SITE_TITLE: options.siteTitle,
+		PROJECT_NAME: options.projectName,
+		ARDO_VERSION: getCliVersion(),
+		TYPEDOC_CONFIG: options.typedoc ? "typedoc: true," : "// typedoc: true, // Uncomment to enable API docs",
+		GITHUB_PAGES_CONFIG: options.githubPages ? "// GitHub Pages: base path auto-detected from git remote" : "githubPages: false, // Disabled for non-GitHub Pages deployment",
+		GITHUB_PAGES_BASENAME_IMPORT: options.githubPages ? "import { detectGitHubBasename } from \"ardo/vite\"" : "",
+		GITHUB_PAGES_BASENAME: options.githubPages ? "basename: detectGitHubBasename()," : "// basename: detectGitHubBasename(), // Uncomment for GitHub Pages",
+		DESCRIPTION: options.description
+	});
 }
 function copyDir(src, dest, vars) {
-  fs.mkdirSync(dest, { recursive: true });
-  for (const entry of fs.readdirSync(src, { withFileTypes: true })) {
-    const srcPath = path.join(src, entry.name);
-    const destName = entry.name === "_gitignore" ? ".gitignore" : entry.name;
-    const destPath = path.join(dest, destName);
-    if (entry.isDirectory()) {
-      copyDir(srcPath, destPath, vars);
-    } else {
-      let content = fs.readFileSync(srcPath, "utf-8");
-      for (const [key, value] of Object.entries(vars)) {
-        content = content.replaceAll(`{{${key}}}`, value);
-      }
-      fs.writeFileSync(destPath, content);
-    }
-  }
+	fs.mkdirSync(dest, { recursive: true });
+	for (const entry of fs.readdirSync(src, { withFileTypes: true })) {
+		const srcPath = path.join(src, entry.name);
+		const destName = entry.name === "_gitignore" ? ".gitignore" : entry.name;
+		const destPath = path.join(dest, destName);
+		if (entry.isDirectory()) copyDir(srcPath, destPath, vars);
+		else {
+			let content = fs.readFileSync(srcPath, "utf8");
+			for (const [key, value] of Object.entries(vars)) content = content.replaceAll(`{{${key}}}`, value);
+			fs.writeFileSync(destPath, content);
+		}
+	}
 }
 function formatTargetDir(targetDir) {
-  return targetDir?.trim().replace(/\/+$/g, "");
+	if (targetDir === void 0) return;
+	let normalized = targetDir.trim();
+	while (normalized.endsWith("/")) normalized = normalized.slice(0, -1);
+	return normalized;
 }
 function isEmpty(dirPath) {
-  const files = fs.readdirSync(dirPath);
-  return files.length === 0 || files.length === 1 && files[0] === ".git";
+	const files = fs.readdirSync(dirPath);
+	return files.length === 0 || files.length === 1 && files[0] === ".git";
 }
 function emptyDir(dir) {
-  if (!fs.existsSync(dir)) {
-    return;
-  }
-  for (const file of fs.readdirSync(dir)) {
-    if (file === ".git") {
-      continue;
-    }
-    fs.rmSync(path.join(dir, file), { recursive: true, force: true });
-  }
+	if (!fs.existsSync(dir)) return;
+	for (const file of fs.readdirSync(dir)) {
+		if (file === ".git") continue;
+		fs.rmSync(path.join(dir, file), {
+			recursive: true,
+			force: true
+		});
+	}
 }
 function isValidTemplate(template) {
-  return templates.some((t) => t.name === template);
+	return templates.some((t) => t.name === template);
 }
 function detectProjectDescription(targetDir) {
-  for (const dir of [path.dirname(targetDir), targetDir]) {
-    const pkgPath = path.join(dir, "package.json");
-    try {
-      const pkg = JSON.parse(fs.readFileSync(pkgPath, "utf-8"));
-      if (pkg.description) {
-        return pkg.description;
-      }
-    } catch {
-    }
-  }
-  return void 0;
+	for (const dir of [path.dirname(targetDir), targetDir]) {
+		const pkg = readJsonObject(path.join(dir, "package.json"));
+		if (pkg === void 0) continue;
+		if (typeof pkg.description === "string" && pkg.description !== "") return pkg.description;
+	}
 }
 function isArdoProject(dir) {
-  try {
-    const pkgPath = path.join(dir, "package.json");
-    const pkg = JSON.parse(fs.readFileSync(pkgPath, "utf-8"));
-    return Boolean(pkg.dependencies?.ardo);
-  } catch {
-    return false;
-  }
+	const pkg = readJsonObject(path.join(dir, "package.json"));
+	if (pkg === void 0) return false;
+	return toStringRecord(pkg.dependencies)?.ardo !== void 0;
+}
+function copySkeletonFiles(root, templateDir, result) {
+	for (const file of [
+		"app/entry.client.tsx",
+		"app/entry.server.tsx",
+		"app/root.tsx",
+		"tsconfig.json"
+	]) {
+		const src = path.join(templateDir, file);
+		const dest = path.join(root, file);
+		if (fs.existsSync(src)) {
+			fs.mkdirSync(path.dirname(dest), { recursive: true });
+			fs.copyFileSync(src, dest);
+			result.updated.push(file);
+		} else result.skipped.push(file);
+	}
+}
+function mergePackageJson(root, templateDir, cliVersion) {
+	const userPkgPath = path.join(root, "package.json");
+	const userPkg = readJsonObject(userPkgPath);
+	const templatePkg = readJsonObject(path.join(templateDir, "package.json"));
+	if (userPkg === void 0 || templatePkg === void 0) throw new Error("Could not parse package.json while upgrading project");
+	const userDeps = ensureStringRecord(userPkg, "dependencies");
+	const userDevDeps = ensureStringRecord(userPkg, "devDependencies");
+	const templateDeps = toStringRecord(templatePkg.dependencies) ?? {};
+	const templateDevDeps = toStringRecord(templatePkg.devDependencies) ?? {};
+	userDeps.ardo = `^${cliVersion}`;
+	for (const [dep, version] of Object.entries(templateDeps)) if (dep !== "ardo" && !(dep in userDeps)) userDeps[dep] = version;
+	for (const [dep, version] of Object.entries(templateDevDeps)) userDevDeps[dep] = version;
+	fs.writeFileSync(userPkgPath, `${JSON.stringify(userPkg, null, 2)}\n`);
+}
+function deleteObsoleteFiles(root, result) {
+	for (const file of ["app/vite-env.d.ts"]) {
+		const filePath = path.join(root, file);
+		if (fs.existsSync(filePath)) {
+			fs.unlinkSync(filePath);
+			result.deleted.push(file);
+		}
+	}
 }
 function upgradeProject(root) {
-  const templateDir = path.join(templatesRoot, "minimal");
-  const cliVersion = getCliVersion();
-  const result = { updated: [], deleted: [], skipped: [] };
-  const skeletonFiles = [
-    "app/entry.client.tsx",
-    "app/entry.server.tsx",
-    "app/root.tsx",
-    "tsconfig.json"
-  ];
-  for (const file of skeletonFiles) {
-    const src = path.join(templateDir, file);
-    const dest = path.join(root, file);
-    if (fs.existsSync(src)) {
-      fs.mkdirSync(path.dirname(dest), { recursive: true });
-      fs.copyFileSync(src, dest);
-      result.updated.push(file);
-    } else {
-      result.skipped.push(file);
-    }
-  }
-  const userPkgPath = path.join(root, "package.json");
-  const templatePkgPath = path.join(templateDir, "package.json");
-  const userPkg = JSON.parse(fs.readFileSync(userPkgPath, "utf-8"));
-  const templatePkg = JSON.parse(fs.readFileSync(templatePkgPath, "utf-8"));
-  if (userPkg.dependencies) {
-    userPkg.dependencies.ardo = `^${cliVersion}`;
-  }
-  for (const [dep, version] of Object.entries(
-    templatePkg.dependencies || {}
-  )) {
-    if (dep === "ardo") continue;
-    if (!userPkg.dependencies?.[dep]) {
-      userPkg.dependencies = userPkg.dependencies || {};
-      userPkg.dependencies[dep] = version;
-    }
-  }
-  for (const [dep, version] of Object.entries(
-    templatePkg.devDependencies || {}
-  )) {
-    userPkg.devDependencies = userPkg.devDependencies || {};
-    userPkg.devDependencies[dep] = version;
-  }
-  fs.writeFileSync(userPkgPath, JSON.stringify(userPkg, null, 2) + "\n");
-  result.updated.push("package.json");
-  const obsoleteFiles = ["app/vite-env.d.ts"];
-  for (const file of obsoleteFiles) {
-    const filePath = path.join(root, file);
-    if (fs.existsSync(filePath)) {
-      fs.unlinkSync(filePath);
-      result.deleted.push(file);
-    }
-  }
-  return result;
+	const templateDir = path.join(templatesRoot, "minimal");
+	const result = {
+		updated: [],
+		deleted: [],
+		skipped: []
+	};
+	copySkeletonFiles(root, templateDir, result);
+	mergePackageJson(root, templateDir, getCliVersion());
+	result.updated.push("package.json");
+	deleteObsoleteFiles(root, result);
+	return result;
+}
+function ensureStringRecord(object, key) {
+	const existing = toStringRecord(object[key]);
+	if (existing !== void 0) {
+		object[key] = existing;
+		return existing;
+	}
+	const created = {};
+	object[key] = created;
+	return created;
+}
+function readJsonObject(filePath) {
+	try {
+		const raw = fs.readFileSync(filePath, "utf8");
+		const parsed = JSON.parse(raw);
+		return isJsonObject(parsed) ? parsed : void 0;
+	} catch {
+		return;
+	}
+}
+function isJsonObject(value) {
+	return typeof value === "object" && value !== null;
 }
-
-// src/index.ts
-var defaultTargetDir = "my-docs";
-var onCancel = () => {
-  throw new Error(red("\u2716") + " Operation cancelled");
+function toStringRecord(value) {
+	if (!isJsonObject(value)) return;
+	const entries = Object.entries(value);
+	const result = {};
+	for (const [key, entryValue] of entries) if (typeof entryValue === "string") result[key] = entryValue;
+	return result;
+}
+//#endregion
+//#region src/index.ts
+const defaultTargetDir = "my-docs";
+const onCancel = () => {
+	throw new Error(`${red("✖")} Operation cancelled`);
 };
+async function promptProjectName() {
+	const projectName = (await prompts({
+		type: "text",
+		name: "projectName",
+		message: reset("Project name:"),
+		initial: defaultTargetDir,
+		validate: (value) => {
+			const name = value.trim();
+			if (!name) return "Project name is required";
+			if (/^[.-]/.test(name)) return "Project name cannot start with a dot or hyphen";
+			if (!/^[\da-z-]+$/.test(name)) return "Project name may only contain lowercase letters, digits, and hyphens";
+			return true;
+		}
+	}, { onCancel })).projectName;
+	return formatTargetDir(typeof projectName === "string" ? projectName : defaultTargetDir) ?? defaultTargetDir;
+}
+async function runUpgradeFlow(root) {
+	if ((await prompts({
+		type: "select",
+		name: "action",
+		message: `Existing Ardo project detected. Upgrade to v${getCliVersion()}?`,
+		choices: [{
+			title: "Upgrade framework files",
+			value: "upgrade"
+		}, {
+			title: "Cancel",
+			value: "cancel"
+		}]
+	}, { onCancel })).action === "cancel") throw new Error(`${red("✖")} Operation cancelled`);
+	console.log(`\n  ${cyan("Upgrading project in")} ${root}...\n`);
+	const result = upgradeProject(root);
+	for (const file of result.updated) console.log(`  ${green("●")} ${file}`);
+	for (const file of result.deleted) console.log(`  ${yellow("●")} ${file} ${dim("(removed)")}`);
+	for (const file of result.skipped) console.log(`  ${dim("○")} ${file} ${dim("(not found, skipped)")}`);
+	console.log(`\n  ${green("Done!")} Now run:\n`);
+	console.log(`  ${blue("pnpm install")}\n`);
+}
+function getNewProjectPrompts(targetDir, root, argTemplate) {
+	return [
+		{
+			type: () => !fs.existsSync(root) || isEmpty(root) ? null : "select",
+			name: "overwrite",
+			message: () => `${targetDir === "." ? "Current directory" : `Target directory "${targetDir}"`} is not empty. How would you like to proceed?`,
+			choices: [
+				{
+					title: "Remove existing files and continue",
+					value: "yes"
+				},
+				{
+					title: "Cancel operation",
+					value: "no"
+				},
+				{
+					title: "Ignore files and continue",
+					value: "ignore"
+				}
+			]
+		},
+		{
+			type: (_, { overwrite }) => {
+				if (overwrite === "no") throw new Error(`${red("✖")} Operation cancelled`);
+				return null;
+			},
+			name: "overwriteChecker"
+		},
+		{
+			type: argTemplate !== void 0 && isValidTemplate(argTemplate) ? null : "select",
+			name: "template",
+			message: reset("Select a template:"),
+			choices: templates.map((t) => ({
+				title: `${t.display} ${yellow(`- ${t.description}`)}`,
+				value: t.name
+			}))
+		},
+		{
+			type: "text",
+			name: "siteTitle",
+			message: reset("Site title:"),
+			initial: "My Documentation"
+		},
+		{
+			type: "select",
+			name: "docType",
+			message: reset("What are you documenting?"),
+			choices: [{
+				title: `Code library ${dim("- includes TypeDoc API generation")}`,
+				value: "library"
+			}, {
+				title: `General documentation ${dim("- guides, manuals, etc.")}`,
+				value: "general"
+			}]
+		},
+		{
+			type: "select",
+			name: "githubPages",
+			message: reset("Deploy to GitHub Pages?"),
+			choices: [{
+				title: `Yes ${dim("- auto-detects base path from git remote")}`,
+				value: true
+			}, {
+				title: `No ${dim("- deploy to other platforms (Netlify, Vercel, etc.)")}`,
+				value: false
+			}]
+		}
+	];
+}
+async function runNewProjectFlow(targetDir, root, argTemplate) {
+	const response = await prompts(getNewProjectPrompts(targetDir, root, argTemplate), { onCancel });
+	const template = response.template ?? argTemplate ?? "minimal";
+	if (response.overwrite === "yes") emptyDir(root);
+	else if (!fs.existsSync(root)) fs.mkdirSync(root, { recursive: true });
+	console.log(`\n  ${cyan("Scaffolding project in")} ${root}...\n`);
+	createProjectStructure(root, template, {
+		siteTitle: response.siteTitle,
+		projectName: targetDir,
+		typedoc: response.docType === "library",
+		githubPages: response.githubPages ?? true,
+		description: detectProjectDescription(root) ?? "Built with Ardo"
+	});
+	console.log(`  ${green("Done!")} Now run:\n`);
+	if (root !== process.cwd()) console.log(`  ${blue("cd")} ${targetDir}`);
+	console.log(`  ${blue("pnpm install")}`);
+	console.log(`  ${blue("pnpm dev")}\n`);
+}
 async function main() {
-  console.log();
-  console.log(`  ${cyan("\u25C6")} ${green("create-ardo")}`);
-  console.log();
-  const argTargetDir = process.argv[2];
-  const argTemplate = process.argv[3];
-  let targetDir = argTargetDir || defaultTargetDir;
-  if (!argTargetDir) {
-    const { projectName } = await prompts(
-      {
-        type: "text",
-        name: "projectName",
-        message: reset("Project name:"),
-        initial: defaultTargetDir,
-        validate: (value) => {
-          const name = value.trim();
-          if (!name) return "Project name is required";
-          if (/^[.-]/.test(name)) return "Project name cannot start with a dot or hyphen";
-          if (!/^[a-z0-9-]+$/.test(name))
-            return "Project name may only contain lowercase letters, digits, and hyphens";
-          return true;
-        }
-      },
-      { onCancel }
-    );
-    targetDir = formatTargetDir(projectName) || defaultTargetDir;
-  }
-  const root = path2.join(process.cwd(), targetDir);
-  if (fs2.existsSync(root) && !isEmpty(root) && isArdoProject(root)) {
-    const cliVersion = getCliVersion();
-    const { action } = await prompts(
-      {
-        type: "select",
-        name: "action",
-        message: `Existing Ardo project detected. Upgrade to v${cliVersion}?`,
-        choices: [
-          { title: "Upgrade framework files", value: "upgrade" },
-          { title: "Cancel", value: "cancel" }
-        ]
-      },
-      { onCancel }
-    );
-    if (action === "cancel") {
-      throw new Error(red("\u2716") + " Operation cancelled");
-    }
-    console.log();
-    console.log(`  ${cyan("Upgrading project in")} ${root}...`);
-    console.log();
-    const result = upgradeProject(root);
-    for (const file of result.updated) {
-      console.log(`  ${green("\u25CF")} ${file}`);
-    }
-    for (const file of result.deleted) {
-      console.log(`  ${yellow("\u25CF")} ${file} ${dim("(removed)")}`);
-    }
-    for (const file of result.skipped) {
-      console.log(`  ${dim("\u25CB")} ${file} ${dim("(not found, skipped)")}`);
-    }
-    console.log();
-    console.log(`  ${green("Done!")} Now run:`);
-    console.log();
-    console.log(`  ${blue("pnpm install")}`);
-    console.log();
-    return;
-  }
-  let template = argTemplate;
-  const response = await prompts(
-    [
-      {
-        type: () => !fs2.existsSync(root) || isEmpty(root) ? null : "select",
-        name: "overwrite",
-        message: () => `${targetDir === "." ? "Current directory" : `Target directory "${targetDir}"`} is not empty. How would you like to proceed?`,
-        choices: [
-          { title: "Remove existing files and continue", value: "yes" },
-          { title: "Cancel operation", value: "no" },
-          { title: "Ignore files and continue", value: "ignore" }
-        ]
-      },
-      {
-        type: (_, { overwrite: overwrite2 }) => {
-          if (overwrite2 === "no") {
-            throw new Error(red("\u2716") + " Operation cancelled");
-          }
-          return null;
-        },
-        name: "overwriteChecker"
-      },
-      {
-        type: argTemplate && isValidTemplate(argTemplate) ? null : "select",
-        name: "template",
-        message: reset("Select a template:"),
-        choices: templates.map((t) => ({
-          title: `${t.display} ${yellow(`- ${t.description}`)}`,
-          value: t.name
-        }))
-      },
-      {
-        type: "text",
-        name: "siteTitle",
-        message: reset("Site title:"),
-        initial: "My Documentation"
-      },
-      {
-        type: "select",
-        name: "docType",
-        message: reset("What are you documenting?"),
-        choices: [
-          {
-            title: `Code library ${dim("- includes TypeDoc API generation")}`,
-            value: "library"
-          },
-          {
-            title: `General documentation ${dim("- guides, manuals, etc.")}`,
-            value: "general"
-          }
-        ]
-      },
-      {
-        type: "select",
-        name: "githubPages",
-        message: reset("Deploy to GitHub Pages?"),
-        choices: [
-          {
-            title: `Yes ${dim("- auto-detects base path from git remote")}`,
-            value: true
-          },
-          {
-            title: `No ${dim("- deploy to other platforms (Netlify, Vercel, etc.)")}`,
-            value: false
-          }
-        ]
-      }
-    ],
-    { onCancel }
-  );
-  const { overwrite, template: templateChoice, siteTitle, docType, githubPages } = response;
-  template = templateChoice || template || "minimal";
-  if (overwrite === "yes") {
-    emptyDir(root);
-  } else if (!fs2.existsSync(root)) {
-    fs2.mkdirSync(root, { recursive: true });
-  }
-  console.log();
-  console.log(`  ${cyan("Scaffolding project in")} ${root}...`);
-  console.log();
-  const description = detectProjectDescription(root) || "Built with Ardo";
-  createProjectStructure(root, template, {
-    siteTitle,
-    projectName: targetDir,
-    typedoc: docType === "library",
-    githubPages: githubPages ?? true,
-    description
-  });
-  console.log(`  ${green("Done!")} Now run:`);
-  console.log();
-  if (root !== process.cwd()) {
-    console.log(`  ${blue("cd")} ${targetDir}`);
-  }
-  console.log(`  ${blue("pnpm install")}`);
-  console.log(`  ${blue("pnpm dev")}`);
-  console.log();
+	console.log(`\n  ${cyan("◆")} ${green("create-ardo")}\n`);
+	const argTargetDir = process.argv.length > 2 ? process.argv[2] : void 0;
+	const argTemplate = process.argv.length > 3 ? process.argv[3] : void 0;
+	const targetDir = argTargetDir ?? await promptProjectName();
+	const root = path.join(process.cwd(), targetDir);
+	if (fs.existsSync(root) && !isEmpty(root) && isArdoProject(root)) {
+		await runUpgradeFlow(root);
+		return;
+	}
+	await runNewProjectFlow(targetDir, root, argTemplate);
+}
+try {
+	await main();
+} catch (error) {
+	const errorMessage = error instanceof Error ? error.message : String(error);
+	console.error(errorMessage);
+	process.exit(1);
 }
-main().catch((e) => {
-  console.error(e.message);
-  process.exit(1);
-});
+//#endregion
+export {};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "create-ardo",
-  "version": "3.1.0",
+  "version": "3.2.0",
   "description": "Scaffolding tool for Ardo documentation projects",
   "type": "module",
   "bin": {
@@ -33,17 +33,17 @@
     "kolorist": "^1.8.0"
   },
   "devDependencies": {
-    "@types/node": "^25.3.3",
+    "@types/node": "^25.5.0",
     "@types/prompts": "^2.4.9",
-    "tsup": "^8.5.1",
-    "typescript": "^5.9.3"
+    "tsdown": "^0.21.7",
+    "typescript": "^6.0.2"
   },
   "engines": {
     "node": ">=18.0.0"
   },
   "scripts": {
-    "build": "tsup",
-    "dev": "tsup --watch",
+    "build": "tsdown",
+    "dev": "tsdown --watch",
     "typecheck": "tsc --noEmit"
   }
 }

package/templates/minimal/app/app.css

@@ -0,0 +1,3 @@
+@layer theme, base, components, utilities;
+@import "tailwindcss/theme.css" layer(theme);
+@import "tailwindcss/utilities.css" layer(utilities);

package/templates/minimal/app/root.tsx

@@ -1,13 +1,14 @@
-import { RootLayout, ArdoRoot } from "ardo/ui"
+import { ArdoRootLayout, ArdoRoot } from "ardo/ui"
 import config from "virtual:ardo/config"
 import sidebar from "virtual:ardo/sidebar"
 import type { MetaFunction } from "react-router"
+import "./app.css"
 import "ardo/ui/styles.css"
 
 export const meta: MetaFunction = () => [{ title: config.title }]
 
 export function Layout({ children }: { children: React.ReactNode }) {
-  return <RootLayout>{children}</RootLayout>
+  return <ArdoRootLayout>{children}</ArdoRootLayout>
 }
 
 export default function Root() {

package/templates/minimal/app/routes/home.tsx

@@ -1,4 +1,4 @@
-import { Hero, Features } from "ardo/ui"
+import { ArdoHero, ArdoFeatures, ArdoFeatureCard } from "ardo/ui"
 import { Zap, Sparkles, Palette, ArrowRight, Github } from "ardo/icons"
 import type { MetaFunction } from "react-router"
 
@@ -9,7 +9,7 @@ export const meta: MetaFunction = () => [
 export default function HomePage() {
   return (
     <>
-      <Hero
+      <ArdoHero
         name="{{SITE_TITLE}}"
         text="Documentation Made Simple"
         tagline="Focus on your content, not configuration"
@@ -28,25 +28,17 @@ export default function HomePage() {
           },
         ]}
       />
-      <Features
-        items={[
-          {
-            title: "Fast",
-            icon: <Zap size={28} strokeWidth={1.5} />,
-            details: "Lightning fast builds with Vite",
-          },
-          {
-            title: "Simple",
-            icon: <Sparkles size={28} strokeWidth={1.5} />,
-            details: "Easy to set up and use",
-          },
-          {
-            title: "Flexible",
-            icon: <Palette size={28} strokeWidth={1.5} />,
-            details: "Fully customizable theme",
-          },
-        ]}
-      />
+      <ArdoFeatures>
+        <ArdoFeatureCard title="Fast" icon={<Zap size={28} strokeWidth={1.5} />}>
+          Lightning fast builds with Vite
+        </ArdoFeatureCard>
+        <ArdoFeatureCard title="Simple" icon={<Sparkles size={28} strokeWidth={1.5} />}>
+          Easy to set up and use
+        </ArdoFeatureCard>
+        <ArdoFeatureCard title="Flexible" icon={<Palette size={28} strokeWidth={1.5} />}>
+          Fully customizable theme
+        </ArdoFeatureCard>
+      </ArdoFeatures>
     </>
   )
 }

package/templates/minimal/package.json

@@ -10,17 +10,19 @@
   },
   "dependencies": {
     "ardo": "^{{ARDO_VERSION}}",
-    "isbot": "*",
-    "lucide-react": "*",
-    "react": "*",
-    "react-dom": "*",
-    "react-router": "*"
+    "isbot": "^5.1.36",
+    "lucide-react": "^0.577.0",
+    "react": "^19.2.4",
+    "react-dom": "^19.2.4",
+    "react-router": "^7.13.2"
   },
   "devDependencies": {
-    "@react-router/dev": "*",
+    "@react-router/dev": "^7.13.2",
+    "@tailwindcss/vite": "^4.2.2",
     "@types/react": "^19.2.14",
     "@types/react-dom": "^19.2.3",
-    "typescript": "^5.9.3",
-    "vite": "^8.0.0-beta.0"
+    "tailwindcss": "^4.2.2",
+    "typescript": "^6.0.2",
+    "vite": "^8.0.3"
   }
 }

package/templates/minimal/vite.config.ts

@@ -1,8 +1,10 @@
 import { defineConfig } from 'vite'
+import tailwindcss from '@tailwindcss/vite'
 import { ardo } from 'ardo/vite'
 
 export default defineConfig({
   plugins: [
+    tailwindcss(),
     ardo({
       title: '{{SITE_TITLE}}',
       description: '{{DESCRIPTION}}',
@@ -10,31 +12,6 @@ export default defineConfig({
       {{TYPEDOC_CONFIG}}
 
       {{GITHUB_PAGES_CONFIG}}
-
-      themeConfig: {
-        siteTitle: '{{SITE_TITLE}}',
-
-        nav: [
-          { text: 'Guide', link: '/guide/getting-started' },
-          {{TYPEDOC_NAV}}
-        ],
-
-        sidebar: [
-          {
-            text: 'Guide',
-            items: [{ text: 'Getting Started', link: '/guide/getting-started' }],
-          },
-          {{TYPEDOC_SIDEBAR}}
-        ],
-
-        footer: {
-          message: 'Released under the MIT License.',
-        },
-
-        search: {
-          enabled: true,
-        },
-      },
     }),
   ],
 })