@adriankulik/create-fullstack-app 1.0.0

package/cli/package.json

@@ -0,0 +1,23 @@
+{
+  "name": "cli",
+  "version": "1.0.0",
+  "main": "index.js",
+  "bin": {
+    "create-fullstack-app": "./index.js"
+  },
+  "scripts": {
+    "test": "echo \"Error: no test specified\" && exit 1"
+  },
+  "keywords": [],
+  "author": "",
+  "license": "ISC",
+  "description": "",
+  "dependencies": {
+    "fs-extra": "^11.3.4",
+    "picocolors": "^1.1.1",
+    "prompts": "^2.4.2"
+  },
+  "devDependencies": {
+    "vitest": "^4.1.5"
+  }
+}

package/package.json

@@ -0,0 +1,40 @@
+{
+  "name": "@adriankulik/create-fullstack-app",
+  "version": "1.0.0",
+  "description": "A CLI tool for scaffolding a full-stack web application with your choice of frontend and backend technologies.",
+  "main": "cli/index.js",
+  "bin": {
+    "create-fullstack-app": "./cli/index.js"
+  },
+  "files": [
+    "cli",
+    "templates"
+  ],
+  "directories": {
+    "test": "tests"
+  },
+  "dependencies": {
+    "fs-extra": "^11.3.4",
+    "picocolors": "^1.1.1",
+    "prompts": "^2.4.2"
+  },
+  "devDependencies": {
+    "@playwright/test": "^1.59.1",
+    "vitest": "^4.1.5",
+    "wait-on": "^9.0.5"
+  },
+  "scripts": {
+    "test": "echo \"Error: no test specified\" && exit 1"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/adriankulik/create-fullstack-app.git"
+  },
+  "keywords": [],
+  "author": "",
+  "license": "ISC",
+  "bugs": {
+    "url": "https://github.com/adriankulik/create-fullstack-app/issues"
+  },
+  "homepage": "https://github.com/adriankulik/create-fullstack-app#readme"
+}

package/templates/backend/fastapi/lint.sh

@@ -0,0 +1,9 @@
+#!/usr/bin/env bash
+if [ -d "venv" ]; then
+    source venv/bin/activate
+    ruff check . --fix
+    ruff format .
+else
+    ruff check . --fix
+    ruff format .
+fi

package/templates/backend/fastapi/main.py

@@ -0,0 +1,28 @@
+from fastapi import FastAPI
+from fastapi.middleware.cors import CORSMiddleware
+from pydantic import BaseModel
+
+app = FastAPI()
+
+# Allow CORS for the frontend
+app.add_middleware(
+    CORSMiddleware,
+    allow_origins=["*"],  # In production, specify the actual origin
+    allow_credentials=True,
+    allow_methods=["*"],
+    allow_headers=["*"],
+)
+
+class MultiplyRequest(BaseModel):
+    number: float
+
+class MultiplyResponse(BaseModel):
+    result: float
+
+@app.post("/api/multiply", response_model=MultiplyResponse)
+def multiply_number(request: MultiplyRequest):
+    return MultiplyResponse(result=request.number * 2)
+
+@app.get("/api/health")
+def health_check():
+    return {"status": "ok"}

package/templates/backend/fastapi/requirements.txt

@@ -0,0 +1,5 @@
+fastapi==0.136.1
+uvicorn==0.28.0
+pytest==8.1.1
+httpx==0.27.0
+ruff==0.3.3

package/templates/backend/fastapi/start.sh

@@ -0,0 +1,7 @@
+#!/usr/bin/env bash
+if [ -d "venv" ]; then
+    source venv/bin/activate
+    python -m uvicorn main:app --reload --port 8000
+else
+    python3 -m uvicorn main:app --reload --port 8000
+fi

package/templates/backend/fastapi/test.sh

@@ -0,0 +1,7 @@
+#!/usr/bin/env bash
+if [ -d "venv" ]; then
+    source venv/bin/activate
+    pytest
+else
+    pytest
+fi

package/templates/backend/fastapi/test_main.py

