create-backlist 5.0.0 → 5.0.1

package/bin/index.js

@@ -98,6 +98,18 @@ async function main() {
         ],
         when: (answers) => answers.stack === 'node-ts-express'
     },
+     {
+      type: 'list',
+      name: 'stack',
+      message: 'Select the backend stack:',
+      choices: [
+        { name: 'Node.js (TypeScript, Express)', value: 'node-ts-express' },
+        { name: 'C# (ASP.NET Core Web API)', value: 'dotnet-webapi' },
+        new inquirer.Separator(),
+        { name: 'Python (FastAPI) - Coming Soon', disabled: true, value: 'python-fastapi' },
+        { name: 'Java (Spring Boot)', value: 'java-spring' }, // <-- ENABLED!
+      ],
+    },
   ]);
 
   const options = {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "create-backlist",
-  "version": "5.0.0",
+  "version": "5.0.1",
   "description": "An advanced, multi-language backend generator based on frontend analysis.",
   "type": "commonjs",
   "bin": {
@@ -18,11 +18,13 @@
   "dependencies": {
     "@babel/parser": "^7.22.7",
     "@babel/traverse": "^7.22.8",
+    "axios": "^1.13.1",
     "chalk": "^4.1.2",
     "ejs": "^3.1.9",
     "execa": "^6.1.0",
     "fs-extra": "^11.1.1",
     "glob": "^10.3.3",
-    "inquirer": "^8.2.4"
+    "inquirer": "^8.2.4",
+    "unzipper": "^0.12.3"
   }
-}
+}

package/src/generators/java.js

@@ -0,0 +1,100 @@
+const chalk = require('chalk');
+const { execa } = require('execa');
+const fs = require('fs-extra');
+const path = require('path');
+const axios = require('axios'); // For making HTTP requests
+const unzipper = require('unzipper'); // For extracting .zip files
+const { analyzeFrontend } = require('../analyzer');
+const { renderAndWrite, getTemplatePath } = require('./template');
+
+async function generateJavaProject(options) {
+  const { projectDir, projectName, frontendSrcDir } = options;
+  const group = 'com.backlist.generated'; // A default Java group ID
+
+  try {
+    // --- Step 1: Download Base Project from Spring Initializr ---
+    console.log(chalk.blue('  -> Contacting Spring Initializr to download a base Spring Boot project...'));
+    
+    // Define standard dependencies for a web API
+    const dependencies = 'web,data-jpa,lombok,postgresql'; // Using PostgreSQL as an example DB driver
+    const springInitializrUrl = `https://start.spring.io/starter.zip?type=maven-project&language=java&bootVersion=3.2.0&groupId=${group}&artifactId=${projectName}&name=${projectName}&dependencies=${dependencies}`;
+
+    const response = await axios({
+      url: springInitializrUrl,
+      method: 'GET',
+      responseType: 'stream'
+    });
+
+    // --- Step 2: Unzip the Downloaded Project ---
+    console.log(chalk.blue('  -> Unzipping the Spring Boot project...'));
+    await new Promise((resolve, reject) => {
+      const stream = response.data.pipe(unzipper.Extract({ path: projectDir }));
+      stream.on('finish', () => {
+        console.log(chalk.gray('    -> Project unzipped successfully.'));
+        resolve();
+      });
+      stream.on('error', reject);
+    });
+
+    // --- Step 3: Analyze Frontend ---
+    const endpoints = await analyzeFrontend(frontendSrcDir);
+    const modelsToGenerate = new Map();
+    endpoints.forEach(ep => {
+      if (ep.schemaFields && ep.controllerName !== 'Default' && !modelsToGenerate.has(ep.controllerName)) {
+        modelsToGenerate.set(ep.controllerName, { name: ep.controllerName, fields: Object.entries(ep.schemaFields).map(([key, type]) => ({ name: key, type })) });
+      }
+    });
+
+    // --- Step 4: Generate Java Entities and Controllers ---
+    if (modelsToGenerate.size > 0) {
+      console.log(chalk.blue('  -> Generating Java entities and controllers...'));
+      
+      const javaSrcPath = path.join(projectDir, 'src', 'main', 'java', ...group.split('.'), projectName);
+      const entityDir = path.join(javaSrcPath, 'model');
+      const controllerDir = path.join(javaSrcPath, 'controller');
+      await fs.ensureDir(entityDir);
+      await fs.ensureDir(controllerDir);
+
+      for (const [modelName, modelData] of modelsToGenerate.entries()) {
+        await renderAndWrite(
+          getTemplatePath('java-spring/partials/Entity.java.ejs'),
+          path.join(entityDir, `${modelName}.java`),
+          { group, projectName, modelName, model: modelData }
+        );
+        await renderAndWrite(
+          getTemplatePath('java-spring/partials/Controller.java.ejs'),
+          path.join(controllerDir, `${modelName}Controller.java`),
+          { group, projectName, controllerName: modelName }
+        );
+      }
+    }
+
+    // --- Step 5: Configure application.properties ---
+    console.log(chalk.blue('  -> Configuring database in application.properties...'));
+    const propsPath = path.join(projectDir, 'src', 'main', 'resources', 'application.properties');
+    const dbProps = [
+      `\n\n# --- Auto-generated by create-backlist ---`,
+      `# --- Database Configuration (PostgreSQL) ---`,
+      `spring.datasource.url=jdbc:postgresql://localhost:5432/${projectName}`,
+      `spring.datasource.username=postgres`,
+      `spring.datasource.password=password`,
+      `spring.jpa.hibernate.ddl-auto=update`,
+      `spring.jpa.show-sql=true`,
+    ];
+    await fs.appendFile(propsPath, dbProps.join('\n'));
+    
+    console.log(chalk.green('  -> Java (Spring Boot) backend generation is complete!'));
+    console.log(chalk.yellow('\nTo run your new Java backend:'));
+    console.log(chalk.cyan('  1. Open the project in a Java IDE (like IntelliJ IDEA or VS Code).'));
+    console.log(chalk.cyan('  2. Run the main application file.'));
+
+
+  } catch (error) {
+    if (error.response) {
+      throw new Error(`Failed to download from Spring Initializr. Status: ${error.response.status}`);
+    }
+    throw error;
+  }
+}
+
+module.exports = { generateJavaProject };

