leedstack 3.1.0

package/tools/templates/backend/node-express/backend/src/routes/health.ts

@@ -0,0 +1,54 @@
+import { Router } from 'express';
+
+const router = Router();
+
+interface HealthStatus {
+  status: 'UP' | 'DOWN';
+  timestamp: string;
+  uptime: number;
+  environment: string;
+  version: string;
+  checks?: {
+    database?: 'UP' | 'DOWN';
+    memory?: {
+      used: number;
+      total: number;
+      percentage: number;
+    };
+  };
+}
+
+router.get('/', (req, res) => {
+  const health: HealthStatus = {
+    status: 'UP',
+    timestamp: new Date().toISOString(),
+    uptime: process.uptime(),
+    environment: process.env.NODE_ENV || 'development',
+    version: process.env.npm_package_version || '1.0.0',
+  };
+
+  // Add memory usage
+  const memUsage = process.memoryUsage();
+  health.checks = {
+    memory: {
+      used: Math.round(memUsage.heapUsed / 1024 / 1024), // MB
+      total: Math.round(memUsage.heapTotal / 1024 / 1024), // MB
+      percentage: Math.round((memUsage.heapUsed / memUsage.heapTotal) * 100),
+    },
+  };
+
+  res.json(health);
+});
+
+// Liveness probe (K8s compatible)
+router.get('/live', (req, res) => {
+  res.json({ status: 'UP' });
+});
+
+// Readiness probe (K8s compatible)
+router.get('/ready', (req, res) => {
+  // Add database check here if needed
+  res.json({ status: 'UP' });
+});
+
+export default router;

package/tools/templates/backend/node-express/backend/tsconfig.json

@@ -0,0 +1,17 @@
+{
+  "compilerOptions": {
+    "target": "ES2022",
+    "module": "ESNext",
+    "moduleResolution": "bundler",
+    "lib": ["ES2022"],
+    "outDir": "./dist",
+    "rootDir": "./src",
+    "strict": true,
+    "esModuleInterop": true,
+    "skipLibCheck": true,
+    "forceConsistentCasingInFileNames": true,
+    "resolveJsonModule": true
+  },
+  "include": ["src/**/*"],
+  "exclude": ["node_modules"]
+}

package/tools/templates/backend/python-fastapi/backend/.env.example

@@ -0,0 +1,18 @@
+APP_PORT=8080
+FRONTEND_URL=http://localhost:<%= frontendPort %>
+FRONTEND_URL=http://localhost:5173
+<% if (modules.auth) { -%>
+AUTH0_DOMAIN=your-tenant.us.auth0.com
+AUTH0_AUDIENCE=https://api.<%= appSlug %>
+<% } -%>
+<% if (modules.payments) { -%>
+STRIPE_SECRET_KEY=sk_test_xxx
+STRIPE_WEBHOOK_SECRET=whsec_xxx
+<% } -%>
+<% if (db === 'postgres') { -%>
+DATABASE_URL=postgresql://<%= appSlug %>:password@localhost:5432/<%= appSlug %>_dev
+<% } else if (db === 'mysql') { -%>
+DATABASE_URL=mysql+pymysql://<%= appSlug %>:password@localhost:3306/<%= appSlug %>_dev
+<% } else { -%>
+DATABASE_URL=mongodb://localhost:27017/<%= appSlug %>_dev
+<% } -%>

package/tools/templates/backend/python-fastapi/backend/README.md

