@kevinmarrec/create-app 0.17.0 → 0.18.0

package/README.md

@@ -38,6 +38,8 @@ CLI that scaffolds an opinionated [Bun](https://bun.sh/) & [Vue](https://vuejs.o
 
 > Requires [Bun](https://bun.sh/) v1.3 _or later_.
 
+By default, the CLI scaffolds from its built-in opinionated template:
+
 ```sh
 bun create @kevinmarrec/app
 # OR
@@ -45,3 +47,25 @@ bunx @kevinmarrec/create-app
 ```
 
 After scaffolding, see the generated `README.md` in your project root for detailed setup instructions, including environment configuration, Docker setup, and development workflows.
+
+### Custom Template
+
+You can use the `--template` (`-t`) option to scaffold from any external git repository instead of the default template:
+
+```sh
+# GitHub shorthand
+bun create @kevinmarrec/app -t user/repo
+
+# HTTPS URL
+bun create @kevinmarrec/app -t https://github.com/user/repo.git
+
+# SSH URL
+bun create @kevinmarrec/app -t git@github.com:user/repo.git
+
+# Subdirectory of a repository
+bun create @kevinmarrec/app -t user/repo#path/to/template
+```
+
+The repository is cloned with `--depth 1` (shallow clone) and its contents are copied into the target directory.
+
+Use `#subdir` to scaffold from a specific subdirectory within the repository.

package/dist/index.mjs

@@ -3,12 +3,13 @@ import process from "node:process";
 import { parseArgs } from "node:util";
 import { cancel, confirm, intro, isCancel, log, note, outro, tasks, text } from "@clack/prompts";
 import c from "ansis";
-import { join, resolve } from "pathe";
+import { basename, join, resolve } from "pathe";
 import { x } from "tinyexec";
 import fs from "node:fs/promises";
+import os from "node:os";
 
 //#region package.json
-var version = "0.17.0";
+var version = "0.18.0";
 
 //#endregion
 //#region src/utils/fs.ts
@@ -31,11 +32,62 @@ var fs_default = {
 	exists
 };
 
+//#endregion
+//#region src/utils/template.ts
+function resolveTemplate(template) {
+	const [repo, ...rest] = template.split("#");
+	const subdir = rest.join("#") || void 0;
+	return {
+		url: resolveTemplateUrl(repo),
+		subdir
+	};
+}
+function resolveTemplateUrl(repo) {
+	if (repo.startsWith("https://")) return repo;
+	if (repo.startsWith("git@")) return repo;
+	if (/^[^/\s]+\/[^/\s]+$/.test(repo)) return `https://github.com/${repo}.git`;
+	throw new Error(`Invalid template format: "${repo}"`);
+}
+async function cloneTemplate(url) {
+	const tempDir = await fs_default.mkdtemp(join(os.tmpdir(), "create-app-template-"));
+	try {
+		await x("git", [
+			"clone",
+			"--depth",
+			"1",
+			url,
+			tempDir
+		]);
+	} catch (error) {
+		await fs_default.rm(tempDir, {
+			recursive: true,
+			force: true
+		});
+		throw new Error(`Failed to clone template from "${url}"`, { cause: error });
+	}
+	return tempDir;
+}
+
 //#endregion
 //#region src/scaffold.ts
-async function scaffold(root) {
+async function scaffold(root, template) {
 	await fs_default.exists(root) ? await fs_default.empty(root) : await fs_default.mkdir(root, { recursive: true });
-	await fs_default.cp(join(import.meta.dirname, "../template"), root, { recursive: true });
+	if (template) {
+		const { url, subdir } = resolveTemplate(template);
+		const tempDir = await cloneTemplate(url);
+		try {
+			const sourceDir = subdir ? join(tempDir, subdir) : tempDir;
+			await fs_default.cp(sourceDir, root, {
+				recursive: true,
+				filter: (src) => !ignorePredicate(basename(src))
+			});
+		} finally {
+			await fs_default.rm(tempDir, {
+				recursive: true,
+				force: true
+			});
+		}
+	} else await fs_default.cp(join(import.meta.dirname, "../template"), root, { recursive: true });
 }
 
 //#endregion
@@ -59,6 +111,10 @@ async function run() {
 				type: "boolean",
 				short: "h"
 			},
+			template: {
+				type: "string",
+				short: "t"
+			},
 			version: {
 				type: "boolean",
 				short: "v"
@@ -66,7 +122,7 @@ async function run() {
 		}
 	});
 	if (options.help) {
-		process.stdout.write("Usage: create-app [OPTIONS...] [DIRECTORY]\n\nOptions:\n  -f, --force     Create the project even if the directory is not empty.\n  -h, --help      Display this help message.\n  -v, --version   Display the version number of this CLI.\n");
+		process.stdout.write("Usage: create-app [OPTIONS...] [DIRECTORY]\n\nOptions:\n  -f, --force              Create the project even if the directory is not empty.\n  -h, --help               Display this help message.\n  -t, --template <repo>    Use a custom template from a git repository (supports #subdir).\n  -v, --version            Display the version number of this CLI.\n");
 		process.exit(0);
 	}
 	if (options.version) {
@@ -96,10 +152,10 @@ async function run() {
 		}), { strict: true });
 	}
 	await tasks([{
-		title: `Scaffolding project in ${c.blue(targetDir)}`,
+		title: options.template ? `Cloning ${c.blue(options.template)} into ${c.blue(targetDir)}` : `Scaffolding project in ${c.blue(targetDir)}`,
 		task: async () => {
-			await scaffold(targetDir);
-			return `Scaffolded project in ${c.blue(targetDir)}`;
+			await scaffold(targetDir, options.template);
+			return options.template ? `Cloned ${c.blue(options.template)} and scaffolded project in ${c.blue(targetDir)}` : `Scaffolded project in ${c.blue(targetDir)}`;
 		}
 	}]);
 	const shouldInstall = await confirm({
@@ -110,7 +166,7 @@ async function run() {
 	});
 	maybeCancel(shouldInstall);
 	await tasks([{
-		title: "Installing with bun",
+		title: "Installing dependencies",
 		enabled: shouldInstall,
 		task: async () => {
 			await x("bun", [
@@ -119,7 +175,7 @@ async function run() {
 				targetDir,
 				"--force"
 			]);
-			return "Installed with bun";
+			return "Installed dependencies";
 		}
 	}]);
 	await note([targetDir !== cwd && `cd ${c.reset.blue(projectName)}`, `bun run dev`].filter(Boolean).join("\n"), "Next steps");

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@kevinmarrec/create-app",
   "type": "module",
-  "version": "0.17.0",
+  "version": "0.18.0",
   "packageManager": "bun@1.3.9",
   "description": "CLI that scaffolds an opinionated Bun & Vue fullstack application.",
   "author": "Kevin Marrec <kevin@marrec.io>",
@@ -44,25 +44,25 @@
     "test:coverage": "vitest --coverage"
   },
   "dependencies": {
-    "@clack/prompts": "^1.0.1",
+    "@clack/prompts": "^1.1.0",
     "ansis": "^4.2.0",
     "pathe": "^2.0.3",
     "tinyexec": "^1.0.2"
   },
   "devDependencies": {
     "@faker-js/faker": "^10.3.0",
-    "@kevinmarrec/eslint-config": "^1.11.0",
-    "@kevinmarrec/stylelint-config": "^1.11.0",
-    "@kevinmarrec/tsconfig": "^1.11.0",
-    "@types/bun": "^1.3.9",
+    "@kevinmarrec/eslint-config": "^1.12.1",
+    "@kevinmarrec/stylelint-config": "^1.12.1",
+    "@kevinmarrec/tsconfig": "^1.12.1",
+    "@types/bun": "^1.3.10",
     "@vitest/coverage-v8": "^4.0.18",
     "bumpp": "^10.4.1",
-    "eslint": "^9.39.2",
-    "knip": "^5.84.1",
-    "stylelint": "^17.3.0",
+    "eslint": "^9.39.3",
+    "knip": "^5.85.0",
+    "stylelint": "^17.4.0",
     "tsdown": "^0.20.3",
     "typescript": "^5.9.3",
     "vitest": "^4.0.18",
-    "vue-tsc": "^3.2.4"
+    "vue-tsc": "^3.2.5"
   }
 }

