create-win-project 1.3.0

package/templates/agents/react-vite.md

@@ -0,0 +1,48 @@
+# AGENTS.md
+
+> Small operating contract for agents. Project intent lives in `CONTEXT.md`; task guidance is routed through `RULES.md`.
+
+## Project
+
+{{PROJECT_NAME}} — {{PROJECT_DESCRIPTION}}
+
+- Stack: `{{STACK}}`
+- Platform: `{{PLATFORM}}`
+
+## Commands
+
+Run frontend commands from `frontend/`.
+
+- Install: `npm install` initially; use `npm ci` after committing the lockfile.
+- Develop: `npm run dev`
+- Validate: `npm run lint && npm run typecheck && npm run test --if-present && npm run build`
+- End-to-end: `npm run test:e2e --if-present`
+- Spring backend, when present: `cd backend && ./mvnw --batch-mode test` (`mvnw.cmd` on Windows)
+
+## Required workflow
+
+1. Read `CONTEXT.md` and inspect neighboring implementation and tests.
+2. Find the concern in `RULES.md`; open only its linked playbook section.
+3. State assumptions when behavior is ambiguous.
+4. Make the smallest coherent change and add risk-appropriate tests.
+5. Run lint, typecheck, relevant tests, and a production build.
+
+## Always-on constraints
+
+{{CONSTRAINTS}}
+
+- Treat all SPA code and public-prefixed environment values as user-visible.
+- Validate input and authorize on the server; route guards are only user experience.
+- Never put session IDs or access/refresh tokens in browser web storage.
+
+## Authority boundaries
+
+- Do not deploy, publish, merge, push, or modify production data unless explicitly asked.
+- Do not delete user work or weaken checks to make a task pass.
+
+## Definition of done
+
+- Acceptance behavior and risk-appropriate tests are present.
+- Validation commands pass, or the exact blocker is reported.
+- Loading, empty, error, keyboard, and narrow-screen behavior are considered.
+- Relevant docs are updated.

package/templates/docker/compose/postgres.yml

@@ -0,0 +1,29 @@
+# docker-compose.yml — {{PROJECT_NAME}} ({{STACK}}) — Dev (Postgres only)
+services:
+
+  db:
+    container_name: {{PROJECT_NAME}}-db
+    image: {{POSTGRES_IMAGE}}
+    ports:
+      - "5432:5432"
+    environment:
+      - POSTGRES_USER=${POSTGRES_USER}
+      - POSTGRES_PASSWORD=${POSTGRES_PASSWORD}
+      - POSTGRES_DB=${POSTGRES_DB}
+    volumes:
+      - postgres-data:/var/lib/postgresql/data
+    networks:
+      - app-network
+    healthcheck:
+      test: ["CMD-SHELL", "pg_isready -U ${POSTGRES_USER} -d ${POSTGRES_DB}"]
+      interval: 10s
+      timeout: 5s
+      retries: 5
+
+volumes:
+  postgres-data:
+    name: {{PROJECT_NAME}}-postgres-data
+
+networks:
+  app-network:
+    name: {{PROJECT_NAME}}-network

package/templates/docker/compose/springboot.yml