@@ -0,0 +1,73 @@
+# <%= AppName %> - Backend
+
+Python + FastAPI backend.
+
+## Quick Start
+
+```bash
+# Create virtual environment
+python -m venv venv
+
+# Activate virtual environment
+# On Windows:
+venv\Scripts\activate
+# On macOS/Linux:
+source venv/bin/activate
+
+# Install dependencies
+pip install -r requirements.txt
+
+# Set up environment
+cp .env.example .env
+
+# Start development server
+python -m app.main
+```
+
+Server runs on http://localhost:8080
+
+API documentation available at http://localhost:8080/docs
+
+## Available Commands
+
+- `python -m app.main` - Start development server
+- `uvicorn app.main:app --reload` - Alternative dev server command
+- `uvicorn app.main:app --host 0.0.0.0 --port 8080` - Production server
+
+## Environment Variables
+
+See `.env.example` for required variables:
+
+- `APP_PORT` - Server port (default: 8080)
+- `DATABASE_URL` - Database connection string
+<% if (modules.auth) { -%>
+- `AUTH0_DOMAIN` - Auth0 domain
+- `AUTH0_AUDIENCE` - Auth0 API audience
+<% } -%>
+
+## API Routes
+
+FastAPI automatically generates interactive API docs at `/docs`.
+
+Available endpoints:
+- `GET /health` - Health check endpoint
+- `GET /api/example` - Example API route
+<% if (modules.contact) { -%>
+- `POST /api/contact` - Submit contact form
+<% } -%>
+<% if (modules.admin) { -%>
+- `GET /api/admin/stats` - Admin statistics (requires auth)
+<% } -%>
+
+## Tech Stack
+
+- **Python ≥3.11** - Runtime
+- **FastAPI** - Modern web framework
+- **Uvicorn** - ASGI server
+- **Pydantic** - Data validation
+<% if (db === 'postgres' || db === 'mysql') { -%>
+- **SQLAlchemy** - ORM
+- **Alembic** - Database migrations
+<% } else if (db === 'mongodb') { -%>
+- **Motor** - Async MongoDB driver
+<% } -%>

package/tools/templates/backend/python-fastapi/backend/app/__init__.py

@@ -0,0 +1 @@
+# FastAPI app package

package/tools/templates/backend/python-fastapi/backend/app/main.py.ejs

@@ -0,0 +1,68 @@
+from fastapi import FastAPI
+from fastapi.middleware.cors import CORSMiddleware
+<% if (modules.auth) { -%>
+from app.middleware.auth import AuthMiddleware
+<% } -%>
+import os
+from dotenv import load_dotenv
+
+load_dotenv()
+
+app = FastAPI(title="<%= AppName %> API")
+
+# CORS configuration - allow only the configured frontend URL
+allowed_origins = [os.getenv("FRONTEND_URL", "")]
+allowed_origins = [origin.strip() for origin in allowed_origins if origin and origin.strip()]
+
+app.add_middleware(
+    CORSMiddleware,
+    allow_origins=allowed_origins,
+    allow_credentials=True,
+    allow_methods=["*"],
+    allow_headers=["*"],
+)
+
+<% if (modules.auth) { -%>
+# Auth middleware for /api routes
+# app.middleware("http")(AuthMiddleware())
+
+<% } -%>
+@app.get("/health")
+@app.get("/actuator/health")
+async def health():
+    return {"status": "UP"}
+
+@app.get("/api/example")
+async def example():
+    from datetime import datetime
+    return {
+        "message": "Hello from <%= backend %> backend!",
+        "timestamp": datetime.utcnow().isoformat()
+    }
+
+<% if (modules.contact) { -%>
+# Import contact router when created
+# from app.routers import contact
+# app.include_router(contact.router, prefix="/api")
+
+<% } -%>
+<% if (modules.admin) { -%>
+# Import admin router when created
+# from app.routers import admin
+# app.include_router(admin.router, prefix="/api")
+
+<% } -%>
+<% if (modules.payments) { -%>
+# Import payments router when created
+# from app.routers import payments
+# app.include_router(payments.router, prefix="/api")
+
+<% } -%>
+if __name__ == "__main__":
+    import uvicorn
+    port = int(os.getenv("APP_PORT", 8080))
+    print(f"✅ Server running on http://localhost:{port}")
+    print(f"📍 API available at http://localhost:{port}/api")
+    print(f"🏥 Health check at http://localhost:{port}/health")
+    print(f"📚 API docs at http://localhost:{port}/docs")
+    uvicorn.run("app.main:app", host="0.0.0.0", port=port, reload=True)

package/tools/templates/backend/python-fastapi/backend/requirements.txt.ejs