package/template/.docker/mailpit/service.yml

@@ -1,7 +1,7 @@
 services:
   mailpit:
     profiles: [mail]
-    image: axllent/mailpit:v1.29.1
+    image: axllent/mailpit:v1.29.2
     container_name: mailpit
     depends_on:
       traefik:

package/template/.docker/metabase/service.yml

@@ -1,7 +1,7 @@
 services:
   metabase:
     profiles: [metabase]
-    image: metabase/metabase:v0.58.7
+    image: metabase/metabase:v0.59.1
     container_name: metabase
     depends_on:
       traefik:

package/template/.docker/postgres/service.yml

@@ -1,6 +1,6 @@
 services:
   postgres:
-    image: postgres:18.2-alpine
+    image: postgres:18.3-alpine
     container_name: postgres
     environment:
       - POSTGRES_USER=user

package/template/.docker/traefik/service.yml

@@ -1,6 +1,6 @@
 services:
   traefik:
-    image: traefik:v3.6.8
+    image: traefik:v3.6.9
     container_name: traefik
     restart: unless-stopped
     security_opt:

package/template/.github/renovate.json

@@ -1,9 +1,15 @@
 {
-  "$schema": "https://docs.renovatebot.com/renovate-schema.json",
-  "extends": ["github>kevinmarrec/renovate-config"],
+  "extends": ["github>kevinmarrec/config//packages/renovate/default"],
   "docker-compose": {
     "managerFilePatterns": [
       "/^\\.docker\\/[^/]*\\/service\\.ya?ml$/"
     ]
-  }
+  },
+  "packageRules": [
+    {
+      "matchDatasources": ["docker"],
+      "matchPackageNames": ["imbios/bun-node"],
+      "versioning": "regex:^(?<major>\\d+)\\.(?<minor>\\d+)\\.(?<patch>\\d+)-(?<compatibility>\\d+)\\.(?<build>\\d+\\.\\d+)-alpine$"
+    }
+  ]
 }

