create-aerobuilt 0.1.0

package/README.md

@@ -0,0 +1,59 @@
+# create-aerobuilt
+
+Scaffold a new [Aero](https://github.com/aerobuilt/aero) project. Aero is an HTML-first static site generator powered by Vite.
+
+## Usage
+
+```bash
+pnpm create aerobuilt my-app
+cd my-app
+pnpm dev
+```
+
+Also works with npm, yarn, and `pnpm dlx`:
+
+```bash
+npx create-aerobuilt@latest my-app
+yarn create aerobuilt my-app
+pnpm dlx create-aerobuilt my-app
+```
+
+## Options
+
+| Argument | Description                | Default      |
+| -------- | -------------------------- | ------------ |
+| `<dir>`  | Project name and directory | _(required)_ |
+
+## What it does
+
+1. Copies the minimal template into a new directory
+2. Rewrites `package.json` with your project name
+3. Auto-detects your package manager (pnpm > yarn > npm) and installs dependencies
+4. Prints next steps
+
+After scaffolding, the project has `aerobuilt` as its only framework dependency.
+
+## Project structure
+
+```
+my-app/
+├── client/
+│   ├── assets/         # Styles, scripts, images
+│   ├── components/     # Reusable .html components
+│   ├── layouts/        # Layout wrappers with <slot>
+│   └── pages/          # File-based routing
+├── content/
+│   └── site.ts         # Global site data
+├── public/             # Static assets (copied as-is)
+├── vite.config.ts      # Aero Vite plugin
+└── tsconfig.json       # Path aliases
+```
+
+## Links
+
+- [GitHub](https://github.com/aerobuilt/aero)
+- [aerobuilt on npm](https://www.npmjs.com/package/aerobuilt)
+
+## License
+
+MIT

package/index.js

@@ -0,0 +1,152 @@
+#!/usr/bin/env node
+
+import { cpSync, mkdirSync, existsSync, statSync, readdirSync, lstatSync } from 'fs'
+import { dirname, join, basename } from 'path'
+import { fileURLToPath } from 'url'
+import { spawnSync } from 'child_process'
+import { parseArgs, rewritePackageJson, writeReadme, findWorkspaceRoot } from './lib.js'
+
+const __dirname = dirname(fileURLToPath(import.meta.url))
+const startPkgDir = __dirname
+const pkgRoot = join(startPkgDir, 'node_modules')
+const APPS_DIR = 'dist'
+
+const TEMPLATES = ['minimal']
+const DEFAULT_TEMPLATE = 'minimal'
+
+function resolveTemplatePath(templateName) {
+	const pkgName = `@aerobuilt/template-${templateName}`
+	const templatePath = join(pkgRoot, pkgName)
+	if (!existsSync(templatePath)) {
+		console.error(
+			`create-aerobuilt: template "${templateName}" not found (expected ${templatePath}).`,
+		)
+		console.error('Install dependencies with: pnpm install')
+		process.exit(1)
+	}
+	return templatePath
+}
+
+function copyTemplate(src, dest) {
+	const ignore = name => {
+		if (name === 'node_modules') return true
+		if (name === '.git') return true
+		if (name === 'dist' || name === '.output') return true
+		if (name.endsWith('.log') || name === '.DS_Store') return true
+		if (name === '.vite' || name === '.nitro') return true
+		return false
+	}
+	mkdirSync(dest, { recursive: true })
+	cpSync(src, dest, {
+		recursive: true,
+		dereference: true,
+		filter: source => {
+			const name = basename(source)
+			return !ignore(name)
+		},
+	})
+}
+
+function isInMonorepo() {
+	try {
+		const templatePath = join(pkgRoot, `@aerobuilt/template-${DEFAULT_TEMPLATE}`)
+		if (!existsSync(templatePath)) return false
+		return lstatSync(templatePath).isSymbolicLink()
+	} catch {
+		return false
+	}
+}
+
+function installInMonorepo(targetDir) {
+	const root = findWorkspaceRoot(targetDir)
+	if (!root) {
+		console.error('create-aerobuilt: could not find workspace root (pnpm-workspace.yaml).')
+		process.exit(1)
+	}
+	const r = spawnSync('pnpm', ['install', '--no-frozen-lockfile'], {
+		stdio: 'inherit',
+		cwd: root,
+		shell: true,
+	})
+	if (r.status !== 0) {
+		console.error(
+			'create-aerobuilt: pnpm install failed. Run "pnpm install" from the repo root.',
+		)
+		process.exit(1)
+	}
+}
+
+function installStandalone(targetDir) {
+	const hasPnpm = existsSync(join(targetDir, 'pnpm-lock.yaml'))
+	const hasNpm = existsSync(join(targetDir, 'package-lock.json'))
+	const hasYarn = existsSync(join(targetDir, 'yarn.lock'))
+	const cmd = hasPnpm ? 'pnpm' : hasYarn ? 'yarn' : 'npm'
+	const args = hasPnpm || hasYarn ? ['install'] : ['install']
+	const r = spawnSync(cmd, args, { stdio: 'inherit', cwd: targetDir, shell: true })
+	if (r.status !== 0) {
+		console.error(
+			`create-aerobuilt: ${cmd} install failed. Run "${cmd} install" in the project directory.`,
+		)
+		process.exit(1)
+	}
+}
+
+function main() {
+	const { target, template } = parseArgs(process.argv)
+
+	if (!target) {
+		console.error('create-aerobuilt: missing target directory.')
+		console.error('Usage: pnpm run create-aerobuilt <dir>')
+		console.error('Example: pnpm run create-aerobuilt my-app')
+		process.exit(1)
+	}
+
+	if (!TEMPLATES.includes(template)) {
+		console.error(
+			`create-aerobuilt: unknown template "${template}". Use one of: ${TEMPLATES.join(', ')}`,
+		)
+		process.exit(1)
+	}
+
+	// Run from packages/create-aerobuilt: scaffold into packages/create-aerobuilt/dist/<target>
+	const inMonorepo = isInMonorepo()
+	const targetDir = inMonorepo
+		? join(startPkgDir, APPS_DIR, target)
+		: join(process.cwd(), target)
+
+	if (inMonorepo) {
+		mkdirSync(join(startPkgDir, APPS_DIR), { recursive: true })
+	}
+
+	if (existsSync(targetDir)) {
+		const stat = statSync(targetDir)
+		if (!stat.isDirectory()) {
+			console.error(`create-aerobuilt: "${target}" exists and is not a directory.`)
+			process.exit(1)
+		}
+		const files = readdirSync(targetDir)
+		if (files.length > 0) {
+			console.error(`create-aerobuilt: directory "${target}" already exists and is not empty.`)
+			process.exit(1)
+		}
+	}
+
+	const templatePath = resolveTemplatePath(template)
+	console.log(`Creating Aero app in ${target} from template "${template}"...`)
+	copyTemplate(templatePath, targetDir)
+	rewritePackageJson(targetDir, target, inMonorepo)
+	writeReadme(targetDir, target, template)
+	console.log('Installing dependencies...')
+	if (inMonorepo) {
+		installInMonorepo(targetDir)
+	} else {
+		installStandalone(targetDir)
+	}
+	console.log('')
+	console.log('Done. Next steps:')
+	console.log(`  cd ${targetDir}`)
+	console.log('  pnpm dev')
+	console.log('')
+}
+
+main()

package/lib.js

@@ -0,0 +1,116 @@
+import { existsSync, readFileSync, writeFileSync } from 'fs'
+import { dirname, join } from 'path'
+
+const DEFAULT_TEMPLATE = 'minimal'
+
+/**
+ * Parse CLI argv into { target, template }.
+ * @param {string[]} argv - process.argv
+ * @returns {{ target: string | null, template: string }}
+ */
+export function parseArgs(argv) {
+	const args = argv.slice(2)
+	let target = null
+	let template = DEFAULT_TEMPLATE
+	for (let i = 0; i < args.length; i++) {
+		if (args[i] === '--template' && args[i + 1]) {
+			template = args[++i]
+			continue
+		}
+		if (!args[i].startsWith('-') && !target) {
+			target = args[i]
+		}
+	}
+	return { target, template }
+}
+
+/**
+ * Rewrite package.json in targetDir: set name to projectName; if !inMonorepo, replace workspace:* with *.
+ * @param {string} targetDir
+ * @param {string} projectName
+ * @param {boolean} inMonorepo
+ */
+export function rewritePackageJson(targetDir, projectName, inMonorepo) {
+	const pkgPath = join(targetDir, 'package.json')
+	if (!existsSync(pkgPath)) return
+	const pkg = JSON.parse(readFileSync(pkgPath, 'utf8'))
+	pkg.name = projectName
+	if (!inMonorepo) {
+		const rewrite = deps => {
+			if (!deps) return
+			for (const key of Object.keys(deps)) {
+				if (deps[key] === 'workspace:*') deps[key] = '*'
+			}
+		}
+		rewrite(pkg.dependencies)
+		rewrite(pkg.devDependencies)
+	}
+	writeFileSync(pkgPath, JSON.stringify(pkg, null, 2) + '\n')
+}
+
+/**
+ * Walk up from fromDir to find directory containing pnpm-workspace.yaml.
+ * @param {string} fromDir
+ * @returns {string | null}
+ */
+export function findWorkspaceRoot(fromDir) {
+	let dir = fromDir
+	for (;;) {
+		if (existsSync(join(dir, 'pnpm-workspace.yaml'))) return dir
+		const parent = dirname(dir)
+		if (parent === dir) return null
+		dir = parent
+	}
+}
+
+/**
+ * Write a project-appropriate README.md into targetDir.
+ * @param {string} targetDir
+ * @param {string} projectName
+ * @param {string} template
+ */
+export function writeReadme(targetDir, projectName, template) {
+	const lines = [
+		`# ${projectName}`,
+		'',
+		`Built with [Aero](https://github.com/aerobuilt/aero) — an HTML-first static site generator powered by Vite.`,
+		'',
+		'## Commands',
+		'',
+		'| Command | Description |',
+		'|---|---|',
+		'| `pnpm dev` | Start the dev server |',
+		'| `pnpm build` | Build for production |',
+		'| `pnpm preview` | Preview the built site |',
+	]
+
+	lines.push(
+		'',
+		'## Project Structure',
+		'',
+		'```',
+		`${projectName}/`,
+		'├── client/',
+		'│   ├── assets/         # Styles, scripts, images',
+		'│   ├── components/     # Reusable .html components',
+		'│   ├── layouts/        # Layout wrappers with <slot>',
+		'│   └── pages/          # File-based routing',
+		'├── content/',
+		'│   └── site.ts         # Global site data',
+		'├── public/             # Static assets (copied as-is)',
+		'├── vite.config.ts      # Aero Vite plugin',
+		'└── tsconfig.json       # Path aliases',
+		'```',
+	)
+
+	lines.push(
+		'',
+		'## Learn More',
+		'',
+		'- [Aero on GitHub](https://github.com/aerobuilt/aero)',
+		'- [aerobuilt on npm](https://www.npmjs.com/package/aerobuilt)',
+		'',
+	)
+
+	writeFileSync(join(targetDir, 'README.md'), lines.join('\n'))
+}

package/package.json

@@ -0,0 +1,28 @@
+{
+  "name": "create-aerobuilt",
+  "version": "0.1.0",
+  "type": "module",
+  "license": "MIT",
+  "author": "Jamie Wilson",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/aerobuilt/aero.git",
+    "directory": "packages/create-aerobuilt"
+  },
+  "homepage": "https://github.com/aerobuilt/aero",
+  "files": [
+    "index.js",
+    "lib.js",
+    "README.md"
+  ],
+  "bin": {
+    "create-aerobuilt": "index.js"
+  },
+  "dependencies": {
+    "@aerobuilt/template-minimal": "0.1.0"
+  },
+  "scripts": {
+    "create": "node .",
+    "create-aerobuilt": "node index.js"
+  }
+}