@@ -0,0 +1,69 @@
+# docker-compose.yml — {{PROJECT_NAME}} ({{STACK}}) — Dev
+services:
+
+  frontend:
+    container_name: {{PROJECT_NAME}}-frontend
+    build:
+      context: {{FRONTEND_DIR}}
+      dockerfile: {{FRONTEND_DOCKERFILE}}
+    ports:
+      - "{{FRONTEND_PORT}}:{{FRONTEND_PORT}}"
+    volumes:
+      - ./{{FRONTEND_DIR}}:/app
+      - /app/node_modules
+    environment:
+      - {{ENV_PREFIX}}API_URL=${{ENV_PREFIX}}API_URL
+    depends_on:
+      - backend
+    networks:
+      - app-network
+
+  backend:
+    container_name: {{PROJECT_NAME}}-backend
+    build:
+      context: ./backend
+      dockerfile: Dockerfile.dev
+    ports:
+      - "8080:8080"
+    volumes:
+      - ./backend:/app
+      - maven-cache:/root/.m2
+    environment:
+      - SPRING_PROFILES_ACTIVE=dev
+      - DATABASE_URL=jdbc:postgresql://db:5432/${POSTGRES_DB}
+      - POSTGRES_USER=${POSTGRES_USER}
+      - POSTGRES_PASSWORD=${POSTGRES_PASSWORD}
+    depends_on:
+      db:
+        condition: service_healthy
+    networks:
+      - app-network
+
+  db:
+    container_name: {{PROJECT_NAME}}-db
+    image: {{POSTGRES_IMAGE}}
+    ports:
+      - "5432:5432"
+    environment:
+      - POSTGRES_USER=${POSTGRES_USER}
+      - POSTGRES_PASSWORD=${POSTGRES_PASSWORD}
+      - POSTGRES_DB=${POSTGRES_DB}
+    volumes:
+      - postgres-data:/var/lib/postgresql/data
+    networks:
+      - app-network
+    healthcheck:
+      test: ["CMD-SHELL", "pg_isready -U ${POSTGRES_USER} -d ${POSTGRES_DB}"]
+      interval: 10s
+      timeout: 5s
+      retries: 5
+
+volumes:
+  postgres-data:
+    name: {{PROJECT_NAME}}-postgres-data
+  maven-cache:
+    name: {{PROJECT_NAME}}-maven-cache
+
+networks:
+  app-network:
+    name: {{PROJECT_NAME}}-network

package/templates/docker/compose/supabase.yml

@@ -0,0 +1,18 @@
+# docker-compose.yml — {{PROJECT_NAME}} ({{STACK}}) — application + managed Supabase
+services:
+  frontend:
+    container_name: {{PROJECT_NAME}}-frontend
+    build:
+      context: {{FRONTEND_DIR}}
+      dockerfile: {{FRONTEND_DOCKERFILE}}
+    ports:
+      - "{{FRONTEND_PORT}}:{{FRONTEND_PORT}}"
+    volumes:
+      - ./{{FRONTEND_DIR}}:/app
+      - /app/node_modules
+    environment:
+      - {{ENV_PREFIX}}SUPABASE_URL=${{ENV_PREFIX}}SUPABASE_URL
+      - {{ENV_PREFIX}}SUPABASE_PUBLISHABLE_KEY=${{ENV_PREFIX}}SUPABASE_PUBLISHABLE_KEY
+
+# The Supabase platform is managed separately. Use `supabase start` for the
+# official local stack instead of approximating it with a bare PostgreSQL image.

package/templates/docker/compose-prod/springboot.yml

@@ -0,0 +1,64 @@
+# docker-compose.prod.yml — {{PROJECT_NAME}} ({{STACK}}) — Prod
+services:
+
+  frontend:
+    container_name: {{PROJECT_NAME}}-frontend-prod
+    build:
+      context: {{FRONTEND_DIR}}
+      dockerfile: {{FRONTEND_DOCKERFILE_PROD}}
+      target: production
+    ports:
+      - "{{FRONTEND_PROD_PORT}}"
+    environment:
+      - {{ENV_PREFIX}}API_URL=${{ENV_PREFIX}}API_URL
+    depends_on:
+      - backend
+    networks:
+      - app-network
+    restart: always
+
+  backend:
+    container_name: {{PROJECT_NAME}}-backend-prod
+    build:
+      context: ./backend
+      dockerfile: Dockerfile
+      target: production
+    ports:
+      - "8080:8080"
+    environment:
+      - SPRING_PROFILES_ACTIVE=prod
+      - DATABASE_URL=jdbc:postgresql://db:5432/${POSTGRES_DB}
+      - POSTGRES_USER=${POSTGRES_USER}
+      - POSTGRES_PASSWORD=${POSTGRES_PASSWORD}
+    depends_on:
+      db:
+        condition: service_healthy
+    networks:
+      - app-network
+    restart: always
+
+  db:
+    container_name: {{PROJECT_NAME}}-db-prod
+    image: {{POSTGRES_IMAGE}}
+    environment:
+      - POSTGRES_USER=${POSTGRES_USER}
+      - POSTGRES_PASSWORD=${POSTGRES_PASSWORD}
+      - POSTGRES_DB=${POSTGRES_DB}
+    volumes:
+      - postgres-data-prod:/var/lib/postgresql/data
+    networks:
+      - app-network
+    restart: always
+    healthcheck:
+      test: ["CMD-SHELL", "pg_isready -U ${POSTGRES_USER} -d ${POSTGRES_DB}"]
+      interval: 10s
+      timeout: 5s
+      retries: 5
+
+volumes:
+  postgres-data-prod:
+    name: {{PROJECT_NAME}}-postgres-data-prod
+
+networks:
+  app-network:
+    name: {{PROJECT_NAME}}-network-prod