package/template/.github/workflows/ci.yml

@@ -14,7 +14,7 @@ jobs:
     runs-on: ubuntu-latest
     steps:
       - name: Setup Bun
-        uses: kevinmarrec/workflows/setup-bun@9d2e32941c6fbf76894926019c66ef428ddcc4d2 # main
+        uses: kevinmarrec/workflows/setup-bun@e2dafbacb91d9e74b79980f8f5a63dd20bf96619 # main
 
       - name: Lint
         run: bun run lint
@@ -32,12 +32,12 @@ jobs:
       pull-requests: write
     steps:
       - name: Setup Bun
-        uses: kevinmarrec/workflows/setup-bun@9d2e32941c6fbf76894926019c66ef428ddcc4d2 # main
+        uses: kevinmarrec/workflows/setup-bun@e2dafbacb91d9e74b79980f8f5a63dd20bf96619 # main
 
       - name: Build project
         run: bun run build
 
       - name: Analyze project build size differences
-        uses: kevinmarrec/workflows/filesize-diff@9d2e32941c6fbf76894926019c66ef428ddcc4d2 # main
+        uses: kevinmarrec/workflows/filesize-diff@e2dafbacb91d9e74b79980f8f5a63dd20bf96619 # main
         with:
           directories: app/dist,api/dist

package/template/.node-version

@@ -1 +1 @@
-24.13.1
+24.14.0

package/template/.vscode/settings.json

@@ -69,6 +69,13 @@
     "orpc": "context"
   },
 
+  "json.schemas": [
+    {
+      "fileMatch": ["renovate.json"],
+      "url": "https://docs.renovatebot.com/renovate-schema.json"
+    }
+  ],
+
   // i18n Ally
   "i18n-ally.enabledFrameworks": ["vue"],
   "i18n-ally.keystyle": "nested",

package/template/README.md

@@ -41,7 +41,7 @@ A full-stack application template with Vue.js frontend, Bun-based API backend, a
 
 ## Project Structure
 
-```
+```sh
 project/
 ├── api/                   # Backend API server
 │   ├── src/

package/template/api/Dockerfile

@@ -1,4 +1,4 @@
-FROM --platform=$BUILDPLATFORM oven/bun:1.3.9-slim AS build
+FROM --platform=$BUILDPLATFORM oven/bun:1.3.10-slim AS build
 
 ARG TARGETARCH
 

package/template/api/package.json

@@ -9,18 +9,19 @@
     "db:migrate": "bun --bun run drizzle-kit migrate --config src/database/drizzle/config.ts"
   },
   "dependencies": {
+    "@better-auth/drizzle-adapter": "^1.5.2",
     "@libsql/client": "^0.17.0",
-    "@orpc/server": "^1.13.5",
-    "better-auth": "^1.4.18",
+    "@orpc/server": "^1.13.6",
+    "better-auth": "^1.5.2",
     "drizzle-orm": "^0.45.1",
     "pino": "^10.3.1",
     "valibot": "^1.2.0"
   },
   "devDependencies": {
-    "@kevinmarrec/tsconfig": "^1.11.0",
-    "@types/bun": "^1.3.9",
+    "@kevinmarrec/tsconfig": "^1.12.1",
+    "@types/bun": "^1.3.10",
     "drizzle-kit": "^0.31.9",
-    "pg": "^8.18.0",
+    "pg": "^8.19.0",
     "pino-pretty": "^13.1.3",
     "typescript": "~5.9.3"
   }

package/template/api/src/auth/index.ts

@@ -1,5 +1,5 @@
-import { betterAuth } from 'better-auth'
-import { type DB, drizzleAdapter } from 'better-auth/adapters/drizzle'
+import { type DB, drizzleAdapter } from '@better-auth/drizzle-adapter'
+import { betterAuth } from 'better-auth/minimal'
 import type { Logger } from 'pino'
 
 import { env } from '../env'

package/template/app/Dockerfile

@@ -1,4 +1,4 @@
-FROM --platform=$BUILDPLATFORM imbios/bun-node:1.3.9-24.13.1-alpine AS build
+FROM --platform=$BUILDPLATFORM imbios/bun-node:1.3.10-24.14.0-alpine AS build
 
 ARG TARGETARCH
 