@@ -0,0 +1,22 @@
+fastapi>=0.115.0
+uvicorn[standard]>=0.32.0
+python-dotenv>=1.0.0
+pydantic>=2.10.0
+<% if (modules.auth) { -%>
+python-jose[cryptography]>=3.3.0
+requests>=2.32.0
+<% } -%>
+<% if (modules.payments) { -%>
+stripe>=11.0.0
+<% } -%>
+<% if (db === 'postgres' || db === 'mysql') { -%>
+sqlalchemy>=2.0.0
+alembic>=1.13.0
+<% if (db === 'postgres') { -%>
+psycopg2-binary>=2.9.0
+<% } else { -%>
+pymysql>=1.1.0
+<% } -%>
+<% } else { -%>
+motor>=3.6.0
+<% } -%>

package/tools/templates/base/.dockerignore

@@ -0,0 +1,16 @@
+node_modules
+npm-debug.log
+.env
+.env.local
+.git
+.gitignore
+README.md
+.vscode
+.idea
+*.md
+dist
+build
+.next
+coverage
+.nyc_output
+*.log

package/tools/templates/base/.env.example

@@ -0,0 +1,31 @@
+# Database
+DB_HOST=localhost
+<% if (db === 'postgres') { -%>
+DB_PORT=5432
+<% } else if (db === 'mysql') { -%>
+DB_PORT=3306
+<% } else { -%>
+DB_PORT=27017
+<% } -%>
+DB_NAME=<%= appSlug %>_dev
+DB_USER=<%= appSlug %>
+DB_PASSWORD=password
+
+# Frontend -> Backend base URL
+PUBLIC_API_BASE=http://localhost:8080
+<% if (modules.auth) { -%>
+
+# Auth0
+PUBLIC_AUTH0_DOMAIN=your-tenant.us.auth0.com
+PUBLIC_AUTH0_CLIENT_ID=your_spa_client_id
+PUBLIC_AUTH0_AUDIENCE=https://api.<%= appSlug %>
+AUTH0_DOMAIN=your-tenant.us.auth0.com
+AUTH0_AUDIENCE=https://api.<%= appSlug %>
+<% } -%>
+<% if (modules.payments) { -%>
+
+# Stripe
+STRIPE_SECRET_KEY=sk_test_xxx
+STRIPE_WEBHOOK_SECRET=whsec_xxx
+PUBLIC_STRIPE_PUBLISHABLE_KEY=pk_test_xxx
+<% } -%>

package/tools/templates/base/.github/workflows/ci.yml.ejs

@@ -0,0 +1,124 @@
+name: CI
+
+on:
+  push:
+    branches: [ main, develop ]
+  pull_request:
+    branches: [ main, develop ]
+
+jobs:
+  frontend:
+    name: Frontend Tests
+    runs-on: ubuntu-latest
+
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Setup Node.js
+        uses: actions/setup-node@v4
+        with:
+          node-version: '20'
+          cache: 'npm'
+          cache-dependency-path: frontend/package-lock.json
+
+      - name: Install dependencies
+        working-directory: frontend
+        run: npm ci
+
+      - name: Lint
+        working-directory: frontend
+        run: npm run lint
+
+      - name: Format check
+        working-directory: frontend
+        run: npm run format:check
+
+      - name: Build
+        working-directory: frontend
+        run: npm run build
+
+  backend:
+    name: Backend Tests
+    runs-on: ubuntu-latest
+
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Setup Node.js
+        uses: actions/setup-node@v4
+        with:
+          node-version: '20'
+          cache: 'npm'
+          cache-dependency-path: backend/package-lock.json
+
+<% if (backend === 'node-express') { -%>
+      - name: Install dependencies
+        working-directory: backend
+        run: npm ci
+
+      - name: Lint
+        working-directory: backend
+        run: npm run lint
+
+      - name: Format check
+        working-directory: backend
+        run: npm run format:check
+
+      - name: Type check
+        working-directory: backend
+        run: npm run type-check
+
+      - name: Build
+        working-directory: backend
+        run: npm run build
+<% } else if (backend === 'python-fastapi') { -%>
+      - name: Setup Python
+        uses: actions/setup-python@v5
+        with:
+          python-version: '3.11'
+          cache: 'pip'
+
+      - name: Install dependencies
+        working-directory: backend
+        run: |
+          python -m pip install --upgrade pip
+          pip install -r requirements.txt
+
+      - name: Lint
+        working-directory: backend
+        run: |
+          pip install flake8 black
+          flake8 app --max-line-length=100
+          black --check app
+<% } else if (backend === 'java-spring') { -%>
+      - name: Setup Java
+        uses: actions/setup-java@v4
+        with:
+          distribution: 'temurin'
+          java-version: '21'
+          cache: 'maven'
+
+      - name: Build with Maven
+        working-directory: backend
+        run: mvn clean verify
+<% } else if (backend === 'go-echo') { -%>
+      - name: Setup Go
+        uses: actions/setup-go@v5
+        with:
+          go-version: '1.22'
+          cache-dependency-path: backend/go.sum
+
+      - name: Build
+        working-directory: backend
+        run: go build -v ./...
+
+      - name: Test
+        working-directory: backend
+        run: go test -v ./...
+
+      - name: Lint
+        working-directory: backend
+        run: |
+          go install golang.org/x/lint/golint@latest
+          golint ./...
+<% } -%>