package/templates/docker/dockerfile/laravel-inertia.dev.dockerfile

@@ -0,0 +1,21 @@
+FROM {{NODE_IMAGE}} AS assets
+WORKDIR /app
+COPY package*.json ./
+RUN npm install
+COPY resources ./resources
+COPY vite.config.js ./
+RUN npm run build
+
+FROM {{COMPOSER_IMAGE}} AS composer
+
+FROM {{PHP_IMAGE}}
+RUN apk add --no-cache libpq-dev && docker-php-ext-install pdo_pgsql
+WORKDIR /app
+COPY --from=composer /usr/bin/composer /usr/local/bin/composer
+COPY composer.json ./
+RUN composer install --no-interaction --prefer-dist --no-scripts
+COPY . .
+COPY --from=assets /app/public/build ./public/build
+RUN composer dump-autoload --optimize
+EXPOSE 8000
+CMD ["php", "artisan", "serve", "--host=0.0.0.0", "--port=8000"]

package/templates/docker/dockerfile/laravel.dev.dockerfile

@@ -0,0 +1,12 @@
+FROM {{COMPOSER_IMAGE}} AS composer
+
+FROM {{PHP_IMAGE}}
+RUN apk add --no-cache libpq-dev && docker-php-ext-install pdo_pgsql
+WORKDIR /app
+COPY --from=composer /usr/bin/composer /usr/local/bin/composer
+COPY composer.json ./
+RUN composer install --no-interaction --prefer-dist --no-scripts
+COPY . .
+RUN composer dump-autoload --optimize
+EXPOSE 8000
+CMD ["php", "artisan", "serve", "--host=0.0.0.0", "--port=8000"]

package/templates/docker/dockerfile/laravel.prod.dockerfile

@@ -0,0 +1,13 @@
+FROM {{COMPOSER_IMAGE}} AS composer
+
+FROM {{PHP_IMAGE}} AS production
+RUN apk add --no-cache libpq-dev && docker-php-ext-install pdo_pgsql
+WORKDIR /app
+COPY --from=composer /usr/bin/composer /usr/local/bin/composer
+COPY composer.json ./
+RUN composer install --no-dev --no-interaction --prefer-dist --optimize-autoloader --no-scripts
+COPY . .
+RUN composer dump-autoload --classmap-authoritative
+USER www-data
+EXPOSE 8000
+CMD ["php", "artisan", "serve", "--host=0.0.0.0", "--port=8000"]

package/templates/docker/dockerfile/nextjs.dev.dockerfile

@@ -0,0 +1,6 @@
+FROM {{NODE_IMAGE}}
+WORKDIR /app
+COPY package*.json ./
+RUN npm ci
+EXPOSE {{FRONTEND_PORT}}
+CMD ["npm", "run", "dev"]

package/templates/docker/dockerfile/nextjs.prod.dockerfile

@@ -0,0 +1,18 @@
+FROM {{NODE_IMAGE}} AS builder
+WORKDIR /app
+COPY package*.json ./
+RUN npm ci
+RUN mkdir -p public
+COPY . .
+ARG DATABASE_URL=postgresql://dummy:dummy@localhost:5432/dummy
+ENV DATABASE_URL=$DATABASE_URL
+RUN npm run build
+
+FROM {{NODE_IMAGE}} AS production
+WORKDIR /app
+ENV NODE_ENV=production
+COPY --from=builder /app/.next/standalone ./
+COPY --from=builder /app/.next/static ./.next/static
+COPY --from=builder /app/public ./public
+EXPOSE {{FRONTEND_PORT}}
+CMD ["node", "server.js"]

package/templates/docker/dockerfile/springboot.dev.dockerfile

@@ -0,0 +1,5 @@
+FROM {{MAVEN_IMAGE}}
+WORKDIR /app
+COPY . .
+EXPOSE 8080
+CMD ["mvn", "spring-boot:run"]

