@adriankulik/create-fullstack-app 1.2.0 → 1.4.0

package/README.md

@@ -5,6 +5,7 @@ A CLI tool for scaffolding a full-stack web application with your choice of fron
 ## Prerequisites
 
 Before running the CLI or the scaffolded applications, ensure you have the following installed on your system:
+
 - **Node.js**: v20 or newer
 - **npm**: v10 or newer
 - **Python**: v3.11 or newer
@@ -17,7 +18,7 @@ To generate a new full-stack application, simply run:
 npx @adriankulik/create-fullstack-app@latest
 ```
 
-*(If you are developing locally, run `npm install` in the root directory and execute `node cli/index.js`).*
+_(If you are developing locally, run `npm install` in the root directory and execute `node cli/index.js`)._
 
 You will be prompted to choose a project name, your preferred frontend, and backend framework.
 
@@ -25,15 +26,18 @@ You will be prompted to choose a project name, your preferred frontend, and back
 
 - **Frontend Options**:
   - Next.js (v16.2.4)
-  - Angular (v21.0.0) - *Configured with Zone.js*
+  - Angular (v21.0.0) - _Configured with Zone.js_
   - Vue (v3.5.33)
   - Svelte (v5.55.5)
-- **Backend Options**: 
+- **Backend Options**:
   - FastAPI (v0.136.1)
   - Flask (v3.1.3)
+  - .NET (v8.0)
+  - Node.js Express (v4.19.2)
+  - Rust Rocket (v0.5.0)
 - **Opinionated Defaults**: We bake in sensible, predefined choices (e.g., Angular uses `zone.js`, testing is unified under Playwright and framework-native test runners).
 - **Unified Scripts**: `start.sh`, `test.sh`, and `lint.sh` available out of the box to manage both frontend and backend seamlessly.
-- **CI/CD Ready**: Includes a pre-configured `.github/workflows/cli-e2e.yml` that tests both ends. *Tip: To enforce this, enable branch protection in your GitHub repository settings and require the "test" status check to pass.*
+- **CI/CD Ready**: Includes a pre-configured `.github/workflows/cli-e2e.yml` that tests both ends. _Tip: To enforce this, enable branch protection in your GitHub repository settings and require the "test" status check to pass._
 - **Developer Experience**: Includes `.vscode/extensions.json` recommending the necessary linters and formatters, and an `AGENTS.md` file providing behavioral guidelines for AI agents (based on [andrej-karpathy-skills](https://github.com/forrestchang/andrej-karpathy-skills)). It is AI development friendly, including an extensive set of agent skills in `.agents/skills` sourced from [claude-skills](https://github.com/alirezarezvani/claude-skills).
   <details>
   <summary>Included Agent Skills</summary>
@@ -60,7 +64,7 @@ my-app/
 └── lint.sh
 ```
 
-*Note: Depending on your environment, you may need to ensure the generated shell scripts are executable by running `chmod +x *.sh` inside your new project directory.*
+\_Note: Depending on your environment, you may need to ensure the generated shell scripts are executable by running `chmod +x *.sh` inside your new project directory.\
 
 ## Local E2E Testing
 
@@ -85,11 +89,10 @@ Then run it:
 Future plans for this CLI include:
 
 - Adding frontend framework-specific component libraries during the scaffold step.
-- Tackling **.NET** as a new backend option.
 
 ## Acknowledgements
 
