@kevinmarrec/create-app 0.10.1 → 0.12.0

package/README.md

@@ -2,17 +2,41 @@
 
 ## Description
 
-CLI that scaffolds an opinionated [Bun](https://bun.sh) & [Vue](https://vuejs.org) fullstack application.
+CLI that scaffolds an opinionated [Bun](https://bun.sh/) & [Vue](https://vuejs.org/) fullstack application.
 
 ## Opinions
 
-- [Bun](https://bun.sh) as package manager & runtime
-
-- [Vue](https://vuejs.org) as frontend framework
+### Core Stack
+
+- [Bun](https://bun.sh/) as package manager & runtime
+- [TypeScript](https://www.typescriptlang.org/) as the language
+- [Vue 3](https://vuejs.org/) as frontend framework
+- [Vite](https://vitejs.dev/) as build tool
+- [Vite SSG](https://github.com/antfu-collective/vite-ssg) for static site generation
+- [UnoCSS](https://unocss.dev/) for styling
+- [TanStack Query](https://tanstack.com/query/latest) for data fetching
+- [Unhead](https://unhead.unjs.io/) for head management
+- [Vue I18n](https://github.com/kevinmarrec/vue-i18n) for internationalization
+- [oRPC](https://orpc.dev/) for API layer
+- [Better Auth](https://www.better-auth.com/) for authentication
+- [Pino](https://getpino.io/) for logging
+- [Drizzle ORM](https://orm.drizzle.team/) as SQL-first TypeScript ORM
+- [Valibot](https://valibot.dev/) for validation
+- [PostgreSQL](https://www.postgresql.org/) as database
+- [Docker Compose](https://docs.docker.com/compose/) & [Traefik](https://traefik.io/) for infrastructure
+
+### Development Tools
+
+- [ESLint](https://eslint.org/) & [Stylelint](https://stylelint.io/) for linting
+- [Knip](https://knip.dev/) for detecting unused dependencies, exports, and files
+- [Metabase](https://www.metabase.com/) for Business Intelligence (BI)
+- [Drizzle Studio](https://gateway.drizzle.team/) for database management (web GUI)
+- [Umami](https://umami.is/) for web analytics
+- [Mailpit](https://mailpit.axllent.org/) for email testing
 
 ## Usage
 
-> Requires [Bun](https://bun.sh) v1.3 _or later_.
+> Requires [Bun](https://bun.sh/) v1.3 _or later_.
 
 ```sh
 bun create @kevinmarrec/app

package/dist/index.js

@@ -8,11 +8,12 @@ import { x } from "tinyexec";
 import fs from "node:fs/promises";
 
 //#region package.json
-var version = "0.10.1";
+var version = "0.12.0";
 
 //#endregion
 //#region src/utils/fs.ts
-const ignorePredicate = (filename) => [".git"].includes(filename);
+const IGNORED_FILES = new Set([".git"]);
+const ignorePredicate = (filename) => IGNORED_FILES.has(filename);
 async function empty(dir) {
 	const entries = await fs.readdir(dir);
 	await Promise.all(entries.filter((entry) => !ignorePredicate(entry)).map((entry) => fs.rm(resolve(dir, entry), { recursive: true })));
@@ -33,7 +34,7 @@ var fs_default = {
 //#endregion
 //#region src/scaffold.ts
 async function scaffold(root) {
-	await fs_default.exists(root) ? await fs_default.empty(root) : await fs_default.mkdir(root);
+	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 });
 }
 
@@ -65,14 +66,7 @@ async function run() {
 		}
 	});
 	if (options.help) {
-		process.stdout.write(`\
-Usage: create-app [OPTIONS...] [DIRECTORY]
-
-Options:
-  -f, --force     Create the project even if the directory is not empty.
-  -h, --help      Display this help message.
-  -v, --version       Display the version number of this CLI.
-`);
+		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.exit(0);
 	}
 	if (options.version) {
@@ -81,7 +75,7 @@ Options:
 	}
 	process.stdout.write("\n");
 	intro(`create-app ${c.dim(`v${version}`)}`);
-	let projectName = positionals[0] || await text({
+	let projectName = positionals[0]?.trim() || await text({
 		message: "Project name",
 		placeholder: "my-app",
 		validate: (value) => {
@@ -92,7 +86,7 @@ Options:
 	projectName = projectName.trim();
 	const cwd = process.cwd();
 	const targetDir = resolve(cwd, projectName);
-	if (!(await fs_default.emptyCheck(targetDir) || options.force)) {
+	if (!options.force && !await fs_default.emptyCheck(targetDir)) {
 		await log.warn(`${targetDir === cwd ? "Current directory" : `Target directory ${c.blue(targetDir)}`} is not empty`);
 		maybeCancel(await confirm({
 			message: "Remove existing files and continue?",
@@ -136,6 +130,7 @@ Options:
 //#region src/index.ts
 run().catch((error) => {
 	console.error(error);
+	process.exitCode = 1;
 });
 
 //#endregion

package/package.json

@@ -1,8 +1,8 @@
 {
   "name": "@kevinmarrec/create-app",
   "type": "module",
-  "version": "0.10.1",
-  "packageManager": "bun@1.3.2",
+  "version": "0.12.0",
+  "packageManager": "bun@1.3.3",
   "description": "CLI that scaffolds an opinionated Bun & Vue fullstack application.",
   "author": "Kevin Marrec <kevin@marrec.io>",
   "license": "MIT",
@@ -53,18 +53,18 @@
   },
   "devDependencies": {
     "@faker-js/faker": "^10.1.0",
-    "@kevinmarrec/eslint-config": "^1.5.6",
-    "@kevinmarrec/stylelint-config": "^1.5.6",
-    "@kevinmarrec/tsconfig": "^1.5.6",
-    "@types/bun": "^1.3.2",
-    "@vitest/coverage-v8": "^4.0.9",
-    "bumpp": "^10.3.1",
+    "@kevinmarrec/eslint-config": "^1.5.8",
+    "@kevinmarrec/stylelint-config": "^1.5.8",
+    "@kevinmarrec/tsconfig": "^1.5.8",
+    "@types/bun": "^1.3.3",
+    "@vitest/coverage-v8": "^4.0.14",
+    "bumpp": "^10.3.2",
     "eslint": "^9.39.1",
-    "knip": "^5.69.1",
-    "stylelint": "^16.25.0",
-    "tsdown": "^0.16.4",
+    "knip": "^5.70.2",
+    "stylelint": "^16.26.1",
+    "tsdown": "^0.16.8",
     "typescript": "^5.9.3",
-    "vitest": "^4.0.9",
-    "vue-tsc": "^3.1.4"
+    "vitest": "^4.0.14",
+    "vue-tsc": "^3.1.5"
   }
 }

package/template/.docker/analytics/service.yaml

@@ -0,0 +1,22 @@
+services:
+  analytics:
+    image: umamisoftware/umami:3.0.1
+    container_name: analytics
+    depends_on:
+      traefik:
+        condition: service_healthy
+      postgres:
+        condition: service_healthy
+    environment:
+      - DATABASE_URL=postgresql://user:password@postgres:5432/analytics
+    healthcheck:
+      test: [CMD-SHELL, curl -f http://localhost:3000]
+      interval: 1s
+      timeout: 1s
+      retries: 20
+    labels:
+      traefik.enable: 'true'
+      traefik.http.routers.analytics.rule: Host(`analytics.dev.localhost`)
+      traefik.http.routers.analytics.entrypoints: websecure
+      traefik.http.routers.analytics.tls: 'true'
+      traefik.http.services.analytics.loadbalancer.server.port: '3000'

package/template/.docker/mailpit/service.yaml

@@ -0,0 +1,13 @@
+services:
+  mailpit:
+    image: axllent/mailpit:v1.28.0
+    container_name: mailpit
+    depends_on:
+      traefik:
+        condition: service_healthy
+    labels:
+      traefik.enable: 'true'
+      traefik.http.routers.mailpit.rule: Host(`mail.dev.localhost`)
+      traefik.http.routers.mailpit.entrypoints: websecure
+      traefik.http.routers.mailpit.tls: 'true'
+      traefik.http.services.mailpit.loadbalancer.server.port: '8025'

package/template/.docker/metabase/service.yaml

@@ -0,0 +1,27 @@
+services:
+  metabase:
+    image: metabase/metabase:v0.57.4
+    container_name: metabase
+    depends_on:
+      traefik:
+        condition: service_healthy
+    environment:
+      - MB_DB_TYPE=h2
+      - MB_DB_FILE=/var/lib/metabase/metabase.db
+      - MB_SITE_URL=https://metabase.dev.localhost
+    volumes:
+      - metabase_data:/var/lib/metabase
+    healthcheck:
+      test: [CMD-SHELL, curl -f http://localhost:3000/api/health]
+      interval: 1s
+      timeout: 1s
+      retries: 20
+    labels:
+      traefik.enable: 'true'
+      traefik.http.routers.metabase.rule: Host(`metabase.dev.localhost`)
+      traefik.http.routers.metabase.entrypoints: websecure
+      traefik.http.routers.metabase.tls: 'true'
+      traefik.http.services.metabase.loadbalancer.server.port: '3000'
+
+volumes:
+  metabase_data:

package/template/.docker/postgres/init.sql

@@ -0,0 +1,5 @@
+-- Main database
+CREATE DATABASE app;
+
+-- Analytics database
+CREATE DATABASE analytics;

package/template/.docker/postgres/service.yaml

@@ -0,0 +1,20 @@
+services:
+  postgres:
+    image: postgres:18.1-alpine
+    container_name: postgres
+    environment:
+      - POSTGRES_USER=user
+      - POSTGRES_PASSWORD=password
+    ports:
+      - 5432:5432
+    volumes:
+      - postgres_data:/var/lib/postgresql/data
+      - ./init.sql:/docker-entrypoint-initdb.d/init.sql
+    healthcheck:
+      test: [CMD-SHELL, "psql postgresql://user:password@postgres:5432/app -c 'SELECT 1' 2> /dev/null"]
+      interval: 1s
+      timeout: 1s
+      retries: 20
+
+volumes:
+  postgres_data:

package/template/.docker/studio/service.yaml

@@ -0,0 +1,22 @@
+services:
+  studio:
+    image: ghcr.io/drizzle-team/gateway:1.1.1
+    container_name: studio
+    depends_on:
+      traefik:
+        condition: service_healthy
+      postgres:
+        condition: service_healthy
+    environment:
+      - MASTERPASS=foobar
+    volumes:
+      - studio_data:/app
+    labels:
+      traefik.enable: 'true'
+      traefik.http.routers.studio.rule: Host(`studio.dev.localhost`)
+      traefik.http.routers.studio.entrypoints: websecure
+      traefik.http.routers.studio.tls: 'true'
+      traefik.http.services.studio.loadbalancer.server.port: '4983'
+
+volumes:
+  studio_data:

package/template/.docker/traefik/service.yaml

@@ -0,0 +1,41 @@
+services:
+  traefik:
+    image: traefik:v3.6.2
+    container_name: traefik
+    restart: unless-stopped
+    security_opt:
+      - no-new-privileges:true
+    command:
+      # General configuration
+      - --api.dashboard=true
+      - --ping=true
+      - --log.level=INFO
+      # Entrypoints for HTTP and HTTPS
+      - --entrypoints.websecure.address=:443
+      - --entrypoints.web.address=:80
+      # Redirect HTTP to HTTPS
+      - --entrypoints.web.http.redirections.entrypoint.to=websecure
+      - --entrypoints.web.http.redirections.entrypoint.scheme=https
+      # Providers (Docker & File for dynamic config)
+      - --providers.docker=true
+      - --providers.docker.exposedbydefault=false
+      - --providers.file.directory=/etc/traefik/dynamic
+      - --providers.file.watch=true
+    ports:
+      - 80:80
+      - 443:443
+    volumes:
+      - /var/run/docker.sock:/var/run/docker.sock:ro
+      - ./dynamic:/etc/traefik/dynamic:ro # Mount the dynamic config directory
+      - ./certs:/certs:ro # Mount the certs directory
+    healthcheck:
+      test: [CMD-SHELL, traefik healthcheck --ping]
+      interval: 1s
+      timeout: 1s
+      retries: 20
+    labels:
+      traefik.enable: 'true'
+      traefik.http.routers.traefik.rule: Host(`traefik.dev.localhost`)
+      traefik.http.routers.traefik.entrypoints: websecure
+      traefik.http.routers.traefik.tls: 'true'
+      traefik.http.routers.traefik.service: api@internal

package/template/.github/renovate.json

@@ -1,4 +1,9 @@
 {
   "$schema": "https://docs.renovatebot.com/renovate-schema.json",
-  "extends": ["github>kevinmarrec/renovate-config"]
+  "extends": ["github>kevinmarrec/renovate-config"],
+  "docker-compose": {
+    "managerFilePatterns": [
+      "/^\\.docker\\/[^/]*\\/service\\.ya?ml$/"
+    ]
+  }
 }

package/template/.vscode/settings.json

@@ -39,7 +39,8 @@
     "markdown",
     "json",
     "jsonc",
-    "yaml"
+    "yaml",
+    "dockercompose"
   ],
 
   "css.validate": false,
@@ -51,10 +52,6 @@
     "vue"
   ],
 
-  "material-icon-theme.folders.associations": {
-    "orpc": "context"
-  },
-
   "javascript.format.semicolons": "remove",
   "javascript.preferences.quoteStyle": "single",
   "typescript.format.semicolons": "remove",
@@ -63,6 +60,14 @@
   "vue.inlayHints.inlineHandlerLeading": true,
   "vue.inlayHints.missingProps": true,
 
+  "files.associations": {
+    "**/.docker/*/service.yaml": "dockercompose"
+  },
+
+  "material-icon-theme.folders.associations": {
+    "orpc": "context"
+  },
+
   // i18n Ally
   "i18n-ally.enabledFrameworks": ["vue"],
   "i18n-ally.keystyle": "nested",