create-planke 0.0.1

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Espen
+
+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,58 @@
+# planke
+
+**The Unified Toolchain Starter for Node.js**
+
+Creates a new Node.js TypeScript project using the same opinionated toolchain as [Vite+](https://github.com/voidzero-dev/vite-plus), but for non-web projects.
+
+## Create a new project with planke
+
+```bash
+pnpm create planke@latest
+npm create planke@latest
+```
+
+## What you get
+
+The project follows most of the same toolchain as Vite+.
+
+| Tool                                               | Role               |
+| -------------------------------------------------- | ------------------ |
+| [Vitest](https://vitest.dev)                       | Testing            |
+| [Oxlint](https://oxc.rs/docs/guide/usage/linter)   | Linting            |
+| [Oxfmt](https://oxc.rs/docs/guide/usage/formatter) | Formatting         |
+| [tsdown](https://tsdown.dev)                       | Build & bundle     |
+| [tsx](https://tsx.is)                              | Dev-mode execution |
+
+## Backend framework
+
+You can also choose one of the following backend frameworks:
+
+- **None** — where you don't need a API framework, or you want to pick your own.
+- **Hono** — lightweight, modern API framework
+- **Fastify** — fast and low overhead
+- **Express** — familiar and widely supported
+
+## Scripts
+
+Every generated project includes:
+
+```bash
+pnpm dev        # Run with tsx (no build step)
+pnpm build      # Bundle with tsdown
+pnpm test       # Run Vitest
+pnpm check      # Lint + format check + type check
+pnpm fmt        # Format
+pnpm fmt:check  # Check formatting without writing
+pnpm lint       # Lint
+pnpm lint:fix   # Lint with auto-fix
+```
+
+The `pnpm` commands are just examples, you can also use `npm` or `yarn` or `bun` (depending on your package manager).
+
+## License
+
+MIT
+
+## Author
+
+- [Espen Steen](https://github.com/ehs5)

package/dist/index.mjs

@@ -0,0 +1,303 @@
+#!/usr/bin/env node
+import fs from "node:fs";
+import path from "node:path";
+import { fileURLToPath } from "node:url";
+import spawn from "cross-spawn";
+import mri from "mri";
+import * as p from "@clack/prompts";
+import pc from "picocolors";
+//#region src/frameworks.ts
+const FRAMEWORKS = [
+	{
+		value: "none",
+		label: "None"
+	},
+	{
+		value: "hono",
+		label: "Hono",
+		hint: "recommended"
+	},
+	{
+		value: "fastify",
+		label: "Fastify"
+	},
+	{
+		value: "express",
+		label: "Express"
+	}
+];
+const FRAMEWORK_DEPS = {
+	none: {
+		deps: [],
+		devDeps: []
+	},
+	hono: {
+		deps: ["hono", "@hono/node-server"],
+		devDeps: []
+	},
+	fastify: {
+		deps: ["fastify"],
+		devDeps: []
+	},
+	express: {
+		deps: ["express"],
+		devDeps: ["@types/express"]
+	}
+};
+const FRAMEWORK_INDEX = {
+	none: `console.log('Hello from planke!')\n`,
+	hono: `import { Hono } from 'hono'
+import { serve } from '@hono/node-server'
+
+const app = new Hono()
+
+app.get('/', (c) => c.text('Hello World'))
+
+serve(app, (info) => {
+  console.log(\`Server running on http://localhost:\${info.port}\`)
+})
+`,
+	fastify: `import Fastify from 'fastify'
+
+const fastify = Fastify({ logger: true })
+
+fastify.get('/', async () => ({ hello: 'world' }))
+
+fastify.listen({ port: 3000 })
+`,
+	express: `import express from 'express'
+
+const app = express()
+
+app.get('/', (req, res) => {
+  res.send('Hello World')
+})
+
+app.listen(3000, () => {
+  console.log('Server running on http://localhost:3000')
+})
+`
+};
+//#endregion
+//#region src/index.ts
+const __dirname = path.dirname(fileURLToPath(import.meta.url));
+/** Creates a colored gradient text effect */
+function gradient(text, stops, whiteRange) {
+	const chars = [...text];
+	return chars.map((char, i) => {
+		if (whiteRange && i >= whiteRange[0] && i < whiteRange[1]) return `\x1b[38;2;255;255;255m${char}`;
+		const t = chars.length === 1 ? 0 : i / (chars.length - 1);
+		const seg = Math.min(Math.floor(t * (stops.length - 1)), stops.length - 2);
+		const segT = t * (stops.length - 1) - seg;
+		const [r1, g1, b1] = stops[seg];
+		const [r2, g2, b2] = stops[seg + 1];
+		return `\x1b[38;2;${Math.round(r1 + (r2 - r1) * segT)};${Math.round(g1 + (g2 - g1) * segT)};${Math.round(b1 + (b2 - b1) * segT)}m${char}`;
+	}).join("") + "\x1B[0m";
+}
+/** Detects the package manager used to invoke the CLI via npm_config_user_agent. */
+function detectPkgManager() {
+	const ua = process.env.npm_config_user_agent ?? "";
+	if (ua.startsWith("pnpm")) return "pnpm";
+	if (ua.startsWith("bun")) return "bun";
+	if (ua.startsWith("yarn")) return "yarn";
+	return "npm";
+}
+/** Builds the install/add command args for the given package manager. */
+function addArgs(pkgManager, packages, dev) {
+	const cmd = pkgManager === "npm" ? "install" : "add";
+	return dev ? [
+		cmd,
+		{
+			npm: "--save-dev",
+			pnpm: "-D",
+			yarn: "--dev",
+			bun: "-d"
+		}[pkgManager] ?? "--save-dev",
+		...packages
+	] : [cmd, ...packages];
+}
+/** Runs a command synchronously, exiting the process if it fails. */
+function run(cmd, args, opts) {
+	const result = spawn.sync(cmd, args, {
+		stdio: "inherit",
+		...opts
+	});
+	if (result.status != null && result.status !== 0) process.exit(result.status);
+	if (result.error) throw result.error;
+}
+/** Recursively copies a directory, renaming _gitignore to .gitignore. */
+function copyDir(src, dest) {
+	fs.mkdirSync(dest, { recursive: true });
+	for (const entry of fs.readdirSync(src)) {
+		const srcPath = path.join(src, entry);
+		const destPath = path.join(dest, entry === "_gitignore" ? ".gitignore" : entry);
+		if (fs.statSync(srcPath).isDirectory()) copyDir(srcPath, destPath);
+		else fs.copyFileSync(srcPath, destPath);
+	}
+}
+/** Returns true if a directory doesn't exist or contains only a .git folder. */
+function isEmpty(dir) {
+	if (!fs.existsSync(dir)) return true;
+	const files = fs.readdirSync(dir);
+	return files.length === 0 || files.length === 1 && files[0] === ".git";
+}
+/** Prompts for a project name, or reads it from the first CLI argument. */
+async function promptProjectName(argv) {
+	const fromArg = argv._[0] ?? "";
+	if (fromArg) return fromArg;
+	const answer = await p.text({
+		message: "Project name:",
+		placeholder: "planke-project",
+		defaultValue: "planke-project"
+	});
+	if (p.isCancel(answer)) {
+		p.cancel("Cancelled");
+		process.exit(0);
+	}
+	return answer || "planke-project";
+}
+/** Prompts for a backend framework, or reads it from the --template flag. */
+async function promptFramework(argv) {
+	const templateArg = argv.template;
+	if (templateArg && FRAMEWORK_DEPS[templateArg]) return templateArg;
+	const answer = await p.select({
+		message: "Backend framework:",
+		options: FRAMEWORKS,
+		initialValue: "none"
+	});
+	if (p.isCancel(answer)) {
+		p.cancel("Cancelled");
+		process.exit(0);
+	}
+	return answer;
+}
+/** Asks the user to confirm before wiping a non-empty target directory. */
+async function confirmOverwrite(projectName, targetDir) {
+	if (isEmpty(targetDir)) return;
+	const overwrite = await p.confirm({ message: `${pc.yellow(projectName)} is not empty. Remove existing files and continue?` });
+	if (p.isCancel(overwrite) || !overwrite) {
+		p.cancel("Cancelled");
+		process.exit(0);
+	}
+	fs.rmSync(targetDir, {
+		recursive: true,
+		force: true
+	});
+}
+/** Copies the base template, sets the package name, and writes the framework starter code. */
+function scaffoldFiles(projectName, framework, targetDir) {
+	copyDir(path.join(__dirname, "..", "template"), targetDir);
+	const pkgJsonPath = path.join(targetDir, "package.json");
+	const pkg = JSON.parse(fs.readFileSync(pkgJsonPath, "utf-8"));
+	pkg.name = projectName;
+	fs.writeFileSync(pkgJsonPath, JSON.stringify(pkg, null, 2) + "\n");
+	fs.mkdirSync(path.join(targetDir, "src"), { recursive: true });
+	fs.writeFileSync(path.join(targetDir, "src", "index.ts"), FRAMEWORK_INDEX[framework]);
+}
+/** Installs shared dev dependencies and any framework-specific packages. */
+function installDependencies(pkgManager, framework, targetDir) {
+	p.log.step(`Installing dependencies with ${pkgManager}...`);
+	run(pkgManager, addArgs(pkgManager, [
+		"@types/node",
+		"oxfmt",
+		"oxlint",
+		"tsdown",
+		"tsx",
+		"typescript",
+		"vitest"
+	], true), { cwd: targetDir });
+	/** Install framework dependencies */
+	if (framework !== "none") {
+		p.log.step(`Installing ${framework}...`);
+		const frameworkDeps = FRAMEWORK_DEPS[framework];
+		if (frameworkDeps.deps.length > 0) run(pkgManager, addArgs(pkgManager, frameworkDeps.deps, false), { cwd: targetDir });
+		if (frameworkDeps.devDeps.length > 0) run(pkgManager, addArgs(pkgManager, frameworkDeps.devDeps, true), { cwd: targetDir });
+	}
+}
+/** Prints the gradient outro with next steps. */
+function showOutro(projectName, framework, pkgManager) {
+	const frameworkLabel = FRAMEWORKS.find((f) => f.value === framework)?.label ?? framework;
+	const outroStops = [[
+		168,
+		85,
+		247
+	], [
+		99,
+		102,
+		241
+	]];
+	const outroText = frameworkLabel !== "None" ? `Created ${projectName} with ${frameworkLabel}` : `Created ${projectName}`;
+	const nameStart = 8;
+	const outro = gradient(outroText, outroStops, [nameStart, nameStart + projectName.length]);
+	const devCmd = pkgManager === "npm" ? "npm run dev" : `${pkgManager} dev`;
+	p.outro(`${outro}\n\n  ${pc.dim("Now run:")}\n  cd ${projectName}\n  ${devCmd}`);
+}
+async function main() {
+	const argv = mri(process.argv.slice(2), {
+		string: ["template"],
+		alias: { t: "template" }
+	});
+	p.intro(pc.bold(gradient("planke - The Unified Toolchain Starter for Node.js", [
+		[
+			255,
+			255,
+			255
+		],
+		[
+			168,
+			85,
+			247
+		],
+		[
+			99,
+			102,
+			241
+		]
+	], [0, 6])));
+	const projectName = await promptProjectName(argv);
+	const framework = await promptFramework(argv);
+	const targetDir = path.resolve(process.cwd(), projectName);
+	const pkgManager = detectPkgManager();
+	await confirmOverwrite(projectName, targetDir);
+	scaffoldFiles(projectName, framework, targetDir);
+	run("git", [
+		"init",
+		"-b",
+		"main"
+	], {
+		cwd: targetDir,
+		stdio: "ignore"
+	});
+	p.log.step("Initializing git repository");
+	installDependencies(pkgManager, framework, targetDir);
+	p.log.step("Formatting code");
+	run(pkgManager, [
+		"exec",
+		"oxlint",
+		"--",
+		"--init"
+	], {
+		cwd: targetDir,
+		stdio: "ignore"
+	});
+	run(pkgManager, [
+		"exec",
+		"oxfmt",
+		"--",
+		"--init"
+	], {
+		cwd: targetDir,
+		stdio: "ignore"
+	});
+	run(pkgManager, ["exec", "oxfmt"], {
+		cwd: targetDir,
+		stdio: "ignore"
+	});
+	showOutro(projectName, framework, pkgManager);
+}
+main().catch((err) => {
+	console.error(err);
+	process.exit(1);
+});
+//#endregion
+export {};

package/package.json

@@ -0,0 +1,61 @@
+{
+  "name": "create-planke",
+  "version": "0.0.1",
+  "description": "The Unified Toolchain Starter for Node.js",
+  "keywords": [
+    "backend",
+    "create-planke",
+    "express",
+    "fastify",
+    "framework",
+    "hono",
+    "oxfmt",
+    "oxlint",
+    "planke",
+    "scaffolder",
+    "toolchain",
+    "tsdown",
+    "tsx",
+    "typescript",
+    "vite+",
+    "vite-plus",
+    "viteplus",
+    "vitest"
+  ],
+  "license": "MIT",
+  "author": "Espen Steen",
+  "bin": {
+    "create-planke": "./dist/index.mjs"
+  },
+  "files": [
+    "dist",
+    "template"
+  ],
+  "type": "module",
+  "dependencies": {
+    "@clack/prompts": "^1.1.0",
+    "cross-spawn": "^7.0.6",
+    "mri": "^1.2.0",
+    "picocolors": "^1.1.1"
+  },
+  "devDependencies": {
+    "@types/cross-spawn": "^6.0.6",
+    "@types/node": "^25.5.0",
+    "oxfmt": "^0.43.0",
+    "oxlint": "^1.58.0",
+    "tsdown": "^0.21.7",
+    "tsx": "^4.21.0",
+    "typescript": "^6.0.2",
+    "vitest": "^4.1.2"
+  },
+  "scripts": {
+    "test": "vitest",
+    "lint": "oxlint",
+    "lint:fix": "oxlint --fix",
+    "fmt": "oxfmt",
+    "fmt:check": "oxfmt --check",
+    "check": "oxlint && oxfmt --check && tsc --noEmit",
+    "dev": "tsx src/index.ts",
+    "build": "tsdown src/index.ts"
+  }
+}

package/template/package.json

@@ -0,0 +1,15 @@
+{
+  "name": "planke-project",
+  "version": "0.0.0",
+  "type": "module",
+  "scripts": {
+    "dev": "tsx src/index.ts",
+    "build": "tsdown src/index.ts",
+    "test": "vitest",
+    "lint": "oxlint",
+    "lint:fix": "oxlint --fix",
+    "fmt": "oxfmt",
+    "fmt:check": "oxfmt --check",
+    "check": "oxlint && oxfmt --check && tsc --noEmit"
+  }
+}

package/template/tsconfig.json

@@ -0,0 +1,14 @@
+{
+  "compilerOptions": {
+    "target": "ESNext",
+    "module": "NodeNext",
+    "strict": true,
+    "skipLibCheck": true,
+    "types": ["node"],
+    "verbatimModuleSyntax": true,
+    "noUnusedLocals": true,
+    "sourceMap": true,
+    "outDir": "./dist"
+  },
+  "exclude": ["node_modules"]
+}