-This project redistributes boilerplate code and configuration files generated by the official CLIs and templates of the integrated frameworks. We are grateful to the maintainers of these projects:
+This project redistributes boilerplate code and configuration files generated by the official CLIs and templates of the integrated frameworks. I'm grateful to the maintainers of these projects:
 
 - [Next.js](https://nextjs.org/) (MIT License)
 - [Angular](https://angular.dev/) (MIT License)
@@ -97,3 +100,6 @@ This project redistributes boilerplate code and configuration files generated by
 - [Svelte](https://svelte.dev/) (MIT License)
 - [FastAPI](https://fastapi.tiangolo.com/) (MIT License)
 - [Flask](https://flask.palletsprojects.com/) (BSD 3-Clause License)
+- [.NET](https://dotnet.microsoft.com/) (MIT License)
+- [Express](https://expressjs.com/) (MIT License)
+- [Rocket](https://rocket.rs/) (MIT License)

package/cli/index.js

@@ -1,61 +1,104 @@
 #!/usr/bin/env node
 
-const prompts = require('prompts');
-const pc = require('picocolors');
-const fs = require('fs-extra');
-const path = require('path');
-const { execSync } = require('child_process');
+const prompts = require("prompts");
+const pc = require("picocolors");
+const fs = require("fs-extra");
+const path = require("path");
+const { execSync } = require("child_process");
 
 async function main() {
-  console.log(pc.cyan('\nWelcome to create-fullstack-app!\n'));
+  const { asciiArt } = require("./logo");
+  console.log(pc.cyan(asciiArt));
+  console.log(pc.cyan("\nWelcome to create-fullstack-app!\n"));
 
   // Simple argument parsing
   const args = process.argv.slice(2);
-  let argProjectName = args[0] && !args[0].startsWith('--') ? args[0] : null;
+  let argProjectName = args[0] && !args[0].startsWith("--") ? args[0] : null;
   let argFrontend = null;
   let argBackend = null;
 
   for (let i = 0; i < args.length; i++) {
-    if (args[i] === '--frontend' && args[i + 1]) argFrontend = args[i + 1];
-    if (args[i] === '--backend' && args[i + 1]) argBackend = args[i + 1];
+    if (args[i] === "--frontend" && args[i + 1]) argFrontend = args[i + 1];
+    if (args[i] === "--backend" && args[i + 1]) argBackend = args[i + 1];
   }
 
   const questions = [];
   if (!argProjectName) {
     questions.push({
-      type: 'text',
-      name: 'projectName',
-      message: 'What is your project named?',
-      initial: 'my-fullstack-app',
-      validate: value => value.trim().length > 0 ? true : 'Project name cannot be empty'
+      type: "text",
+      name: "projectName",
+      message: "What is your project named?",
+      initial: "my-fullstack-app",
+      validate: (value) =>
+        value.trim().length > 0 ? true : "Project name cannot be empty",
     });
   }
 
   if (!argFrontend) {
     questions.push({
-      type: 'select',
-      name: 'frontend',
-      message: 'Which frontend framework would you like to use?',
+      type: "select",
+      name: "frontend",
+      message: "Which frontend framework would you like to use?",
       choices: [
-        { title: 'Next.js', value: 'nextjs', description: 'React framework' },
-        { title: 'Angular', value: 'angular', description: 'Enterprise-grade platform' },
-        { title: 'Vue', value: 'vue', description: 'Progressive JavaScript framework' },
-        { title: 'Svelte', value: 'svelte', description: 'Cybernetically enhanced web apps' }
+        { title: "Next.js", value: "nextjs", description: "React framework" },
+        {
+          title: "Angular",
+          value: "angular",
+          description: "Enterprise-grade platform",
+        },
+        {
+          title: "Vue",
+          value: "vue",
+          description: "Progressive JavaScript framework",
+        },
+        {
+          title: "Svelte",
+          value: "svelte",
+          description: "Cybernetically enhanced web apps",
+        },
       ],
-      initial: 0
+      initial: 0,
     });
   }
 
   if (!argBackend) {
     questions.push({
-      type: 'select',
-      name: 'backend',
-      message: 'Which backend framework would you like to use?',
+      type: "select",
+      name: "backend",
+      message: "Which backend framework would you like to use?",
       choices: [
-        { title: 'FastAPI', value: 'fastapi', description: 'Modern, fast Python web framework' },
-        { title: 'Flask', value: 'flask', description: 'Lightweight WSGI web application framework' }
+        {
+          title: "FastAPI",
+          value: "fastapi",
+          description: "Modern, fast Python web framework",
+        },
+        {
+          title: "Flask",
+          value: "flask",
+          description: "Lightweight Python WSGI web application framework",
+        },
+        {
+          title: ".NET",
+          value: "dotnet",
+          description: "Robust, C#, high-performance framework by Microsoft",
+        },
+        {
+          title: "Spring Boot",
+          value: "spring-boot",
+          description: "Powerful, Java, enterprise-ready framework",
+        },
+        {
+          title: "Node.js (Express)",
+          value: "nodejs",
+          description: "Minimalist web framework for Node.js",
+        },
+        {
+          title: "Rust (Rocket)",
+          value: "rust",
+          description: "Web framework for Rust with focus on ease of use",
+        }
       ],
-      initial: 0
+      initial: 0,
     });
   }
 
@@ -66,7 +109,7 @@ async function main() {
   const backend = argBackend || response.backend;
 
   if (!projectName || !frontend || !backend) {
-    console.log(pc.red('Setup cancelled.'));
+    console.log(pc.red("Setup cancelled."));
     process.exit(1);
   }
   const targetDir = path.resolve(process.cwd(), projectName);
@@ -79,28 +122,31 @@ async function main() {
   console.log(pc.blue(`\nScaffolding project in ${targetDir}...`));
 
   // Determine paths to templates relative to the CLI script
-  const templatesDir = path.resolve(__dirname, '../templates');
-  const baseDir = path.join(templatesDir, 'base');
-  const frontendDir = path.join(templatesDir, 'frontend', frontend);
-  const backendDir = path.join(templatesDir, 'backend', backend);
+  const templatesDir = path.resolve(__dirname, "../templates");
+  const baseDir = path.join(templatesDir, "base");
+  const frontendDir = path.join(templatesDir, "frontend", frontend);
+  const backendDir = path.join(templatesDir, "backend", backend);
 
   try {
     // 1. Copy base template
     await fs.copy(baseDir, targetDir);
-    if (fs.existsSync(path.join(targetDir, 'gitignore'))) {
-      await fs.rename(path.join(targetDir, 'gitignore'), path.join(targetDir, '.gitignore'));
+    if (fs.existsSync(path.join(targetDir, "gitignore"))) {
+      await fs.rename(
+        path.join(targetDir, "gitignore"),
+        path.join(targetDir, ".gitignore"),
+      );
     }
 
     // 2. Copy frontend
-    const targetFrontend = path.join(targetDir, 'frontend');
+    const targetFrontend = path.join(targetDir, "frontend");
     await fs.copy(frontendDir, targetFrontend);
 
     // 3. Copy backend
-    const targetBackend = path.join(targetDir, 'backend');
+    const targetBackend = path.join(targetDir, "backend");
     await fs.copy(backendDir, targetBackend);
 
     // 4. Update package.json name for the frontend
-    const pkgPath = path.join(targetFrontend, 'package.json');
+    const pkgPath = path.join(targetFrontend, "package.json");
     if (fs.existsSync(pkgPath)) {
       const pkg = await fs.readJson(pkgPath);
       pkg.name = `${projectName}-frontend`;
@@ -110,11 +156,11 @@ async function main() {
     // 5. Make all shell scripts executable
     const makeExecutable = (dir) => {
       const files = fs.readdirSync(dir);
-      files.forEach(file => {
+      files.forEach((file) => {
         const filePath = path.join(dir, file);
         if (fs.statSync(filePath).isDirectory()) {
           makeExecutable(filePath);
-        } else if (file.endsWith('.sh')) {
+        } else if (file.endsWith(".sh")) {
           fs.chmodSync(filePath, 0o755);
         }
       });
@@ -122,58 +168,102 @@ async function main() {
     makeExecutable(targetDir);
 
     // 6. Install dependencies
-    console.log(pc.blue('\nInstalling dependencies (this may take a minute)...'));
+    console.log(
+      pc.blue("\nInstalling dependencies (this may take a minute)..."),
+    );
 
     // Frontend installation
-    console.log(pc.cyan('  Installing frontend dependencies...'));
-    execSync('npm ci', { cwd: targetFrontend, stdio: 'inherit' });
+    console.log(pc.cyan("  Installing frontend dependencies..."));
+    execSync("npm ci", { cwd: targetFrontend, stdio: "inherit" });
 
-    // Backend installation
-    console.log(pc.cyan('  Setting up backend virtual environment...'));
-    const pythonCmd = process.platform === 'win32' ? 'python' : 'python3';
-    try {
-      execSync(`${pythonCmd} -m venv venv`, { cwd: targetBackend, stdio: 'inherit' });
-      
-      const pipPath = process.platform === 'win32' 
-        ? path.join('venv', 'Scripts', 'pip') 
-        : path.join('venv', 'bin', 'pip');
-      
-      console.log(pc.cyan('  Installing backend dependencies...'));
-      execSync(`${pipPath} install -r requirements.txt`, { cwd: targetBackend, stdio: 'inherit' });
-    } catch (e) {
-      console.log(pc.yellow('  Could not set up Python virtual environment automatically. Please set it up manually.'));
+    if (backend === "fastapi" || backend === "flask") {
+      console.log(pc.cyan("  Setting up backend virtual environment..."));
+      const pythonCmd = process.platform === "win32" ? "python" : "python3";
+      try {
+        execSync(`${pythonCmd} -m venv venv`, {
+          cwd: targetBackend,
+          stdio: "inherit",
+        });
+
+        const pipPath =
+          process.platform === "win32"
+            ? path.join("venv", "Scripts", "pip")
+            : path.join("venv", "bin", "pip");
+
+        console.log(pc.cyan("  Installing backend dependencies..."));
+        execSync(`${pipPath} install -r requirements.txt`, {
+          cwd: targetBackend,
+          stdio: "inherit",
+        });
+      } catch (e) {
+        console.log(
+          pc.yellow(
+            "  Could not set up Python virtual environment automatically. Please set it up manually.",
+          ),
+        );
+      }
+    } else if (backend === "dotnet") {
+      console.log(pc.cyan("  Restoring .NET dependencies..."));
+      try {
+        execSync("dotnet restore backend.sln", { cwd: targetBackend, stdio: "inherit" });
+      } catch (e) {
+        console.log(
+          pc.yellow(
+            "  Could not restore .NET dependencies automatically. Please make sure .NET SDK is installed.",
+          ),
+        );
+      }
+    } else if (backend === "spring-boot") {
+      console.log(
+        pc.cyan(
+          "  Spring Boot project created. Dependencies will be downloaded via Maven wrapper on first run.",
+        ),
+      );
+    } else if (backend === "nodejs") {
+      console.log(pc.cyan("  Installing Node.js backend dependencies..."));
+      execSync("npm ci", { cwd: targetBackend, stdio: "inherit" });
+    } else if (backend === "rust") {
+      console.log(pc.cyan("  Rust backend created. Cargo will manage dependencies automatically on first run."));
     }
 
     // 7. Initialize Git repository
-    console.log(pc.blue('\nInitializing Git repository...'));
+    console.log(pc.blue("\nInitializing Git repository..."));
     try {
-      execSync('git init', { cwd: targetDir, stdio: 'ignore' });
-      execSync('git add .', { cwd: targetDir, stdio: 'ignore' });
-      execSync('git commit -m "Initial commit from create-fullstack-app"', { cwd: targetDir, stdio: 'ignore' });
-      console.log(pc.cyan('  Git repository initialized.'));
+      execSync("git init", { cwd: targetDir, stdio: "ignore" });
+      execSync("git add .", { cwd: targetDir, stdio: "ignore" });
+      execSync('git commit -m "Initial commit from create-fullstack-app"', {
+        cwd: targetDir,
+        stdio: "ignore",
+      });
+      console.log(pc.cyan("  Git repository initialized."));
     } catch (e) {
-      console.log(pc.yellow('  Could not initialize Git repository automatically. You may need to run git init yourself.'));
+      console.log(
+        pc.yellow(
+          "  Could not initialize Git repository automatically. You may need to run git init yourself.",
+        ),
+      );
     }
 
     console.log(pc.green(`\nSuccess! Created ${projectName} at ${targetDir}`));
-    console.log('\nInside that directory, you can run several commands:\n');
+    console.log("\nInside that directory, you can run several commands:\n");
 
-    console.log(`  ${pc.cyan('./start.sh')}`);
-    console.log('    Starts both the backend and frontend development servers.\n');
+    console.log(`  ${pc.cyan("./start.sh")}`);
+    console.log(
+      "    Starts both the backend and frontend development servers.\n",
+    );
 
-    console.log(`  ${pc.cyan('./test.sh')}`);
-    console.log('    Runs tests for both frontend and backend.\n');
+    console.log(`  ${pc.cyan("./test.sh")}`);
+    console.log("    Runs tests for both frontend and backend.\n");
 
-    console.log(`  ${pc.cyan('./lint.sh')}`);
-    console.log('    Lints and formats both frontend and backend code.\n');
+    console.log(`  ${pc.cyan("./lint.sh")}`);
+    console.log("    Lints and formats both frontend and backend code.\n");
 
-    console.log('\nWe suggest that you begin by typing:\n');
+    console.log("\nWe suggest that you begin by typing:\n");
     console.log(pc.cyan(`  cd ${projectName}`));
-    console.log(pc.cyan('  ./start.sh'));
-    console.log('\nHappy coding!');
-
+    console.log(pc.cyan("  ./start.sh"));
+    console.log("\nHappy coding!");
   } catch (error) {
-    console.error(pc.red('Error scaffolding project:'), error);
+    console.error(pc.red("Error scaffolding project:"), error);
     process.exit(1);
   }
 }

package/cli/logo.js

@@ -0,0 +1,11 @@
+module.exports = {
+  asciiArt: `
+     █▒▒    █▒▒▒▒▒▒▒▒      █▒       
+  █▒▒   █▒▒ █▒▒            █▒ ▒▒     
+ █▒▒        █▒▒           █▒  █▒▒    
+ █▒▒        █▒▒▒▒▒▒      █▒▒   █▒▒   
+ █▒▒        █▒▒         █▒▒▒▒▒▒ █▒▒  
+  █▒▒   █▒▒ █▒▒        █▒▒       █▒▒ 
+    █▒▒▒▒   █▒▒       █▒▒         █▒▒
+`,
+};

package/package.json

@@ -3,7 +3,7 @@
   "publishConfig": {
     "access": "public"
   },
-  "version": "1.2.0",
+  "version": "1.4.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": {
@@ -22,9 +22,9 @@
     "prompts": "^2.4.2"
   },
   "devDependencies": {
-    "@playwright/test": "^1.59.1",
+    "@playwright/test": "^1.60.0",
     "vitest": "^4.1.5",
-    "wait-on": "^9.0.5"
+    "wait-on": "^9.0.10"
   },
   "scripts": {
     "test": "echo \"Error: no test specified\" && exit 1"
@@ -35,7 +35,7 @@
   },
   "keywords": [],
   "author": "",
-  "license": "ISC",
+  "license": "MIT",
   "bugs": {
     "url": "https://github.com/adriankulik/create-fullstack-app/issues"
   },

package/templates/backend/dotnet/Program.cs

@@ -0,0 +1,32 @@
+using Microsoft.AspNetCore.Mvc;
+
+var builder = WebApplication.CreateBuilder(args);
+
+// Add CORS to allow frontend to access
+builder.Services.AddCors(options =>
+{
+    options.AddDefaultPolicy(policy =>
+    {
+        policy.AllowAnyOrigin().AllowAnyHeader().AllowAnyMethod();
+    });
+});
+
+var app = builder.Build();
+
+app.UseCors();
+
+app.MapPost("/api/multiply", ([FromBody] MultiplyRequest request) =>
+{
+    return new { result = request.Number * 2 };
+});
+
+
+
+app.Run("http://localhost:8000");
+
+class MultiplyRequest
+{
+    public double Number { get; set; }
+}
+
+public partial class Program { }

package/templates/backend/dotnet/Properties/launchSettings.json

@@ -0,0 +1,41 @@
+{
+  "$schema": "http://json.schemastore.org/launchsettings.json",
+  "iisSettings": {
+    "windowsAuthentication": false,
+    "anonymousAuthentication": true,
+    "iisExpress": {
+      "applicationUrl": "http://localhost:46754",
+      "sslPort": 44359
+    }
+  },
+  "profiles": {
+    "http": {
+      "commandName": "Project",
+      "dotnetRunMessages": true,
+      "launchBrowser": true,
+      "launchUrl": "weatherforecast",
+      "applicationUrl": "http://localhost:5028",
+      "environmentVariables": {
+        "ASPNETCORE_ENVIRONMENT": "Development"
+      }
+    },
+    "https": {
+      "commandName": "Project",
+      "dotnetRunMessages": true,
+      "launchBrowser": true,
+      "launchUrl": "weatherforecast",
+      "applicationUrl": "https://localhost:7200;http://localhost:5028",
+      "environmentVariables": {
+        "ASPNETCORE_ENVIRONMENT": "Development"
+      }
+    },
+    "IIS Express": {
+      "commandName": "IISExpress",
+      "launchBrowser": true,
+      "launchUrl": "weatherforecast",
+      "environmentVariables": {
+        "ASPNETCORE_ENVIRONMENT": "Development"
+      }
+    }
+  }
+}

package/templates/backend/dotnet/Tests/GlobalUsings.cs

@@ -0,0 +1 @@
+global using Xunit;

package/templates/backend/dotnet/Tests/Tests.csproj

@@ -0,0 +1,30 @@
+<Project Sdk="Microsoft.NET.Sdk">
+
+  <PropertyGroup>
+    <TargetFramework>net8.0</TargetFramework>
+    <ImplicitUsings>enable</ImplicitUsings>
+    <Nullable>enable</Nullable>
+
+    <IsPackable>false</IsPackable>
+    <IsTestProject>true</IsTestProject>
+  </PropertyGroup>
+
+  <ItemGroup>
+    <PackageReference Include="Microsoft.AspNetCore.Mvc.Testing" Version="8.0.0" />
+    <PackageReference Include="Microsoft.NET.Test.Sdk" Version="17.6.0" />
+    <PackageReference Include="xunit" Version="2.4.2" />
+    <PackageReference Include="xunit.runner.visualstudio" Version="2.4.5">
+      <IncludeAssets>runtime; build; native; contentfiles; analyzers; buildtransitive</IncludeAssets>
+      <PrivateAssets>all</PrivateAssets>
+    </PackageReference>
+    <PackageReference Include="coverlet.collector" Version="6.0.0">
+      <IncludeAssets>runtime; build; native; contentfiles; analyzers; buildtransitive</IncludeAssets>
+      <PrivateAssets>all</PrivateAssets>
+    </PackageReference>
+  </ItemGroup>
+
+  <ItemGroup>
+    <ProjectReference Include="..\dotnet.csproj" />
+  </ItemGroup>
+
+</Project>

package/templates/backend/dotnet/Tests/UnitTest1.cs

@@ -0,0 +1,43 @@
+using System.Net.Http.Json;
+using Microsoft.AspNetCore.Mvc.Testing;
+
+namespace Tests;
+
+public class UnitTest1 : IClassFixture<WebApplicationFactory<Program>>
+{
+    private readonly WebApplicationFactory<Program> _factory;
+
+    public UnitTest1(WebApplicationFactory<Program> factory)
+    {
+        _factory = factory;
+    }
+
+    [Fact]
+    public async Task MultiplyEndpoint_ReturnsDouble()
+    {
+        var client = _factory.CreateClient();
+        var request = new { number = 5 };
+
+        var response = await client.PostAsJsonAsync("/api/multiply", request);
+        response.EnsureSuccessStatusCode();
+
+        var result = await response.Content.ReadFromJsonAsync<MultiplyResponse>();
+        Assert.NotNull(result);
+        Assert.Equal(10, result.result);
+    }
+    
+    [Fact]
+    public async Task MultiplyEndpoint_Returns400_ForInvalidInput()
+    {
+        var client = _factory.CreateClient();
+        var request = new { number = "not a number" };
+
+        var response = await client.PostAsJsonAsync("/api/multiply", request);
+        Assert.Equal(System.Net.HttpStatusCode.BadRequest, response.StatusCode);
+    }
+    
+    class MultiplyResponse
+    {
+        public double result { get; set; }
+    }
+}