package/template/app/package.json

@@ -9,31 +9,31 @@
     "preview": "vite preview --open"
   },
   "dependencies": {
-    "@kevinmarrec/vue-i18n": "^1.2.1",
-    "@orpc/client": "^1.13.5",
-    "@orpc/vue-colada": "^1.13.5",
-    "@pinia/colada": "^0.21.4",
-    "@unhead/vue": "^2.1.4",
+    "@kevinmarrec/vue-i18n": "^1.2.2",
+    "@orpc/client": "^1.13.6",
+    "@orpc/vue-colada": "^1.13.6",
+    "@pinia/colada": "^0.21.7",
+    "@unhead/vue": "^2.1.10",
     "@vueuse/core": "^14.2.1",
-    "better-auth": "^1.4.18",
+    "better-auth": "^1.5.2",
     "pinia": "^3.0.4",
-    "unocss": "^66.6.0",
-    "vue": "^3.5.28"
+    "unocss": "^66.6.4",
+    "vue": "^3.5.29"
   },
   "devDependencies": {
-    "@kevinmarrec/tsconfig": "^1.11.0",
-    "@kevinmarrec/unocss-config": "^1.11.0",
-    "@kevinmarrec/vite-plugin-dark-mode": "^1.2.1",
+    "@kevinmarrec/tsconfig": "^1.12.1",
+    "@kevinmarrec/unocss-config": "^1.12.1",
+    "@kevinmarrec/vite-plugin-dark-mode": "^1.2.2",
     "@modyfi/vite-plugin-yaml": "^1.1.1",
-    "@unhead/addons": "^2.1.4",
+    "@unhead/addons": "^2.1.10",
     "@vitejs/plugin-vue": "^6.0.4",
     "beasties": "^0.4.1",
-    "rollup-plugin-visualizer": "^6.0.5",
+    "rollup-plugin-visualizer": "^7.0.1",
     "typescript": "~5.9.3",
     "valibot": "^1.2.0",
     "vite": "^7.3.1",
     "vite-plugin-valibot-env": "^1.0.1",
-    "vite-plugin-vue-devtools": "^8.0.6",
+    "vite-plugin-vue-devtools": "^8.0.7",
     "vite-ssg": "^28.3.0",
     "vite-tsconfig-paths": "^6.1.1"
   }

package/template/app/vite.config.ts

@@ -32,7 +32,7 @@ export default defineConfig(({ command, mode }) => {
     }),
     tsconfigPaths(),
     unhead(),
-    unocss(),
+    unocss(`${import.meta.dirname}/uno.config.ts`),
     valibot(envSchema),
     vue({
       features: {

package/template/compose.yml

@@ -16,7 +16,7 @@ services:
 
   api:
     <<: *common
-    image: oven/bun:1.3.9-alpine
+    image: oven/bun:1.3.10-alpine
     container_name: api
     init: true
     depends_on:
@@ -36,7 +36,7 @@ services:
 
   app:
     <<: *common
-    image: imbios/bun-node:1.3.9-24.13.1-alpine
+    image: imbios/bun-node:1.3.10-24.14.0-alpine
     container_name: app
     init: true
     depends_on:

package/template/package.json

@@ -4,7 +4,7 @@
   "private": true,
   "packageManager": "bun@1.3.9",
   "engines": {
-    "node": ">=24.13.1"
+    "node": ">=24.14.0"
   },
   "workspaces": [
     "api",
@@ -23,13 +23,13 @@
     "update": "bunx taze -I -rwi"
   },
   "devDependencies": {
-    "@kevinmarrec/eslint-config": "^1.11.0",
-    "@kevinmarrec/stylelint-config": "^1.11.0",
-    "@kevinmarrec/tsconfig": "^1.11.0",
-    "eslint": "^9.39.2",
-    "knip": "^5.84.1",
-    "stylelint": "^17.3.0",
+    "@kevinmarrec/eslint-config": "^1.12.1",
+    "@kevinmarrec/stylelint-config": "^1.12.1",
+    "@kevinmarrec/tsconfig": "^1.12.1",
+    "eslint": "^9.39.3",
+    "knip": "^5.85.0",
+    "stylelint": "^17.4.0",
     "typescript": "~5.9.3",
-    "vue-tsc": "^3.2.4"
+    "vue-tsc": "^3.2.5"
   }
 }

package/template/tsconfig.json

@@ -1,3 +1,9 @@
 {
-  "extends": "@kevinmarrec/tsconfig"
+  "extends": "@kevinmarrec/tsconfig",
+  "compilerOptions": {
+    "paths": {
+      "~/api/*": ["./api/src/*"],
+      "~/app/*": ["./app/src/*"]
+    }
+  }
 }