@@ -0,0 +1,19 @@
+from fastapi.testclient import TestClient
+from main import app
+
+client = TestClient(app)
+
+def test_health_check():
+    response = client.get("/api/health")
+    assert response.status_code == 200
+    assert response.json() == {"status": "ok"}
+
+def test_multiply_number():
+    response = client.post("/api/multiply", json={"number": 5})
+    assert response.status_code == 200
+    assert response.json() == {"result": 10.0}
+
+def test_multiply_number_negative():
+    response = client.post("/api/multiply", json={"number": -3.5})
+    assert response.status_code == 200
+    assert response.json() == {"result": -7.0}

package/templates/backend/flask/lint.sh

@@ -0,0 +1,9 @@
+#!/usr/bin/env bash
+if [ -d "venv" ]; then
+    source venv/bin/activate
+    ruff check . --fix
+    ruff format .
+else
+    ruff check . --fix
+    ruff format .
+fi

package/templates/backend/flask/main.py

@@ -0,0 +1,24 @@
+from flask import Flask, request, jsonify
+from flask_cors import CORS
+
+app = Flask(__name__)
+CORS(app)
+
+@app.route("/api/multiply", methods=["POST"])
+def multiply_number():
+    data = request.get_json()
+    if not data or "number" not in data:
+        return jsonify({"error": "Missing number"}), 400
+    
+    try:
+        number = float(data["number"])
+        return jsonify({"result": number * 2})
+    except ValueError:
+        return jsonify({"error": "Invalid number"}), 400
+
+@app.route("/api/health", methods=["GET"])
+def health_check():
+    return jsonify({"status": "ok"})
+
+if __name__ == "__main__":
+    app.run(port=8000)

package/templates/backend/flask/requirements.txt

@@ -0,0 +1,5 @@
+Flask==3.1.3
+Flask-Cors==4.0.0
+pytest==8.1.1
+httpx==0.27.0
+ruff==0.3.3

package/templates/backend/flask/start.sh

@@ -0,0 +1,7 @@
+#!/usr/bin/env bash
+if [ -d "venv" ]; then
+    source venv/bin/activate
+    python main.py
+else
+    python3 main.py
+fi

package/templates/backend/flask/test.sh

@@ -0,0 +1,7 @@
+#!/usr/bin/env bash
+if [ -d "venv" ]; then
+    source venv/bin/activate
+    pytest
+else
+    pytest
+fi

package/templates/backend/flask/test_main.py

@@ -0,0 +1,21 @@
+import pytest
+from main import app
+
+@pytest.fixture
+def client():
+    with app.test_client() as client:
+        yield client
+
+def test_health_check(client):
+    response = client.get("/api/health")
+    assert response.status_code == 200
+    assert response.get_json() == {"status": "ok"}
+
+def test_multiply_number(client):
+    response = client.post("/api/multiply", json={"number": 5})
+    assert response.status_code == 200
+    assert response.get_json() == {"result": 10.0}
+
+def test_multiply_number_invalid(client):
+    response = client.post("/api/multiply", json={"number": "not a number"})
+    assert response.status_code == 400

package/templates/base/.github/workflows/test.yml

@@ -0,0 +1,36 @@
+name: Fullstack Tests
+
+on:
+  push:
+    branches: [ main ]
+  pull_request:
+    branches: [ main ]
+
+jobs:
+  test:
+    runs-on: ubuntu-latest
+    steps:
+    - uses: actions/checkout@v4
+
+    - name: Set up Python
+      uses: actions/setup-python@v5
+      with:
+        python-version: '3.11'
+
+    - name: Set up Node.js
+      uses: actions/setup-node@v4
+      with:
+        node-version: '20'
+
+    - name: Install backend dependencies
+      run: |
+        cd backend
+        pip install -r requirements.txt
+
+    - name: Install frontend dependencies
+      run: |
+        cd frontend
+        npm install
+
+    - name: Run tests
+      run: ./test.sh

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

@@ -0,0 +1,8 @@
+{
+  "recommendations": [
+    "esbenp.prettier-vscode",
+    "dbaeumer.vscode-eslint",
+    "charliermarsh.ruff",
+    "ms-python.python"
+  ]
+}

package/templates/base/GEMINI.md

