create-projx 0.1.1

package/package.json

@@ -0,0 +1,44 @@
+{
+  "name": "create-projx",
+  "version": "0.1.1",
+  "description": "Scaffold production-grade projects. Pick your stack (FastAPI, Fastify, React, Flutter), get a fully wired template with auth, database, CI/CD, and E2E tests.",
+  "type": "module",
+  "bin": {
+    "create-projx": "dist/index.js"
+  },
+  "files": [
+    "dist",
+    "src/templates"
+  ],
+  "scripts": {
+    "build": "tsup src/index.ts --format esm --target node18 --clean",
+    "dev": "tsup src/index.ts --format esm --target node18 --watch",
+    "prepublishOnly": "npm run build"
+  },
+  "keywords": [
+    "projx",
+    "scaffold",
+    "template",
+    "fastapi",
+    "fastify",
+    "react",
+    "flutter",
+    "fullstack",
+    "create"
+  ],
+  "license": "MIT",
+  "engines": {
+    "node": ">=18"
+  },
+  "dependencies": {
+    "@clack/prompts": "^0.9"
+  },
+  "devDependencies": {
+    "@eslint/js": "^10.0.1",
+    "@types/node": "^25.5.2",
+    "eslint": "^10.2.0",
+    "tsup": "^8",
+    "typescript": "^5",
+    "typescript-eslint": "^8.58.0"
+  }
+}

package/src/templates/Makefile.ejs