package/templates/docker/dockerfile/springboot.prod.dockerfile

@@ -0,0 +1,10 @@
+FROM {{MAVEN_IMAGE}} AS builder
+WORKDIR /app
+COPY . .
+RUN mvn --batch-mode package -DskipTests
+
+FROM {{JAVA_IMAGE}} AS production
+WORKDIR /app
+COPY --from=builder /app/target/*.jar app.jar
+EXPOSE 8080
+CMD ["java", "-jar", "app.jar"]

package/templates/docker/dockerfile/vite.dev.dockerfile

@@ -0,0 +1,6 @@
+FROM {{NODE_IMAGE}}
+WORKDIR /app
+COPY package*.json ./
+RUN npm ci
+EXPOSE 5173
+CMD ["npm", "run", "dev", "--", "--host"]

package/templates/docker/dockerfile/vite.prod.dockerfile

@@ -0,0 +1,12 @@
+FROM {{NODE_IMAGE}} AS builder
+WORKDIR /app
+COPY package*.json ./
+RUN npm ci
+COPY . .
+RUN npm run build
+
+FROM {{NGINX_IMAGE}} AS production
+COPY --from=builder /app/dist /usr/share/nginx/html
+COPY nginx.conf /etc/nginx/conf.d/default.conf
+EXPOSE 80
+CMD ["nginx", "-g", "daemon off;"]

package/templates/gitignore/base.gitignore

@@ -0,0 +1,32 @@
+# Environment
+.env
+.env.local
+.env.production
+.env.*.local
+
+# Dependencies
+node_modules/
+
+# IDE
+.idea/
+.vscode/
+*.iml
+*.suo
+*.user
+
+# OS
+.DS_Store
+Thumbs.db
+
+# Logs
+*.log
+logs/
+npm-debug.log*
+
+# Testing
+coverage/
+playwright-report/
+test-results/
+
+# Docker volumes
+postgres-data/

package/templates/gitignore/nextjs.gitignore

@@ -0,0 +1,40 @@
+# Environment
+.env
+.env.local
+.env.production
+.env.*.local
+
+# Dependencies
+node_modules/
+
+# Build outputs
+.next/
+out/
+src/generated/prisma/
+
+# IDE
+.idea/
+.vscode/
+*.iml
+*.suo
+*.user
+
+# OS
+.DS_Store
+Thumbs.db
+
+# Logs
+*.log
+logs/
+npm-debug.log*
+
+# Testing
+coverage/
+playwright-report/
+test-results/
+
+# Docker volumes
+postgres-data/
+
+# Supabase
+.supabase/

package/templates/gitignore/react-native.gitignore

@@ -0,0 +1,43 @@
+# Environment
+.env
+.env.local
+.env.production
+.env.*.local
+
+# Dependencies
+node_modules/
+
+# Expo
+.expo/
+dist/
+web-build/
+
+# Native
+*.orig.*
+*.jks
+*.p8
+*.p12
+*.key
+*.mobileprovision
+
+# Metro
+.metro-health-check*
+
+# IDE
+.idea/
+.vscode/
+*.iml
+*.suo
+*.user
+
+# OS
+.DS_Store
+Thumbs.db
+
+# Logs
+*.log
+logs/
+npm-debug.log*
+
+# Testing
+coverage/

package/templates/gitignore/react-vite.gitignore

@@ -0,0 +1,39 @@
+# Environment
+.env
+.env.local
+.env.production
+.env.*.local
+
+# Dependencies
+node_modules/
+
+# Build outputs
+dist/
+build/
+
+# IDE
+.idea/
+.vscode/
+*.iml
+*.suo
+*.user
+
+# OS
+.DS_Store
+Thumbs.db
+
+# Logs
+*.log
+logs/
+npm-debug.log*
+
+# Testing
+coverage/
+playwright-report/
+test-results/
+
+# Docker volumes
+postgres-data/
+
+# Supabase
+.supabase/

package/templates/makefile/frontend.mk

@@ -0,0 +1,31 @@
+# Makefile — {{PROJECT_NAME}} frontend-only convenience aliases
+# Make is optional; every target delegates to cross-platform npm scripts.
+
+NPM_DIR := {{FRONTEND_DIR}}
+
+.DEFAULT_GOAL := help
+.PHONY: help install dev build lint format check test
+
+help: ## Show available commands
+	@grep -E '^[a-zA-Z_-]+:.*?## .*$$' $(MAKEFILE_LIST) | awk 'BEGIN {FS = ":.*?## "}; {printf "\033[36m%-16s\033[0m %s\n", $$1, $$2}'
+
+install: ## Install exact dependencies from the lockfile
+	npm --prefix $(NPM_DIR) ci
+
+dev: ## Start the frontend development server
+	npm --prefix $(NPM_DIR) run dev
+
+build: ## Build for production
+	npm --prefix $(NPM_DIR) run build
+
+lint: ## Run ESLint when supported
+	npm --prefix $(NPM_DIR) run lint --if-present
+
+format: ## Format files with the project-local Prettier
+	npm --prefix $(NPM_DIR) run format
+
+check: ## Run the generated quality checks
+	npm --prefix $(NPM_DIR) run check
+
+test: ## Run tests when configured
+	npm --prefix $(NPM_DIR) run test --if-present

package/templates/makefile/laravel.mk

@@ -0,0 +1,47 @@
+COMPOSE := docker compose
+LARAVEL := $(COMPOSE) exec backend
+
+.DEFAULT_GOAL := help
+
+.PHONY: help setup build run dev stop logs test format analyse migrate shell clean
+help: ## Show available commands
+	@grep -E '^[a-zA-Z_-]+:.*?## .*$$' $(MAKEFILE_LIST) | awk 'BEGIN {FS = ":.*?## "}; {printf "\033[36m%-16s\033[0m %s\n", $$1, $$2}'
+
+setup: ## First run: build, start, create key, and migrate
+	$(COMPOSE) build
+	$(COMPOSE) up -d
+	$(LARAVEL) php artisan key:generate
+	$(LARAVEL) php artisan migrate
+
+build: ## Build development container images
+	$(COMPOSE) build
+
+run: ## Start existing images without rebuilding
+	$(COMPOSE) up -d
+
+dev: ## Start existing images and follow logs
+	$(COMPOSE) up
+
+stop: ## Stop containers without deleting data
+	$(COMPOSE) down
+
+logs: ## Follow application logs
+	$(COMPOSE) logs -f
+
+test: ## Run Laravel tests in the container
+	$(LARAVEL) php artisan test
+
+format: ## Format PHP source
+	$(LARAVEL) ./vendor/bin/pint
+
+analyse: ## Run Larastan
+	$(LARAVEL) ./vendor/bin/phpstan analyse --memory-limit=1G
+
+migrate: ## Apply pending Laravel migrations
+	$(LARAVEL) php artisan migrate
+
+shell: ## Open a shell in the Laravel container
+	$(LARAVEL) sh
+
+clean: ## Remove containers and project volumes (destructive)
+	$(COMPOSE) down -v --remove-orphans

package/templates/makefile/postgres.mk

@@ -0,0 +1,40 @@
+# =============================================================================
+# Makefile — {{PROJECT_NAME}} ({{STACK}} + Prisma)
+# =============================================================================
+
+COMPOSE := docker compose
+
+.DEFAULT_GOAL := help
+
+.PHONY: help dev build lint test db-start db-stop db-migrate db-reset db-studio
+
+help: ## Show all commands
+	@grep -E '^[a-zA-Z_-]+:.*?## .*$$' $(MAKEFILE_LIST) \
+		| awk 'BEGIN {FS = ":.*?## "}; {printf "\033[36m%-20s\033[0m %s\n", $$1, $$2}'
+
+dev: db-start ## Start PostgreSQL + Next.js dev server
+	npm run dev
+
+build: ## Build for production
+	npm run build
+
+lint: ## Run ESLint
+	npm run lint
+
+test: ## Run Vitest
+	npm run test
+
+db-start: ## Start PostgreSQL container
+	$(COMPOSE) up -d db
+
+db-stop: ## Stop PostgreSQL container
+	$(COMPOSE) down
+
+db-migrate: ## Run Prisma migrations
+	npm run db:migrate
+
+db-reset: ## Reset DB + migrate + seed
+	npm run db:reset
+
+db-studio: ## Open Prisma Studio
+	npm run db:studio