@@ -0,0 +1,65 @@
+# GEMINI.md
+
+Behavioral guidelines to reduce common LLM coding mistakes. Merge with project-specific instructions as needed.
+
+**Tradeoff:** These guidelines bias toward caution over speed. For trivial tasks, use judgment.
+
+## 1. Think Before Coding
+
+**Don't assume. Don't hide confusion. Surface tradeoffs.**
+
+Before implementing:
+- State your assumptions explicitly. If uncertain, ask.
+- If multiple interpretations exist, present them - don't pick silently.
+- If a simpler approach exists, say so. Push back when warranted.
+- If something is unclear, stop. Name what's confusing. Ask.
+
+## 2. Simplicity First
+
+**Minimum code that solves the problem. Nothing speculative.**
+
+- No features beyond what was asked.
+- No abstractions for single-use code.
+- No "flexibility" or "configurability" that wasn't requested.
+- No error handling for impossible scenarios.
+- If you write 200 lines and it could be 50, rewrite it.
+
+Ask yourself: "Would a senior engineer say this is overcomplicated?" If yes, simplify.
+
+## 3. Surgical Changes
+
+**Touch only what you must. Clean up only your own mess.**
+
+When editing existing code:
+- Don't "improve" adjacent code, comments, or formatting.
+- Don't refactor things that aren't broken.
+- Match existing style, even if you'd do it differently.
+- If you notice unrelated dead code, mention it - don't delete it.
+
+When your changes create orphans:
+- Remove imports/variables/functions that YOUR changes made unused.
+- Don't remove pre-existing dead code unless asked.
+
+The test: Every changed line should trace directly to the user's request.
+
+## 4. Goal-Driven Execution
+
+**Define success criteria. Loop until verified.**
+
+Transform tasks into verifiable goals:
+- "Add validation" → "Write tests for invalid inputs, then make them pass"
+- "Fix the bug" → "Write a test that reproduces it, then make it pass"
+- "Refactor X" → "Ensure tests pass before and after"
+
+For multi-step tasks, state a brief plan:
+```
+1. [Step] → verify: [check]
+2. [Step] → verify: [check]
+3. [Step] → verify: [check]
+```
+
+Strong success criteria let you loop independently. Weak criteria ("make it work") require constant clarification.
+
+---
+
+**These guidelines are working if:** fewer unnecessary changes in diffs, fewer rewrites due to overcomplication, and clarifying questions come before implementation rather than after mistakes.

package/templates/base/README.md