@@ -0,0 +1,286 @@
+.PHONY: setup install format lint fix check typecheck test test-coverage test-e2e \
+       migrate migrate-down seed run run-dev stop logs clean
+
+# ─── Setup ───────────────────────────────────────────────────────────
+
+setup:
+	git config core.hooksPath .githooks
+	@echo "Git hooks configured."
+	$(MAKE) install
+
+install:
+<% if (components.includes('fastapi')) { %>
+	cd fastapi && uv sync --all-extras
+<% } %>
+<% if (components.includes('fastify')) { %>
+	cd fastify && pnpm install --frozen-lockfile
+<% } %>
+<% if (components.includes('frontend')) { %>
+	cd frontend && npm ci
+<% } %>
+<% if (components.includes('e2e')) { %>
+	cd e2e && npm ci
+<% } %>
+<% if (components.includes('mobile')) { %>
+	cd mobile && flutter pub get 2>/dev/null || echo "Flutter SDK not installed — skipping mobile"
+<% } %>
+	@echo "All dependencies installed."
+
+# ─── Format ──────────────────────────────────────────────────────────
+
+format:
+<% if (components.includes('fastapi')) { %>
+	cd fastapi && uv run ruff format src tests
+<% } %>
+<% if (components.includes('fastify')) { %>
+	cd fastify && npx prettier --write --ignore-unknown .
+<% } %>
+<% if (components.includes('frontend')) { %>
+	cd frontend && npx prettier --write --ignore-unknown .
+<% } %>
+<% if (components.includes('e2e')) { %>
+	cd e2e && npx prettier --write --ignore-unknown .
+<% } %>
+<% if (components.includes('mobile')) { %>
+	cd mobile && dart format . 2>/dev/null || true
+<% } %>
+<% if (components.includes('infra')) { %>
+	cd infra/stack && terraform fmt -recursive 2>/dev/null || true
+<% } %>
+
+# ─── Lint ────────────────────────────────────────────────────────────
+
+lint:
+<% if (components.includes('fastapi')) { %>
+	cd fastapi && uv run ruff check src tests
+<% } %>
+<% if (components.includes('fastify')) { %>
+	cd fastify && npx eslint 'src/**/*.ts' 'tests/**/*.ts'
+<% } %>
+<% if (components.includes('frontend')) { %>
+	cd frontend && npx eslint 'src/**/*.{ts,tsx}'
+<% } %>
+<% if (components.includes('e2e')) { %>
+	cd e2e && npx eslint '**/*.ts'
+<% } %>
+<% if (components.includes('mobile')) { %>
+	cd mobile && dart analyze --fatal-infos 2>/dev/null || true
+<% } %>
+<% if (components.includes('infra')) { %>
+	cd infra/stack && terraform validate 2>/dev/null || true
+<% } %>
+
+# ─── Fix (format + lint with auto-fix) ──────────────────────────────
+
+fix:
+<% if (components.includes('fastapi')) { %>
+	cd fastapi && uv run ruff format src tests && uv run ruff check --fix src tests
+<% } %>
+<% if (components.includes('fastify')) { %>
+	cd fastify && npx prettier --write --ignore-unknown . && npx eslint --fix 'src/**/*.ts' 'tests/**/*.ts'
+<% } %>
+<% if (components.includes('frontend')) { %>
+	cd frontend && npx prettier --write --ignore-unknown . && npx eslint --fix 'src/**/*.{ts,tsx}'
+<% } %>
+<% if (components.includes('e2e')) { %>
+	cd e2e && npx prettier --write --ignore-unknown . && npx eslint --fix '**/*.ts'
+<% } %>
+<% if (components.includes('mobile')) { %>
+	cd mobile && dart format . 2>/dev/null && dart analyze --fatal-infos 2>/dev/null || true
+<% } %>
+<% if (components.includes('infra')) { %>
+	cd infra/stack && terraform fmt -recursive 2>/dev/null || true
+<% } %>
+
+# ─── Type Check ──────────────────────────────────────────────────────
+
+typecheck:
+<% if (components.includes('fastify')) { %>
+	cd fastify && npx tsc --noEmit
+<% } %>
+<% if (components.includes('frontend')) { %>
+	cd frontend && npx tsc --noEmit
+<% } %>
+<% if (components.includes('e2e')) { %>
+	cd e2e && npx tsc --noEmit
+<% } %>
+
+# ─── Check (CI-equivalent) ──────────────────────────────────────────
+
+check:
+<% if (components.includes('fastapi')) { %>
+	cd fastapi && uv run ruff format --check src tests && uv run ruff check src tests
+<% } %>
+<% if (components.includes('fastify')) { %>
+	cd fastify && npx prettier --check . && npx eslint . && npx tsc --noEmit
+<% } %>
+<% if (components.includes('frontend')) { %>
+	cd frontend && npx prettier --check . && npx eslint 'src/**/*.{ts,tsx}' && npx tsc --noEmit
+<% } %>
+<% if (components.includes('e2e')) { %>
+	cd e2e && npx prettier --check . && npx eslint '**/*.ts' && npx tsc --noEmit
+<% } %>
+<% if (components.includes('mobile')) { %>
+	cd mobile && dart format --set-exit-if-changed . 2>/dev/null && dart analyze --fatal-infos 2>/dev/null || true
+<% } %>
+<% if (components.includes('infra')) { %>
+	cd infra/stack && terraform fmt -check -recursive 2>/dev/null && terraform validate 2>/dev/null || true
+<% } %>
+
+# ─── Test ────────────────────────────────────────────────────────────
+
+test:
+<% if (components.includes('fastapi')) { %>
+	cd fastapi && uv run pytest --tb=short -q
+<% } %>
+<% if (components.includes('fastify')) { %>
+	cd fastify && pnpm test
+<% } %>
+<% if (components.includes('frontend')) { %>
+	cd frontend && npx vitest run
+<% } %>
+<% if (components.includes('mobile')) { %>
+	cd mobile && flutter test 2>/dev/null || true
+<% } %>
+
+test-coverage:
+<% if (components.includes('fastapi')) { %>
+	cd fastapi && uv run pytest --cov=src --cov-report=term-missing --cov-fail-under=80
+<% } %>
+<% if (components.includes('fastify')) { %>
+	cd fastify && pnpm test -- --coverage
+<% } %>
+<% if (components.includes('frontend')) { %>
+	cd frontend && npx vitest run --coverage
+<% } %>
+<% if (components.includes('mobile')) { %>
+	cd mobile && flutter test --coverage 2>/dev/null || true
+<% } %>
+<% if (components.includes('e2e')) { %>
+
+test-e2e:
+	cd e2e && npx playwright test
+<% } %>
+<% if (components.includes('mobile')) { %>
+
+test-e2e-mobile:
+	cd mobile && flutter test integration_test/
+
+mobile-build-apk:
+	cd mobile && flutter build apk --release
+
+mobile-build-ios:
+	cd mobile && flutter build ios --release --no-codesign
+
+mobile-codegen:
+	cd mobile && dart run build_runner build --delete-conflicting-outputs
+<% } %>
+<% if (components.includes('fastapi')) { %>
+
+# ─── Database ────────────────────────────────────────────────────────
+
+migrate:
+	cd fastapi && uv run migrate.py
+<% if (components.includes('fastify')) { %>
+	cd fastify && pnpm prisma:migrate:dev
+<% } %>
+
+migrate-deploy:
+	cd fastapi && uv run migrate.py
+<% if (components.includes('fastify')) { %>
+	cd fastify && pnpm prisma:migrate:deploy
+<% } %>
+
+migrate-down:
+	cd fastapi && uv run migrate.py --downgrade -1
+
+seed:
+	cd fastapi && uv run seed.py
+<% } %>
+<% if (components.includes('fastify') && !components.includes('fastapi')) { %>
+
+migrate:
+	cd fastify && pnpm prisma:migrate:dev
+
+migrate-deploy:
+	cd fastify && pnpm prisma:migrate:deploy
+<% } %>
+
+# ─── Run (local) ─────────────────────────────────────────────────────
+
+run-local:
+<% if (components.includes('fastapi')) { %>
+	cd fastapi && uv run main.py &
+<% } %>
+<% if (components.includes('fastify')) { %>
+	cd fastify && pnpm dev &
+<% } %>
+<% if (components.includes('frontend')) { %>
+	cd frontend && npm run dev &
+<% } %>
+	@echo "All services starting. Run 'make stop-local' to stop."
+	@wait
+
+stop-local:
+	@kill $$(lsof -ti:7860,3000,5173 2>/dev/null) 2>/dev/null || true
+	@echo "All local services stopped."
+<% if (components.includes('fastapi')) { %>
+
+run-fastapi:
+	cd fastapi && uv run main.py
+<% } %>
+<% if (components.includes('fastify')) { %>
+
+run-fastify:
+	cd fastify && pnpm dev
+<% } %>
+<% if (components.includes('frontend')) { %>
+
+run-frontend:
+	cd frontend && npm run dev
+<% } %>
+<% if (components.includes('mobile')) { %>
+
+run-mobile:
+	cd mobile && flutter run
+<% } %>
+
+# ─── Run (Docker Compose) ───────────────────────────────────────────
+
+run:
+	docker compose up -d --build
+
+run-dev:
+	docker compose -f docker-compose.dev.yml up -d --build
+
+stop:
+	docker compose down
+	docker compose -f docker-compose.dev.yml down 2>/dev/null || true
+
+logs:
+	docker compose logs -f
+<% if (components.includes('fastapi')) { %>
+
+entity:
+	@test -n "$(name)" || (echo "Usage: make entity name=my_entity" && exit 1)
+	cd fastapi && uv run scaffold.py $(name)
+
+entity-custom:
+	@test -n "$(name)" || (echo "Usage: make entity-custom name=my_entity" && exit 1)
+	cd fastapi && uv run scaffold.py $(name) --controller
+<% } %>
+
+# ─── Clean ───────────────────────────────────────────────────────────
+
+clean:
+	docker compose down -v
+	docker compose -f docker-compose.dev.yml down -v 2>/dev/null || true
+<% if (components.includes('fastapi')) { %>
+	cd fastapi && rm -rf .pytest_cache __pycache__ .coverage htmlcov
+<% } %>
+<% if (components.includes('fastify')) { %>
+	cd fastify && rm -rf dist coverage node_modules/.cache
+<% } %>
+<% if (components.includes('frontend')) { %>
+	cd frontend && rm -rf dist coverage node_modules/.cache playwright-report test-results
+<% } %>