package/src/generators/node.js

@@ -36,39 +36,39 @@ async function generateNodeProject(options) {
     await fs.copy(getTemplatePath('node-ts-express/base/server.ts'), path.join(destSrcDir, 'server.ts'));
     await fs.copy(getTemplatePath('node-ts-express/base/tsconfig.json'), path.join(projectDir, 'tsconfig.json'));
     
-    // --- Step 4: Prepare and Write package.json with All Conditional Dependencies ---
+    // --- Step 4: Prepare and Write package.json ---
     const packageJsonContent = JSON.parse(await ejs.renderFile(getTemplatePath('node-ts-express/partials/package.json.ejs'), { projectName }));
     
-    if (dbType === 'mongoose') packageJsonContent.dependencies['mongoose'] = '^7.5.0';
+    if (dbType === 'mongoose') packageJsonContent.dependencies['mongoose'] = '^7.6.3';
     if (dbType === 'prisma') {
-      packageJsonContent.dependencies['@prisma/client'] = '^5.5.2';
-      packageJsonContent.devDependencies['prisma'] = '^5.5.2';
+      packageJsonContent.dependencies['@prisma/client'] = '^5.6.0';
+      packageJsonContent.devDependencies['prisma'] = '^5.6.0';
       packageJsonContent.prisma = { seed: `ts-node ${addSeeder ? 'scripts/seeder.ts' : 'prisma/seed.ts'}` };
     }
     if (addAuth) {
       packageJsonContent.dependencies['jsonwebtoken'] = '^9.0.2';
       packageJsonContent.dependencies['bcryptjs'] = '^2.4.3';
-      packageJsonContent.devDependencies['@types/jsonwebtoken'] = '^9.0.2';
-      packageJsonContent.devDependencies['@types/bcryptjs'] = '^2.4.2';
+      packageJsonContent.devDependencies['@types/jsonwebtoken'] = '^9.0.5';
+      packageJsonContent.devDependencies['@types/bcryptjs'] = '^2.4.6';
     }
     if (addSeeder) {
-      packageJsonContent.devDependencies['@faker-js/faker'] = '^8.2.0';
-      packageJsonContent.dependencies['chalk'] = '^4.1.2';
+      packageJsonContent.devDependencies['@faker-js/faker'] = '^8.3.1';
+      if (!packageJsonContent.dependencies['chalk']) packageJsonContent.dependencies['chalk'] = '^4.1.2';
       packageJsonContent.scripts['seed'] = `ts-node scripts/seeder.ts`;
       packageJsonContent.scripts['destroy'] = `ts-node scripts/seeder.ts -d`;
     }
     if (extraFeatures.includes('testing')) {
       packageJsonContent.devDependencies['jest'] = '^29.7.0';
       packageJsonContent.devDependencies['supertest'] = '^6.3.3';
-      packageJsonContent.devDependencies['@types/jest'] = '^29.5.5';
-      packageJsonContent.devDependencies['@types/supertest'] = '^2.0.14';
+      packageJsonContent.devDependencies['@types/jest'] = '^29.5.10';
+      packageJsonContent.devDependencies['@types/supertest'] = '^2.0.16';
       packageJsonContent.devDependencies['ts-jest'] = '^29.1.1';
-      packageJsonContent.scripts['test'] = 'jest --detectOpenHandles';
+      packageJsonContent.scripts['test'] = 'jest --detectOpenHandles --forceExit';
     }
     if (extraFeatures.includes('swagger')) {
       packageJsonContent.dependencies['swagger-ui-express'] = '^5.0.0';
       packageJsonContent.dependencies['swagger-jsdoc'] = '^6.2.8';
-      packageJsonContent.devDependencies['@types/swagger-ui-express'] = '^4.1.4';
+      packageJsonContent.devDependencies['@types/swagger-ui-express'] = '^4.1.6';
     }
     await fs.writeJson(path.join(projectDir, 'package.json'), packageJsonContent, { spaces: 2 });
     
@@ -93,9 +93,37 @@ async function generateNodeProject(options) {
         }
     }
     