package/tools/templates/base/.github/workflows/deploy-separate.yml.example

@@ -0,0 +1,144 @@
+# Example: Separate Deployment Strategy
+#
+# To use this strategy:
+# 1. Split your project into two repos (see DEPLOYMENT_STRATEGIES.md)
+# 2. Copy relevant sections to each repo's .github/workflows/deploy.yml
+# 3. Set up deployment secrets in GitHub repo settings
+
+# ==================================================
+# FRONTEND DEPLOYMENT (for frontend repo)
+# ==================================================
+name: Deploy Frontend
+
+on:
+  push:
+    branches: [main]
+  pull_request:
+    branches: [main]
+
+jobs:
+  test:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Setup Node.js
+        uses: actions/setup-node@v4
+        with:
+          node-version: '20'
+          cache: 'npm'
+
+      - name: Install dependencies
+        run: npm ci
+
+      - name: Lint
+        run: npm run lint
+
+      - name: Test
+        run: npm test
+
+      - name: Build
+        run: npm run build
+
+  deploy:
+    needs: test
+    runs-on: ubuntu-latest
+    if: github.ref == 'refs/heads/main'
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Setup Node.js
+        uses: actions/setup-node@v4
+        with:
+          node-version: '20'
+          cache: 'npm'
+
+      - name: Install dependencies
+        run: npm ci
+
+      # Option 1: Deploy to Vercel
+      - name: Deploy to Vercel
+        run: |
+          npm install -g vercel
+          vercel --prod --token ${{ secrets.VERCEL_TOKEN }}
+
+      # Option 2: Deploy to Netlify
+      # - name: Deploy to Netlify
+      #   uses: nwtgck/actions-netlify@v2
+      #   with:
+      #     publish-dir: './dist'
+      #     production-deploy: true
+      #   env:
+      #     NETLIFY_AUTH_TOKEN: ${{ secrets.NETLIFY_AUTH_TOKEN }}
+      #     NETLIFY_SITE_ID: ${{ secrets.NETLIFY_SITE_ID }}
+
+      # Option 3: Deploy to Cloudflare Pages
+      # - name: Deploy to Cloudflare Pages
+      #   uses: cloudflare/pages-action@v1
+      #   with:
+      #     apiToken: ${{ secrets.CLOUDFLARE_API_TOKEN }}
+      #     accountId: ${{ secrets.CLOUDFLARE_ACCOUNT_ID }}
+      #     projectName: my-app
+      #     directory: dist
+
+# ==================================================
+# BACKEND DEPLOYMENT (for backend repo)
+# ==================================================
+name: Deploy Backend
+
+on:
+  push:
+    branches: [main]
+  pull_request:
+    branches: [main]
+
+jobs:
+  test:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Setup Node.js
+        uses: actions/setup-node@v4
+        with:
+          node-version: '20'
+          cache: 'npm'
+
+      - name: Install dependencies
+        run: npm ci
+
+      - name: Lint
+        run: npm run lint
+
+      - name: Type check
+        run: npm run type-check
+
+      - name: Build
+        run: npm run build
+
+  deploy:
+    needs: test
+    runs-on: ubuntu-latest
+    if: github.ref == 'refs/heads/main'
+    steps:
+      - uses: actions/checkout@v4
+
+      # Option 1: Deploy to Fly.io
+      - name: Deploy to Fly.io
+        uses: superfly/flyctl-actions/setup-flyctl@master
+      - run: flyctl deploy --remote-only
+        env:
+          FLY_API_TOKEN: ${{ secrets.FLY_API_TOKEN }}
+
+      # Option 2: Deploy to Railway
+      # - name: Deploy to Railway
+      #   run: |
+      #     npm install -g @railway/cli
+      #     railway up
+      #   env:
+      #     RAILWAY_TOKEN: ${{ secrets.RAILWAY_TOKEN }}
+
+      # Option 3: Deploy to Render
+      # - name: Deploy to Render
+      #   run: |
+      #     curl -X POST ${{ secrets.RENDER_DEPLOY_HOOK }}