@@ -0,0 +1,37 @@
+# Your Fullstack Application
+
+> 🚀 This application was scaffolded using [create-fullstack-app](https://github.com/adriankulik/create-fullstack-app) by Adrian Kulik.
+
+## Quickstart
+
+This project is set up with unified shell scripts to easily manage both the frontend and backend simultaneously.
+
+### Prerequisites
+
+These scripts natively support **macOS** and **Linux**. If you are using **Windows**, you must use a Unix compatibility layer like **Git Bash** or **WSL** (Windows Subsystem for Linux) to run them.
+
+Depending on your environment, you may need to ensure the scripts are executable before running them for the first time:
+
+```bash
+chmod +x *.sh
+```
+
+### Running the App
+
+To start both the frontend and backend development servers, simply run:
+
+```bash
+./start.sh
+```
+
+### Testing and Linting
+
+- **Test:** Run all frontend and backend tests:
+  ```bash
+  ./test.sh
+  ```
+
+- **Lint:** Lint and format your codebase:
+  ```bash
+  ./lint.sh
+  ```

package/templates/base/gitignore

@@ -0,0 +1,13 @@
+node_modules/
+dist/
+build/
+.env
+.DS_Store
+coverage/
+.angular/
+.next/
+.svelte-kit/
+venv/
+__pycache__/
+.pytest_cache/
+.ruff_cache/

package/templates/base/lint.sh

@@ -0,0 +1,10 @@
+#!/usr/bin/env bash
+set -e
+
+echo "Linting and Formatting Backend..."
+(cd backend && ./lint.sh)
+
+echo "Linting and Formatting Frontend..."
+(cd frontend && ./lint.sh)
+
+echo "Linting and formatting complete!"

package/templates/base/start.sh

@@ -0,0 +1,13 @@
+#!/usr/bin/env bash
+set -e
+
+echo "Starting Backend..."
+(cd backend && ./start.sh) &
+BACKEND_PID=$!
+
+echo "Starting Frontend..."
+(cd frontend && ./start.sh) &
+FRONTEND_PID=$!
+
+echo "Services started. Press Ctrl+C to stop."
+wait $BACKEND_PID $FRONTEND_PID

package/templates/base/test.sh

@@ -0,0 +1,10 @@
+#!/usr/bin/env bash
+set -e
+
+echo "Running Backend Tests..."
+(cd backend && ./test.sh)
+
+echo "Running Frontend Tests..."
+(cd frontend && ./test.sh)
+
+echo "All tests passed!"

package/templates/frontend/angular/angular.json

@@ -0,0 +1,84 @@
+{
+  "$schema": "./node_modules/@angular/cli/lib/config/schema.json",
+  "version": 1,
+  "newProjectRoot": "projects",
+  "projects": {
+    "frontend": {
+      "projectType": "application",
+      "schematics": {},
+      "root": "",
+      "sourceRoot": "src",
+      "prefix": "app",
+      "architect": {
+        "build": {
+          "builder": "@angular-devkit/build-angular:browser",
+          "options": {
+            "outputPath": "dist/frontend",
+            "index": "src/index.html",
+            "main": "src/main.ts",
+            "polyfills": ["zone.js"],
+            "tsConfig": "tsconfig.app.json",
+            "assets": ["src/favicon.ico", "src/assets"],
+            "styles": ["src/styles.css"],
+            "scripts": []
+          },
+          "configurations": {
+            "production": {
+              "budgets": [
+                {
+                  "type": "initial",
+                  "maximumWarning": "500kb",
+                  "maximumError": "1mb"
+                },
+                {
+                  "type": "anyComponentStyle",
+                  "maximumWarning": "2kb",
+                  "maximumError": "4kb"
+                }
+              ],
+              "outputHashing": "all"
+            },
+            "development": {
+              "buildOptimizer": false,
+              "optimization": false,
+              "vendorChunk": true,
+              "extractLicenses": false,
+              "sourceMap": true,
+              "namedChunks": true
+            }
+          },
+          "defaultConfiguration": "production"
+        },
+        "serve": {
+          "builder": "@angular-devkit/build-angular:dev-server",
+          "configurations": {
+            "production": {
+              "buildTarget": "frontend:build:production"
+            },
+            "development": {
+              "buildTarget": "frontend:build:development"
+            }
+          },
+          "defaultConfiguration": "development"
+        },
+        "extract-i18n": {
+          "builder": "@angular-devkit/build-angular:extract-i18n",
+          "options": {
+            "buildTarget": "frontend:build"
+          }
+        },
+        "test": {
+          "builder": "@angular-devkit/build-angular:karma",
+          "options": {
+            "polyfills": ["zone.js", "zone.js/testing"],
+            "tsConfig": "tsconfig.spec.json",
+            "karmaConfig": "karma.conf.js",
+            "assets": ["src/favicon.ico", "src/assets"],
+            "styles": ["src/styles.css"],
+            "scripts": []
+          }
+        }
+      }
+    }
+  }
+}

package/templates/frontend/angular/karma.conf.js

@@ -0,0 +1,45 @@
+process.env.CHROME_BIN = require('puppeteer').executablePath();
+
+module.exports = function (config) {
+  config.set({
+    basePath: '',
+    frameworks: ['jasmine', '@angular-devkit/build-angular'],
+    plugins: [
+      require('karma-jasmine'),
+      require('karma-chrome-launcher'),
+      require('karma-jasmine-html-reporter'),
+      require('karma-coverage'),
+      require('@angular-devkit/build-angular/plugins/karma')
+    ],
+    client: {
+      jasmine: {
+      },
+      clearContext: false
+    },
+    jasmineHtmlReporter: {
+      suppressAll: true
+    },
+    coverageReporter: {
+      dir: require('path').join(__dirname, './coverage/frontend'),
+      subdir: '.',
+      reporters: [
+        { type: 'html' },
+        { type: 'text-summary' }
+      ]
+    },
+    reporters: ['progress', 'kjhtml'],
+    port: 9876,
+    colors: true,
+    logLevel: config.LOG_INFO,
+    autoWatch: true,
+    browsers: ['Chrome', 'ChromeHeadlessCI'],
+    customLaunchers: {
+      ChromeHeadlessCI: {
+        base: 'ChromeHeadless',
+        flags: ['--no-sandbox']
+      }
+    },
+    singleRun: false,
+    restartOnFileChange: true
+  });
+};

package/templates/frontend/angular/lint.sh

@@ -0,0 +1,2 @@
+#!/usr/bin/env bash
+npm run lint