create-astro-modular 1.0.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 David V. Kimball
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,32 @@
+# create-astro-modular
+
+Scaffold an [Astro Modular](https://github.com/davidvkimball/astro-modular) blog in seconds.
+
+## Usage
+
+```bash
+# pnpm
+pnpm create astro-modular my-blog
+
+# npm
+npm create astro-modular my-blog
+
+# Interactive (prompts for project name)
+pnpm create astro-modular
+```
+
+## What it does
+
+1. Downloads the latest Astro Modular template from GitHub
+2. Removes dev-only files (`cli/`, `.github/`, `.ref/`, `AGENTS.md`)
+3. Installs dependencies
+4. Prints next steps
+
+## Requirements
+
+- Node.js 18+
+- pnpm, npm, yarn, or bun
+
+## License
+
+[MIT](LICENSE)

package/bin/create-astro-modular.mjs

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+import { main } from '../src/index.mjs';
+main();

package/package.json

@@ -0,0 +1,37 @@
+{
+  "name": "create-astro-modular",
+  "version": "1.0.0",
+  "description": "Scaffold an Astro Modular blog in seconds",
+  "type": "module",
+  "bin": {
+    "create-astro-modular": "bin/create-astro-modular.mjs"
+  },
+  "files": [
+    "bin",
+    "src",
+    "LICENSE"
+  ],
+  "keywords": [
+    "astro",
+    "blog",
+    "theme",
+    "obsidian",
+    "create",
+    "scaffold",
+    "template"
+  ],
+  "author": "David V. Kimball",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/davidvkimball/astro-modular",
+    "directory": "cli"
+  },
+  "homepage": "https://github.com/davidvkimball/astro-modular",
+  "dependencies": {
+    "giget": "^2.0.0"
+  },
+  "engines": {
+    "node": ">=18.0.0"
+  }
+}

package/src/index.mjs

@@ -0,0 +1,120 @@
+import { downloadTemplate } from 'giget';
+import { existsSync, readdirSync, rmSync } from 'node:fs';
+import { resolve, basename } from 'node:path';
+import { createInterface } from 'node:readline/promises';
+import { execSync } from 'node:child_process';
+
+// ANSI color helpers
+const bold = (s) => `\x1b[1m${s}\x1b[22m`;
+const green = (s) => `\x1b[32m${s}\x1b[39m`;
+const cyan = (s) => `\x1b[36m${s}\x1b[39m`;
+const red = (s) => `\x1b[31m${s}\x1b[39m`;
+const dim = (s) => `\x1b[2m${s}\x1b[22m`;
+
+const TEMPLATE = 'gh:davidvkimball/astro-modular#master';
+
+const CLEANUP = [
+  'cli',
+  '.github',
+  '.ref',
+  'AGENTS.md',
+];
+
+function detectPackageManager() {
+  const ua = process.env.npm_config_user_agent || '';
+  if (ua.startsWith('pnpm')) return 'pnpm';
+  if (ua.startsWith('yarn')) return 'yarn';
+  if (ua.startsWith('bun')) return 'bun';
+  return 'npm';
+}
+
+function isEmpty(dir) {
+  if (!existsSync(dir)) return true;
+  const entries = readdirSync(dir);
+  return entries.length === 0;
+}
+
+export async function main() {
+  console.log();
+  console.log(bold(cyan('  create-astro-modular')) + dim(' - Scaffold an Astro Modular blog'));
+  console.log();
+
+  let projectName = process.argv[2];
+
+  // Prompt for project name if not provided
+  if (!projectName) {
+    const rl = createInterface({ input: process.stdin, output: process.stdout });
+    try {
+      projectName = await rl.question(cyan('? ') + bold('Project name: '));
+      projectName = projectName.trim();
+    } finally {
+      rl.close();
+    }
+  }
+
+  if (!projectName) {
+    console.log(red('Error: Project name is required.'));
+    process.exit(1);
+  }
+
+  const targetDir = resolve(process.cwd(), projectName);
+
+  // Validate target directory
+  if (!isEmpty(targetDir)) {
+    console.log(red(`Error: Directory "${projectName}" already exists and is not empty.`));
+    process.exit(1);
+  }
+
+  // Download template
+  console.log();
+  console.log(`  ${dim('Downloading template...')}`);
+
+  try {
+    await downloadTemplate(TEMPLATE, {
+      dir: targetDir,
+      force: true,
+    });
+  } catch (err) {
+    console.log(red(`Error downloading template: ${err.message}`));
+    process.exit(1);
+  }
+
+  // Clean up dev-only files and directories
+  for (const name of CLEANUP) {
+    const target = resolve(targetDir, name);
+    if (existsSync(target)) {
+      rmSync(target, { recursive: true, force: true });
+    }
+  }
+
+  console.log(green('  Template downloaded and cleaned up.'));
+
+  // Detect package manager and install
+  const pm = detectPackageManager();
+  console.log(`  ${dim(`Installing dependencies with ${pm}...`)}`);
+
+  try {
+    execSync(`${pm} install`, {
+      cwd: targetDir,
+      stdio: 'inherit',
+    });
+    console.log(green('  Dependencies installed.'));
+  } catch {
+    console.log(dim('  Could not install dependencies. Run install manually.'));
+  }
+
+  // Success message
+  const cdPath = basename(targetDir) === basename(process.cwd())
+    ? '.'
+    : projectName;
+
+  console.log();
+  console.log(green(bold('  Done!')) + ' Your Astro Modular blog is ready.');
+  console.log();
+  console.log('  Next steps:');
+  console.log(`    ${cyan('cd')} ${cdPath}`);
+  console.log(`    ${cyan(`${pm} dev`)}`);
+  console.log();
+  console.log(dim('  Docs: https://github.com/davidvkimball/astro-modular'));
+  console.log();
+}