create-questpie 1.0.0

package/README.md

@@ -0,0 +1,81 @@
+# create-questpie
+
+Interactive CLI for scaffolding new QUESTPIE projects.
+
+## Usage
+
+```bash
+bunx create-questpie
+```
+
+Or with a project name:
+
+```bash
+bunx create-questpie my-app
+```
+
+## Options
+
+| Flag                    | Description                                 |
+| ----------------------- | ------------------------------------------- |
+| `-t, --template <name>` | Template to use (default: `tanstack-start`) |
+| `--no-install`          | Skip dependency installation                |
+| `--no-git`              | Skip git initialization                     |
+
+## Templates
+
+### tanstack-start (default)
+
+Full-stack TypeScript project with:
+
+- **TanStack Start** — File-based routing with SSR
+- **QUESTPIE** — Collections, globals, auth, storage, jobs pre-configured
+- **@questpie/admin** — Admin panel with sidebar, dashboard, and form views
+- **Tailwind CSS v4** — Styling with shadcn components
+- **Drizzle ORM** — Migrations and typed database access
+- **Vite** — Dev server with HMR
+
+The template includes example collections, a site settings global, admin config, and everything wired together — ready to run with `bun dev`.
+
+## What It Creates
+
+```
+my-app/
+├── src/
+│   ├── questpie/
+│   │   ├── server/
+│   │   │   ├── builder.ts        # q.use(adminModule) setup
+│   │   │   ├── cms.ts            # CMS assembly + build
+│   │   │   ├── collections/      # Collection definitions
+│   │   │   └── globals/          # Global definitions
+│   │   └── admin/
+│   │       └── admin.ts          # Client admin builder
+│   ├── lib/
+│   │   ├── cms-client.ts         # Typed CMS client
+│   │   └── query-client.ts       # TanStack Query client
+│   ├── routes/
+│   │   ├── api/cms.ts            # CMS route handler
+│   │   └── admin/                # Admin panel routes
+│   └── migrations/               # Drizzle migrations
+├── questpie.config.ts            # CLI config
+├── AGENTS.md                     # AI agent guidance
+├── package.json
+└── vite.config.ts
+```
+
+## After Scaffolding
+
+```bash
+cd my-app
+cp .env.example .env              # Set DATABASE_URL
+bun questpie migrate              # Run migrations
+bun dev                           # Start dev server
+```
+
+## Documentation
+
+Full documentation: [https://questpie.com/docs/getting-started/quickstart](https://questpie.com/docs/getting-started/quickstart)
+
+## License
+
+MIT

package/dist/index.mjs

@@ -0,0 +1,284 @@
+#!/usr/bin/env node
+import { Command } from "commander";
+import * as p from "@clack/prompts";
+import pc from "picocolors";
+import { execSync } from "node:child_process";
+import { existsSync } from "node:fs";
+import { cp, readFile, readdir, rename, writeFile } from "node:fs/promises";
+import { join, resolve } from "node:path";
+
+//#region src/templates.ts
+const templates = [{
+	id: "tanstack-start",
+	label: "TanStack Start",
+	hint: "recommended",
+	description: "Full-stack React with TanStack Start, Vite, Tailwind CSS, and Nitro server"
+}];
+function getTemplate(id) {
+	return templates.find((t) => t.id === id);
+}
+
+//#endregion
+//#region src/utils.ts
+function toDbName(str) {
+	return str.toLowerCase().replace(/[^a-z0-9]+/g, "_").replace(/^_|_$/g, "");
+}
+function isValidPackageName(name) {
+	return /^(?:@[a-z0-9-*~][a-z0-9-*._~]*\/)?[a-z0-9-~][a-z0-9-._~]*$/.test(name);
+}
+function generatePassword(length = 24) {
+	const chars = "abcdefghijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ0123456789";
+	let result = "";
+	const randomBytes = new Uint8Array(length);
+	crypto.getRandomValues(randomBytes);
+	for (let i = 0; i < length; i++) result += chars[randomBytes[i] % 62];
+	return result;
+}
+function isGitInstalled() {
+	try {
+		execSync("git --version", { stdio: "ignore" });
+		return true;
+	} catch {
+		return false;
+	}
+}
+function gitInit(cwd) {
+	execSync("git init", {
+		cwd,
+		stdio: "ignore"
+	});
+	execSync("git add -A", {
+		cwd,
+		stdio: "ignore"
+	});
+	execSync("git commit -m \"Initial commit from create-questpie\"", {
+		cwd,
+		stdio: "ignore"
+	});
+}
+function installDependencies(cwd, packageManager) {
+	execSync(packageManager === "npm" ? "npm install" : `${packageManager} install`, {
+		cwd,
+		stdio: "inherit"
+	});
+}
+function detectPackageManager() {
+	const userAgent = process.env.npm_config_user_agent;
+	if (userAgent) {
+		if (userAgent.startsWith("bun")) return "bun";
+		if (userAgent.startsWith("pnpm")) return "pnpm";
+		if (userAgent.startsWith("yarn")) return "yarn";
+	}
+	return "bun";
+}
+const label = {
+	info: (msg) => `${pc.cyan("ℹ")} ${msg}`,
+	success: (msg) => `${pc.green("✓")} ${msg}`,
+	warn: (msg) => `${pc.yellow("⚠")} ${msg}`,
+	error: (msg) => `${pc.red("✗")} ${msg}`
+};
+
+//#endregion
+//#region src/prompts.ts
+async function runPrompts(args) {
+	p.intro(pc.bgCyan(pc.black(" QUESTPIE — Create a new project ")));
+	const questions = await p.group({
+		projectName: () => {
+			if (args.projectName) return Promise.resolve(args.projectName);
+			return p.text({
+				message: "Project name",
+				placeholder: "my-questpie-app",
+				validate: (value) => {
+					if (!value) return "Project name is required";
+					if (!isValidPackageName(value)) return "Invalid package name (use lowercase, hyphens, no spaces)";
+				}
+			});
+		},
+		templateId: () => {
+			if (args.templateId) return Promise.resolve(args.templateId);
+			if (templates.length === 1) return Promise.resolve(templates[0].id);
+			return p.select({
+				message: "Select a template",
+				options: templates.map((t) => ({
+					value: t.id,
+					label: t.label,
+					hint: t.hint
+				}))
+			});
+		},
+		databaseName: ({ results }) => {
+			if (args.databaseName) return Promise.resolve(args.databaseName);
+			const defaultDb = toDbName(results.projectName);
+			return p.text({
+				message: "Database name",
+				placeholder: defaultDb,
+				defaultValue: defaultDb
+			});
+		},
+		installDeps: () => {
+			if (args.installDeps !== void 0) return Promise.resolve(args.installDeps);
+			return p.confirm({
+				message: "Install dependencies?",
+				initialValue: true
+			});
+		},
+		initGit: () => {
+			if (args.initGit !== void 0) return Promise.resolve(args.initGit);
+			return p.confirm({
+				message: "Initialize git repository?",
+				initialValue: true
+			});
+		}
+	}, { onCancel: () => {
+		p.cancel("Operation cancelled.");
+		process.exit(0);
+	} });
+	return {
+		projectName: questions.projectName,
+		templateId: questions.templateId,
+		databaseName: questions.databaseName,
+		installDeps: questions.installDeps,
+		initGit: questions.initGit
+	};
+}
+
+//#endregion
+//#region src/scaffolder.ts
+const TEMPLATE_VAR_REGEX = /\{\{(\w+)\}\}/g;
+/**
+* Resolves the path to the templates directory.
+* Works both in dev (src/) and built (dist/) contexts.
+*/
+function getTemplatesDir() {
+	const fromDist = resolve(import.meta.dirname, "..", "templates");
+	if (existsSync(fromDist)) return fromDist;
+	const fromSrc = resolve(import.meta.dirname, "..", "..", "templates");
+	if (existsSync(fromSrc)) return fromSrc;
+	throw new Error("Could not find templates directory");
+}
+const TEXT_EXTENSIONS = new Set([
+	".ts",
+	".tsx",
+	".js",
+	".jsx",
+	".json",
+	".md",
+	".css",
+	".html",
+	".yml",
+	".yaml",
+	".toml",
+	".env",
+	".example",
+	".hbs",
+	""
+]);
+function isTextFile(filename) {
+	const ext = filename.slice(filename.lastIndexOf("."));
+	if (filename.startsWith(".")) return true;
+	return TEXT_EXTENSIONS.has(ext);
+}
+async function replaceInFile(filePath, vars) {
+	const content = await readFile(filePath, "utf-8");
+	const replaced = content.replace(TEMPLATE_VAR_REGEX, (match, key) => {
+		return key in vars ? vars[key] : match;
+	});
+	if (replaced !== content) await writeFile(filePath, replaced, "utf-8");
+}
+async function processDirectory(dir, vars) {
+	const entries = await readdir(dir, { withFileTypes: true });
+	for (const entry of entries) {
+		const fullPath = join(dir, entry.name);
+		if (entry.isDirectory()) {
+			if (entry.name === "node_modules" || entry.name === ".git") continue;
+			await processDirectory(fullPath, vars);
+		} else if (entry.isFile() && isTextFile(entry.name)) await replaceInFile(fullPath, vars);
+	}
+}
+async function renameGitignore(targetDir) {
+	const gitignorePath = join(targetDir, "gitignore");
+	if (existsSync(gitignorePath)) await rename(gitignorePath, join(targetDir, ".gitignore"));
+}
+async function renameEnvExample(targetDir) {
+	const envPath = join(targetDir, "env.example");
+	if (existsSync(envPath)) await rename(envPath, join(targetDir, ".env.example"));
+}
+async function scaffold(options) {
+	const spinner = p.spinner();
+	const targetDir = resolve(process.cwd(), options.projectName);
+	if (existsSync(targetDir)) {
+		p.log.error(`Directory ${options.projectName} already exists.`);
+		process.exit(1);
+	}
+	const vars = {
+		projectName: options.projectName,
+		databaseName: options.databaseName,
+		databaseUser: options.databaseName,
+		databasePassword: generatePassword()
+	};
+	spinner.start("Copying template files");
+	const templateDir = join(getTemplatesDir(), options.templateId);
+	if (!existsSync(templateDir)) {
+		spinner.stop(label.error(`Template "${options.templateId}" not found`));
+		process.exit(1);
+	}
+	await cp(templateDir, targetDir, { recursive: true });
+	spinner.stop(label.success("Copied template files"));
+	spinner.start("Processing template");
+	await renameGitignore(targetDir);
+	await renameEnvExample(targetDir);
+	await processDirectory(targetDir, vars);
+	spinner.stop(label.success("Processed template variables"));
+	if (options.installDeps) {
+		const pm$1 = detectPackageManager();
+		spinner.start(`Installing dependencies with ${pm$1}`);
+		try {
+			installDependencies(targetDir, pm$1);
+			spinner.stop(label.success("Installed dependencies"));
+		} catch {
+			spinner.stop(label.warn("Failed to install dependencies — run manually"));
+		}
+	}
+	if (options.initGit && isGitInstalled()) {
+		spinner.start("Initializing git repository");
+		try {
+			gitInit(targetDir);
+			spinner.stop(label.success("Initialized git repository"));
+		} catch {
+			spinner.stop(label.warn("Failed to initialize git — run manually"));
+		}
+	}
+	const pm = detectPackageManager();
+	const runCmd = pm === "npm" ? "npm run" : pm;
+	p.note([
+		`cd ${options.projectName}`,
+		"",
+		"# Start PostgreSQL",
+		"docker compose up -d",
+		"",
+		"# Run migrations",
+		`${runCmd} questpie migrate`,
+		"",
+		"# Start dev server",
+		`${runCmd} dev`
+	].join("\n"), "Next steps");
+	p.outro(`${label.success("Done!")} Happy building with QUESTPIE!`);
+}
+
+//#endregion
+//#region src/index.ts
+new Command().name("create-questpie").description("Create a new QUESTPIE CMS project").version("0.1.0").argument("[project-name]", "Name of the project").option("-t, --template <name>", "Template to use (default: tanstack-start)").option("--no-install", "Skip dependency installation").option("--no-git", "Skip git initialization").action(async (projectName, opts) => {
+	if (opts.template && !getTemplate(opts.template)) {
+		console.error(`Unknown template: ${opts.template}`);
+		process.exit(1);
+	}
+	await scaffold(await runPrompts({
+		projectName,
+		templateId: opts.template,
+		installDeps: opts.install === false ? false : void 0,
+		initGit: opts.git === false ? false : void 0
+	}));
+}).parse();
+
+//#endregion
+export {  };

package/package.json

@@ -0,0 +1,44 @@
+{
+	"name": "create-questpie",
+	"version": "1.0.0",
+	"type": "module",
+	"description": "Create a new QUESTPIE CMS project",
+	"bin": {
+		"create-questpie": "./dist/index.mjs"
+	},
+	"files": [
+		"dist",
+		"templates"
+	],
+	"scripts": {
+		"build": "tsdown",
+		"dev": "tsdown --watch",
+		"check-types": "tsc --noEmit"
+	},
+	"dependencies": {
+		"@clack/prompts": "^0.10.0",
+		"commander": "^13.0.0",
+		"picocolors": "^1.1.1"
+	},
+	"devDependencies": {
+		"bun-types": "latest",
+		"tsdown": "^0.18.3",
+		"typescript": "^5.9.2"
+	},
+	"repository": {
+		"type": "git",
+		"url": "https://github.com/questpie/questpie-cms.git",
+		"directory": "packages/create-questpie"
+	},
+	"publishConfig": {
+		"access": "public"
+	},
+	"keywords": [
+		"questpie",
+		"cms",
+		"create",
+		"scaffold",
+		"template"
+	],
+	"license": "MIT"
+}