package/tools/templates/base/.vscode/extensions.json

@@ -0,0 +1,17 @@
+{
+  "recommendations": [
+    "dbaeumer.vscode-eslint",
+    "esbenp.prettier-vscode",
+    "ms-vscode.vscode-typescript-next"<% if (frontend === 'vue') { %>,
+    "Vue.volar"<% } %><% if (frontend === 'svelte') { %>,
+    "svelte.svelte-vscode"<% } %><% if (frontend === 'angular') { %>,
+    "Angular.ng-template"<% } %><% if (backend === 'python-fastapi') { %>,
+    "ms-python.python",
+    "ms-python.vscode-pylance",
+    "ms-python.black-formatter"<% } %><% if (backend === 'java-spring') { %>,
+    "vscjava.vscode-java-pack",
+    "vscjava.vscode-spring-boot-dashboard"<% } %><% if (backend === 'go-echo') { %>,
+    "golang.go"<% } %>,
+    "ms-azuretools.vscode-docker"
+  ]
+}

package/tools/templates/base/.vscode/settings.json

@@ -0,0 +1,49 @@
+{
+  "editor.formatOnSave": true,
+  "editor.codeActionsOnSave": {
+    "source.fixAll": "explicit"
+  },
+  "files.exclude": {
+    "**/.git": true,
+    "**/.DS_Store": true,
+    "**/node_modules": true
+  },
+  "search.exclude": {
+    "**/node_modules": true,
+    "**/dist": true,
+    "**/build": true,
+    "**/.next": true
+  },
+  "[javascript]": {
+    "editor.defaultFormatter": "esbenp.prettier-vscode",
+    "editor.tabSize": 2
+  },
+  "[typescript]": {
+    "editor.defaultFormatter": "esbenp.prettier-vscode",
+    "editor.tabSize": 2
+  },
+  "[json]": {
+    "editor.defaultFormatter": "esbenp.prettier-vscode",
+    "editor.tabSize": 2
+  }<% if (backend === 'python-fastapi') { %>,
+  "[python]": {
+    "editor.defaultFormatter": "ms-python.black-formatter",
+    "editor.tabSize": 4,
+    "editor.insertSpaces": true
+  },
+  "python.linting.enabled": true,
+  "python.linting.pylintEnabled": false,
+  "python.linting.flake8Enabled": true,
+  "python.formatting.provider": "black"<% } %><% if (backend === 'java-spring') { %>,
+  "[java]": {
+    "editor.tabSize": 4
+  },
+  "java.configuration.updateBuildConfiguration": "automatic"<% } %><% if (backend === 'go-echo') { %>,
+  "[go]": {
+    "editor.defaultFormatter": "golang.go",
+    "editor.tabSize": 4,
+    "editor.insertSpaces": false
+  },
+  "go.useLanguageServer": true,
+  "go.formatTool": "gofmt"<% } %>
+}