package/src/templates/README.md.ejs

@@ -0,0 +1,87 @@
+# <%= projectName %>
+
+Scaffolded with [Projx](https://github.com/ukanhaupa/projx).
+
+## Stack
+
+| Layer | Technology |
+| ----- | ---------- |
+<% if (components.includes('fastapi')) { %>
+| **Backend (Python)** | FastAPI, SQLAlchemy, Alembic, uvicorn |
+<% } %>
+<% if (components.includes('fastify')) { %>
+| **Backend (Node)** | Fastify, Prisma, TypeBox, TypeScript |
+<% } %>
+<% if (components.includes('frontend')) { %>
+| **Frontend** | React 19, TypeScript, Vite, React Router |
+<% } %>
+<% if (components.includes('mobile')) { %>
+| **Mobile** | Flutter, Dart, Riverpod, GoRouter, Isar |
+<% } %>
+<% if (components.includes('e2e')) { %>
+| **E2E Tests** | Playwright |
+<% } %>
+<% if (components.includes('infra')) { %>
+| **Infrastructure** | Terraform, AWS (EKS, RDS, VPC, CodePipeline) |
+<% } %>
+| **Identity** | Keycloak (OIDC / JWT) |
+| **Containers** | Docker, Docker Compose |
+
+## Getting Started
+
+```bash
+make setup        # Install all dependencies
+make run-dev      # Start with Docker (dev mode)
+```
+<% if (components.includes('fastapi')) { %>
+
+### FastAPI
+
+```bash
+cd fastapi && cp .env.example .env && uv sync && uv run main.py
+```
+
+API docs at `http://localhost:7860/docs`.
+<% } %>
+<% if (components.includes('fastify')) { %>
+
+### Fastify
+
+```bash
+cd fastify && cp .env.example .env && pnpm install && npx prisma migrate dev && pnpm dev
+```
+
+API docs at `http://localhost:3000/docs`.
+<% } %>
+<% if (components.includes('frontend')) { %>
+
+### Frontend
+
+```bash
+cd frontend && cp .env.example .env && npm install && npm run dev
+```
+<% } %>
+<% if (components.includes('mobile')) { %>
+
+### Mobile
+
+```bash
+cd mobile && cp .env.example .env && flutter pub get && flutter run
+```
+<% } %>
+
+## Testing
+
+```bash
+make test           # Run all tests
+make test-coverage  # Run with coverage
+<% if (components.includes('e2e')) { %>
+make test-e2e       # Playwright E2E tests
+<% } %>
+```
+
+## Update
+
+```bash
+npx create-projx@latest update
+```

package/src/templates/ci.yml.ejs

@@ -0,0 +1,117 @@
+name: CI
+
+on:
+  pull_request:
+    branches: [main]
+  push:
+    branches: [main]
+
+jobs:
+<% if (components.includes('fastapi')) { %>
+  fastapi:
+    name: FastAPI (format + lint)
+    runs-on: ubuntu-latest
+    defaults:
+      run:
+        working-directory: fastapi
+    steps:
+      - uses: actions/checkout@v5
+      - uses: astral-sh/setup-uv@v4
+      - run: uv sync --group dev
+      - run: uv run ruff format --check src tests
+      - run: uv run ruff check src tests
+<% } %>
+<% if (components.includes('fastify')) { %>
+  fastify:
+    name: Fastify (format + lint + typecheck)
+    runs-on: ubuntu-latest
+    defaults:
+      run:
+        working-directory: fastify
+    steps:
+      - uses: actions/checkout@v5
+      - uses: pnpm/action-setup@v4
+        with:
+          version: 9
+      - uses: actions/setup-node@v5
+        with:
+          node-version: 20
+          cache: pnpm
+          cache-dependency-path: fastify/pnpm-lock.yaml
+      - run: pnpm install --frozen-lockfile
+      - run: npx prisma generate
+      - run: npx prettier --check .
+      - run: npx eslint .
+      - run: npx tsc --noEmit
+<% } %>
+<% if (components.includes('frontend')) { %>
+  frontend:
+    name: Frontend (format + lint + typecheck)
+    runs-on: ubuntu-latest
+    defaults:
+      run:
+        working-directory: frontend
+    steps:
+      - uses: actions/checkout@v5
+      - uses: actions/setup-node@v5
+        with:
+          node-version: 22
+          cache: npm
+          cache-dependency-path: frontend/package-lock.json
+      - run: npm ci
+      - run: npx prettier --check .
+      - run: npx eslint 'src/**/*.{ts,tsx}'
+      - run: npx tsc --noEmit
+<% } %>
+<% if (components.includes('mobile')) { %>
+  mobile:
+    name: Flutter (format + analyze)
+    runs-on: ubuntu-latest
+    defaults:
+      run:
+        working-directory: mobile
+    steps:
+      - uses: actions/checkout@v5
+      - uses: subosito/flutter-action@v2
+        with:
+          channel: stable
+      - run: flutter pub get
+      - run: dart run build_runner build --delete-conflicting-outputs
+      - run: dart format --set-exit-if-changed .
+      - run: dart analyze --fatal-infos
+<% } %>
+<% if (components.includes('e2e')) { %>
+  e2e:
+    name: E2E (format + lint + typecheck)
+    runs-on: ubuntu-latest
+    defaults:
+      run:
+        working-directory: e2e
+    steps:
+      - uses: actions/checkout@v5
+      - uses: actions/setup-node@v5
+        with:
+          node-version: 22
+          cache: npm
+          cache-dependency-path: e2e/package-lock.json
+      - run: npm ci
+      - run: npx prettier --check .
+      - run: npx eslint '**/*.ts'
+      - run: npx tsc --noEmit
+<% } %>
+<% if (components.includes('infra')) { %>
+  infra:
+    name: Terraform (fmt + validate)
+    runs-on: ubuntu-latest
+    defaults:
+      run:
+        working-directory: infra/stack
+    steps:
+      - uses: actions/checkout@v5
+      - uses: hashicorp/setup-terraform@v3
+        with:
+          terraform_version: '1.11'
+      - run: terraform fmt -check -recursive
+      - run: terraform init -backend=false
+      - run: terraform validate
+<% } %>

package/src/templates/docker-compose.dev.yml.ejs

@@ -0,0 +1,168 @@
+services:
+<% if (components.includes('fastapi') || components.includes('fastify')) { %>
+  db:
+    image: postgres:16-alpine
+    environment:
+      POSTGRES_USER: dev
+      POSTGRES_PASSWORD: dev
+      POSTGRES_DB: app
+    ports:
+      - '5432:5432'
+    volumes:
+      - pgdata:/var/lib/postgresql/data
+    healthcheck:
+      test: ['CMD-SHELL', 'pg_isready -U dev -d app']
+      interval: 5s
+      timeout: 3s
+      retries: 5
+    deploy:
+      resources:
+        limits:
+          memory: 256M
+          cpus: '0.5'
+    networks:
+      - app-network
+<% } %>
+<% if (components.includes('fastapi')) { %>
+  migrate:
+    build: ./fastapi
+    command: ['uv', 'run', 'migrate.py']
+    environment:
+      - SQLALCHEMY_DATABASE_URI=postgresql+asyncpg://dev:dev@db:5432/app
+    depends_on:
+      db:
+        condition: service_healthy
+    deploy:
+      resources:
+        limits:
+          memory: 256M
+          cpus: '0.5'
+    networks:
+      - app-network
+
+  backend:
+    build: ./fastapi
+    command:
+      [
+        'uv', 'run', 'uvicorn', 'src.app:app',
+        '--host', '0.0.0.0', '--port', '7860',
+        '--workers', '2', '--timeout-keep-alive', '120', '--reload',
+      ]
+    ports:
+      - '7860:7860'
+    environment:
+      - SQLALCHEMY_DATABASE_URI=postgresql+asyncpg://dev:dev@db:5432/app
+      - CORS_ALLOW_ORIGINS=http://localhost:3000,http://localhost
+      - JWT_PROVIDER=shared_secret
+      - JWT_SECRET=dev-secret-that-is-at-least-32-bytes-long
+      - JWT_ALGORITHMS=HS256
+    volumes:
+      - ./fastapi/src:/app/src
+      - ./fastapi/alembic.ini:/app/alembic.ini
+      - ./fastapi/migrate.py:/app/migrate.py
+    depends_on:
+      migrate:
+        condition: service_completed_successfully
+    restart: unless-stopped
+    healthcheck:
+      test:
+        [
+          'CMD', 'python', '-c',
+          "import urllib.request; urllib.request.urlopen('http://localhost:7860/api/health')",
+        ]
+      interval: 15s
+      timeout: 5s
+      retries: 3
+      start_period: 10s
+    deploy:
+      resources:
+        limits:
+          memory: 512M
+          cpus: '1.0'
+    networks:
+      - app-network
+<% } %>
+<% if (components.includes('fastify')) { %>
+  backend-fastify:
+    build: ./fastify
+    command: ['pnpm', 'dev']
+    ports:
+      - '3000:3000'
+    environment:
+      - DATABASE_URL=postgresql://dev:dev@db:5432/app
+      - CORS_ALLOW_ORIGINS=http://localhost:5173,http://localhost
+      - JWT_PROVIDER=shared_secret
+      - JWT_SECRET=dev-secret-that-is-at-least-32-bytes-long
+    volumes:
+      - ./fastify/src:/app/src
+    depends_on:
+      db:
+        condition: service_healthy
+    restart: unless-stopped
+    healthcheck:
+      test: ['CMD', 'wget', '--spider', '-q', 'http://localhost:3000/api/health']
+      interval: 15s
+      timeout: 5s
+      retries: 3
+      start_period: 10s
+    deploy:
+      resources:
+        limits:
+          memory: 512M
+          cpus: '1.0'
+    networks:
+      - app-network
+<% } %>
+<% if (components.includes('frontend')) { %>
+  frontend:
+    image: node:20-alpine
+    working_dir: /app
+    command: sh -c "npm install && npm run dev -- --host 0.0.0.0"
+    ports:
+      - '5173:5173'
+    environment:
+<% if (components.includes('fastapi')) { %>
+      - VITE_API_URL=http://localhost:7860
+<% } %>
+<% if (components.includes('fastify') && !components.includes('fastapi')) { %>
+      - VITE_API_URL=http://localhost:3000
+<% } %>
+    volumes:
+      - ./frontend:/app
+      - frontend_node_modules:/app/node_modules
+<% if (components.includes('fastapi')) { %>
+    depends_on:
+      backend:
+        condition: service_healthy
+<% } %>
+<% if (components.includes('fastify') && !components.includes('fastapi')) { %>
+    depends_on:
+      backend-fastify:
+        condition: service_healthy
+<% } %>
+    healthcheck:
+      test: ['CMD', 'wget', '--spider', '-q', 'http://localhost:5173/']
+      interval: 15s
+      timeout: 5s
+      retries: 3
+      start_period: 30s
+    deploy:
+      resources:
+        limits:
+          memory: 512M
+          cpus: '1.0'
+    networks:
+      - app-network
+<% } %>
+
+volumes:
+<% if (components.includes('fastapi') || components.includes('fastify')) { %>
+  pgdata:
+<% } %>
+<% if (components.includes('frontend')) { %>
+  frontend_node_modules:
+<% } %>
+
+networks:
+  app-network:
+    driver: bridge