-    // --- Step 6: Generate Auth, Seeder, and Extra Features ---
-    if (addAuth) { /* ... Logic from v4.0 ... */ }
-    if (addSeeder) { /* ... Logic from v4.0 ... */ }
+    // --- Step 6: Generate Authentication Boilerplate ---
+    if (addAuth) {
+        console.log(chalk.blue('  -> Generating authentication boilerplate...'));
+        await fs.ensureDir(path.join(destSrcDir, 'routes'));
+        await fs.ensureDir(path.join(destSrcDir, 'middleware'));
+        await renderAndWrite(getTemplatePath('node-ts-express/partials/Auth.controller.ts.ejs'), path.join(destSrcDir, 'controllers', 'Auth.controller.ts'), {});
+        await renderAndWrite(getTemplatePath('node-ts-express/partials/Auth.routes.ts.ejs'), path.join(destSrcDir, 'routes', 'Auth.routes.ts'), {});
+        await renderAndWrite(getTemplatePath('node-ts-express/partials/Auth.middleware.ts.ejs'), path.join(destSrcDir, 'middleware', 'Auth.middleware.ts'), {});
+        
+        if (dbType === 'mongoose') {
+            const userModelPath = path.join(destSrcDir, 'models', 'User.model.ts');
+            if (await fs.pathExists(userModelPath)) {
+                let userModelContent = await fs.readFile(userModelPath, 'utf-8');
+                if (!userModelContent.includes('bcryptjs')) {
+                    userModelContent = userModelContent.replace(`import mongoose, { Schema, Document } from 'mongoose';`, `import mongoose, { Schema, Document } from 'mongoose';\nimport bcrypt from 'bcryptjs';`);
+                    const preSaveHook = `\n// Hash password before saving\nUserSchema.pre('save', async function(next) {\n  if (!this.isModified('password')) {\n    return next();\n  }\n  const salt = await bcrypt.genSalt(10);\n  this.password = await bcrypt.hash(this.password, salt);\n  next();\n});\n`;
+                    userModelContent = userModelContent.replace(`// Create and export the Model`, `${preSaveHook}\n// Create and export the Model`);
+                    await fs.writeFile(userModelPath, userModelContent);
+                }
+            }
+        }
+    }
+
+    // --- Step 7: Generate Seeder Script ---
+    if (addSeeder) {
+      console.log(chalk.blue('  -> Generating database seeder script...'));
+      await fs.ensureDir(path.join(projectDir, 'scripts'));
+      await renderAndWrite(getTemplatePath('node-ts-express/partials/Seeder.ts.ejs'), path.join(projectDir, 'scripts', 'seeder.ts'), { projectName });
+    }
+
+    // --- Step 8: Generate Extra Features ---
     if (extraFeatures.includes('docker')) {
       console.log(chalk.blue('  -> Generating Docker files...'));
       await renderAndWrite(getTemplatePath('node-ts-express/partials/Dockerfile.ejs'), path.join(projectDir, 'Dockerfile'), { dbType, port });
@@ -108,13 +136,13 @@ async function generateNodeProject(options) {
     }
     if (extraFeatures.includes('testing')) {
       console.log(chalk.blue('  -> Generating testing boilerplate...'));
-      const jestConfig = `module.exports = { preset: 'ts-jest', testEnvironment: 'node' };`;
+      const jestConfig = `/** @type {import('ts-jest').JestConfigWithTsJest} */\nmodule.exports = {\n  preset: 'ts-jest',\n  testEnvironment: 'node',\n  verbose: true,\n};`;
       await fs.writeFile(path.join(projectDir, 'jest.config.js'), jestConfig);
       await fs.ensureDir(path.join(projectDir, 'src', '__tests__'));
       await renderAndWrite(getTemplatePath('node-ts-express/partials/App.test.ts.ejs'), path.join(projectDir, 'src', '__tests__', 'api.test.ts'), { addAuth });
     }
 
-    // --- Step 7: Generate Main Route File & Inject Logic into Server ---
+    // --- Step 9: Generate Main Route File & Inject Logic into Server ---
     await renderAndWrite(getTemplatePath('node-ts-express/partials/routes.ts.ejs'), path.join(destSrcDir, 'routes.ts'), { endpoints, addAuth, dbType });
     
     let serverFileContent = await fs.readFile(path.join(destSrcDir, 'server.ts'), 'utf-8');
@@ -134,23 +162,31 @@ async function generateNodeProject(options) {
 
     serverFileContent = serverFileContent
       .replace("dotenv.config();", `dotenv.config();${dbConnectionCode}`)
-      .replace('// INJECT:ROUTES', `${authRoutesInjector}import apiRoutes from './routes';\napp.use('/api', apiRoutes);\n${swaggerInjector}`);
+      .replace('// INJECT:ROUTES', `${authRoutesInjector}import apiRoutes from './routes';\napp.use('/api', apiRoutes);`);
+      
+    const listenRegex = /(app\.listen\()/;
+    serverFileContent = serverFileContent.replace(listenRegex, `${swaggerInjector}\n$1`);
     await fs.writeFile(path.join(destSrcDir, 'server.ts'), serverFileContent);
 
-    // --- Step 8: Install Dependencies & Run Post-install Scripts ---
+    // --- Step 10: Install Dependencies & Run Post-install Scripts ---
     console.log(chalk.magenta('  -> Installing dependencies... This may take a moment.'));
     await execa('npm', ['install'], { cwd: projectDir });
     if (dbType === 'prisma') {
       console.log(chalk.blue('  -> Running `prisma generate`...'));
       await execa('npx', ['prisma', 'generate'], { cwd: projectDir });
     }
-
-    // --- Step 9: Generate Final Files (.env.example) ---
+    
+    // --- Step 11: Generate Final Files (.env.example) ---
     let envContent = `PORT=${port}\n`;
-    if (dbType === 'mongoose') envContent += `DATABASE_URL=mongodb://root:example@localhost:27017/${projectName}?authSource=admin\n`;
-    if (dbType === 'prisma') envContent += `DATABASE_URL="postgresql://user:password@localhost:5432/${projectName}?schema=public"\n`;
-    if (addAuth) envContent += `JWT_SECRET=your_super_secret_key\n`;
-    if (extraFeatures.includes('docker')) envContent += `\n# Docker-compose credentials\nDB_USER=user\nDB_PASSWORD=password\nDB_NAME=${projectName}`;
+    if (dbType === 'mongoose') {
+        envContent += `MONGO_URI=mongodb://root:example@db:27017/${projectName}?authSource=admin\n`;
+    } else if (dbType === 'prisma') {
+        envContent += `DATABASE_URL="postgresql://user:password@db:5432/${projectName}?schema=public"\n`;
+    }
+    if (addAuth) envContent += `JWT_SECRET=your_super_secret_jwt_key_12345\n`;
+    if (extraFeatures.includes('docker')) {
+        envContent += `\n# Docker-compose credentials (used in docker-compose.yml)\nDB_USER=user\nDB_PASSWORD=password\nDB_NAME=${projectName}`;
+    }
     await fs.writeFile(path.join(projectDir, '.env.example'), envContent);
     
   } catch (error) {

package/src/generators/python.js

@@ -0,0 +1,75 @@
+const chalk = require('chalk');
+const { execa } = require('execa');
+const fs = require('fs-extra');
+const path = require('path');
+const { analyzeFrontend } = require('../analyzer');
+const { renderAndWrite, getTemplatePath } = require('./template');
+
+async function generatePythonProject(options) {
+  const { projectDir, projectName, frontendSrcDir } = options;
+
+  try {
+    // --- Step 1: Analysis & Model Identification ---
+    console.log(chalk.blue('  -> Analyzing frontend for Python (FastAPI) backend...'));
+    const endpoints = await analyzeFrontend(frontendSrcDir);
+    const modelsToGenerate = new Map();
+    endpoints.forEach(ep => {
+      if (ep.schemaFields && ep.controllerName !== 'Default' && !modelsToGenerate.has(ep.controllerName)) {
+        modelsToGenerate.set(ep.controllerName, { name: ep.controllerName, fields: Object.entries(ep.schemaFields).map(([key, type]) => ({ name: key, type })) });
+      }
+    });
+
+    // --- Step 2: Scaffold Base Python Project ---
+    console.log(chalk.blue('  -> Scaffolding Python (FastAPI) project...'));
+    const appDir = path.join(projectDir, 'app');
+    const routesDir = path.join(appDir, 'routes');
+    await fs.ensureDir(appDir);
+    await fs.ensureDir(routesDir);
+
+    // --- Step 3: Generate Files from Templates ---
+    const controllers = Array.from(modelsToGenerate.keys());
+
+    // Generate main.py
+    await renderAndWrite(getTemplatePath('python-fastapi/main.py.ejs'), path.join(projectDir, 'app', 'main.py'), { projectName, controllers });
+
+    // Generate requirements.txt
+    await renderAndWrite(getTemplatePath('python-fastapi/requirements.txt.ejs'), path.join(projectDir, 'requirements.txt'), {});
+    
+    // Generate route file for each model
+    for (const [modelName, modelData] of modelsToGenerate.entries()) {
+        await renderAndWrite(
+            getTemplatePath('python-fastapi/routes.py.ejs'),
+            path.join(routesDir, `${modelName.toLowerCase()}_routes.py`),
+            { modelName, schema: modelData }
+        );
+    }
+    
+    // --- Step 4: Setup Virtual Environment and Install Dependencies ---
+    console.log(chalk.magenta('  -> Setting up virtual environment and installing dependencies...'));
+    // Create a virtual environment
+    await execa('python', ['-m', 'venv', 'venv'], { cwd: projectDir });
+    
+    // Determine the correct pip executable path based on OS
+    const pipPath = process.platform === 'win32' 
+        ? path.join('venv', 'Scripts', 'pip') 
+        : path.join('venv', 'bin', 'pip');
+
+    // Install dependencies using the virtual environment's pip
+    await execa(path.join(projectDir, pipPath), ['install', '-r', 'requirements.txt'], { cwd: projectDir });
+    
+    console.log(chalk.green('  -> Python backend generation is complete!'));
+    console.log(chalk.yellow('\nTo run your new Python backend:'));
+    console.log(chalk.cyan('  1. Activate the virtual environment: `source venv/bin/activate` (or `venv\\Scripts\\activate` on Windows)'));
+    console.log(chalk.cyan('  2. Start the server: `uvicorn app.main:app --reload`'));
+
+
+  } catch (error) {
+    // Improve error message for command not found
+    if (error.code === 'ENOENT') {
+        throw new Error(`'${error.command}' command not found. Please ensure Python and venv are installed and in your system's PATH.`);
+    }
+    throw error;
+  }
+}
+
+module.exports = { generatePythonProject };

package/src/templates/java-spring/partials/Controller.java.ejs

@@ -0,0 +1,61 @@
+// Auto-generated by create-backlist
+package <%= group %>.<%= projectName %>.controller;
+
+import <%= group %>.<%= projectName %>.model.<%= controllerName %>;
+import <%= group %>.<%= projectName %>.repository.<%= controllerName %>Repository;
+import org.springframework.beans.factory.annotation.Autowired;
+import org.springframework.http.HttpStatus;
+import org.springframework.http.ResponseEntity;
+import org.springframework.web.bind.annotation.*;
+
+import java.util.List;
+import java.util.Optional;
+
+@RestController
+@CrossOrigin(origins = "*") // Allow all origins for development
+@RequestMapping("/api/<%= controllerName.toLowerCase() %>s")
+public class <%= controllerName %>Controller {
+
+    @Autowired
+    private <%= controllerName %>Repository repository;
+
+    @GetMapping
+    public List<<%= controllerName %>> getAll<%= controllerName %>s() {
+        return repository.findAll();
+    }
+
+    @GetMapping("/{id}")
+    public ResponseEntity<<%= controllerName %>> get<%= controllerName %>ById(@PathVariable Long id) {
+        Optional<<%= controllerName %>> item = repository.findById(id);
+        return item.map(ResponseEntity::ok).orElseGet(() -> ResponseEntity.notFound().build());
+    }
+
+    @PostMapping
+    public ResponseEntity<<%= controllerName %>> create<%= controllerName %>(@RequestBody <%= controllerName %> newItem) {
+        <%= controllerName %> savedItem = repository.save(newItem);
+        return new ResponseEntity<>(savedItem, HttpStatus.CREATED);
+    }
+
+    @PutMapping("/{id}")
+    public ResponseEntity<<%= controllerName %>> update<%= controllerName %>(@PathVariable Long id, @RequestBody <%= controllerName %> updatedItem) {
+        return repository.findById(id)
+                .map(item -> {
+                    // Manually map fields to update. For simplicity, we assume all fields are updatable.
+                    <% model.fields.forEach(field => { %>
+                    item.set<%= field.name.charAt(0).toUpperCase() + field.name.slice(1) %>(updatedItem.get<%= field.name.charAt(0).toUpperCase() + field.name.slice(1) %>());
+                    <% }); %>
+                    <%= controllerName %> savedItem = repository.save(item);
+                    return ResponseEntity.ok(savedItem);
+                })
+                .orElseGet(() -> ResponseEntity.notFound().build());
+    }
+
+    @DeleteMapping("/{id}")
+    public ResponseEntity<Void> delete<%= controllerName %>(@PathVariable Long id) {
+        if (!repository.existsById(id)) {
+            return ResponseEntity.notFound().build();
+        }
+        repository.deleteById(id);
+        return ResponseEntity.noContent().build();
+    }
+}

package/src/templates/java-spring/partials/Entity.java.ejs

@@ -0,0 +1,24 @@
+// Auto-generated by create-backlist v6.0
+package <%= group %>.<%= projectName %>.model;
+
+import jakarta.persistence.Entity;
+import jakarta.persistence.Id;
+import jakarta.persistence.GeneratedValue;
+import jakarta.persistence.GenerationType;
+import lombok.Data;
+
+@Data
+@Entity
+public class <%= modelName %> {
+
+    @Id
+    @GeneratedValue(strategy = GenerationType.AUTO)
+    private Long id;
+
+    <% model.fields.forEach(field => { %>
+    <% let javaType = 'String'; %>
+    <% if (field.type === 'Number') javaType = 'Integer'; %>
+    <% if (field.type === 'Boolean') javaType = 'boolean'; %>
+    private <%= javaType %> <%= field.name %>;
+    <% }); %>
+}

package/src/templates/java-spring/partials/Repository.java.ejs

@@ -0,0 +1,12 @@
+// Auto-generated by create-backlist
+package <%= group %>.<%= projectName %>.repository;
+
+import <%= group %>.<%= projectName %>.model.<%= modelName %>;
+import org.springframework.data.jpa.repository.JpaRepository;
+import org.springframework.stereotype.Repository;
+
+@Repository
+public interface <%= modelName %>Repository extends JpaRepository<<%= modelName %>, Long> {
+    // Spring Data JPA automatically provides CRUD methods like findAll(), findById(), save(), deleteById()
+    // You can add custom query methods here if needed.
+}

package/src/templates/python-fastapi/main.py.ejs

@@ -0,0 +1,38 @@
+# Auto-generated by create-backlist v6.0
+from fastapi import FastAPI
+from fastapi.middleware.cors import CORSMiddleware
+import uvicorn
+import os
+
+# Import generated routers
+<% for (const controller of controllers) { %>
+from app.routes import <%= controller.toLowerCase() %>_routes
+<% } %>
+
+# Create FastAPI app instance
+app = FastAPI(title="<%= projectName %>")
+
+# CORS (Cross-Origin Resource Sharing) Middleware
+# This allows your frontend to communicate with this backend
+app.add_middleware(
+    CORSMiddleware,
+    allow_origins=["*"],  # In production, specify your frontend's origin
+    allow_credentials=True,
+    allow_methods=["*"],
+    allow_headers=["*"],
+)
+
+# Root endpoint
+@app.get("/")
+def read_root():
+    return {"message": "Welcome to the FastAPI backend generated by create-backlist!"}
+
+# Include generated routers
+<% for (const controller of controllers) { %>
+app.include_router(<%= controller.toLowerCase() %>_routes.router, prefix="/api")
+<% } %>
+
+
+if __name__ == "__main__":
+    port = int(os.getenv("PORT", 8000))
+    uvicorn.run(app, host="0.0.0.0", port=port)

package/src/templates/python-fastapi/requirements.txt.ejs

@@ -0,0 +1,4 @@
+fastapi
+uvicorn[standard]
+pydantic
+# Add other dependencies like 'sqlalchemy', 'psycopg2-binary' if using a database

package/src/templates/python-fastapi/routes.py.ejs

@@ -0,0 +1,42 @@
+# Auto-generated by create-backlist v6.0
+from fastapi import APIRouter, status
+from pydantic import BaseModel
+from typing import List
+
+# --- Pydantic Models for Request/Response Validation ---
+# These are automatically generated based on your frontend code.
+
+<% if (schema) { %>
+class <%= modelName %>Base(BaseModel):
+    <% for (const field of schema.fields) { %>
+    <%= field.name %>: <%= field.type === 'Number' ? 'int' : 'str' %>
+    <% } %>
+
+class <%= modelName %>(<%= modelName %>Base):
+    id: int # Or str, depending on your DB
+    # Add other fields like createdAt if needed
+    class Config:
+        orm_mode = True
+<% } %>
+
+# --- Router Definition ---
+router = APIRouter(
+    prefix="/<%= modelName.toLowerCase() %>s",
+    tags=["<%= modelName %>s"]
+)
+
+# --- API Endpoints ---
+
+@router.get("/", response_model=List[<%= modelName %>])
+async def get_all_items():
+    # TODO: Implement database logic to fetch all items
+    # Example: return await db.query(<%= modelName %>).all()
+    return [{"id": 1, "name": "Example Item", "email": "example@test.com"}]
+
+@router.post("/", status_code=status.HTTP_201_CREATED, response_model=<%= modelName %>)
+async def create_item(item: <%= modelName %>Base):
+    # TODO: Implement database logic to create a new item
+    # Example: new_item = await db.create(<%= modelName %>, **item.dict())
+    return {**item.dict(), "id": 2}
+
+# TODO: Add routes for GET (by id), PUT, and DELETE based on detected endpoints.