create-fstack-app 1.0.1

package/src/generators/templates/backend.js

@@ -0,0 +1,265 @@
+export function createBackendFiles(config) {
+  if (config.backend === "None" || config.structure === "t3") return t3Files(config);
+  if (config.backend === "Express.js" || config.backend === "Fastify") return nodeApiFiles(config);
+  if (config.backend === "Firebase Functions") return firebaseFiles(config);
+  if (config.backend === "Django") return djangoFiles(config);
+  if (config.backend === "Laravel") return laravelFiles(config);
+  return genericBackendFiles(config);
+}
+
+function nodeApiFiles(config) {
+  const isFastify = config.backend === "Fastify";
+  return {
+    "backend/package.json": `${JSON.stringify({
+      name: "backend",
+      version: "0.1.0",
+      private: true,
+      type: "module",
+      scripts: {
+        dev: "nodemon src/server.js",
+        start: "node src/server.js"
+      },
+      dependencies: backendDependencies(config),
+      devDependencies: { nodemon: "^3.1.4" }
+    }, null, 2)}\n`,
+    "backend/.env": `PORT=5000
+${databaseEnv(config)}
+`,
+    "backend/src/server.js": isFastify ? fastifyServer() : expressServer(),
+    "backend/src/app.js": isFastify ? fastifyApp(config) : expressApp(config),
+    "backend/src/routes/health.routes.js": isFastify ? fastifyRoutes() : expressRoutes(),
+    "backend/src/controllers/health.controller.js": `export function healthCheck(req, res) {
+  res.json({ message: "API is healthy" });
+}
+`,
+    "backend/src/models/.gitkeep": "",
+    "backend/src/middleware/.gitkeep": "",
+    "backend/src/config/database.js": databaseConfig(config),
+    "backend/src/utils/.gitkeep": "",
+    "backend/src/services/.gitkeep": ""
+  };
+}
+
+function expressServer() {
+  return `import app from "./app.js";
+
+const port = process.env.PORT || 5000;
+
+app.listen(port, () => {
+  console.log(\`API running on http://localhost:\${port}\`);
+});
+`;
+}
+
+function expressApp(config) {
+  const swagger = config.features.includes("Swagger Docs")
+    ? "\napp.get('/api/docs', (_req, res) => res.json({ message: 'Add Swagger UI here.' }));"
+    : "";
+  return `import express from "express";
+import cors from "cors";
+import dotenv from "dotenv";
+import healthRoutes from "./routes/health.routes.js";
+
+dotenv.config();
+
+const app = express();
+
+app.use(cors());
+app.use(express.json());
+
+app.use("/api/health", healthRoutes);${swagger}
+
+export default app;
+`;
+}
+
+function expressRoutes() {
+  return `import { Router } from "express";
+import { healthCheck } from "../controllers/health.controller.js";
+
+const router = Router();
+
+router.get("/", healthCheck);
+
+export default router;
+`;
+}
+
+function fastifyServer() {
+  return `import { buildApp } from "./app.js";
+
+const app = buildApp();
+const port = Number(process.env.PORT || 5000);
+
+await app.listen({ port, host: "0.0.0.0" });
+console.log(\`API running on http://localhost:\${port}\`);
+`;
+}
+
+function fastifyApp() {
+  return `import Fastify from "fastify";
+import cors from "@fastify/cors";
+import { healthRoutes } from "./routes/health.routes.js";
+
+export function buildApp() {
+  const app = Fastify({ logger: true });
+  app.register(cors);
+  app.register(healthRoutes, { prefix: "/api/health" });
+  return app;
+}
+`;
+}
+
+function fastifyRoutes() {
+  return `export async function healthRoutes(app) {
+  app.get("/", async () => ({ message: "API is healthy" }));
+}
+`;
+}
+
+function firebaseFiles(config) {
+  return {
+    "backend/package.json": `${JSON.stringify({
+      name: "functions",
+      version: "0.1.0",
+      private: true,
+      type: "module",
+      scripts: { dev: "firebase emulators:start --only functions", deploy: "firebase deploy --only functions" },
+      dependencies: { "firebase-admin": "^12.2.0", "firebase-functions": "^5.0.1" },
+      devDependencies: { "firebase-tools": "^13.13.1" }
+    }, null, 2)}\n`,
+    "backend/src/index.js": `import { onRequest } from "firebase-functions/v2/https";
+
+export const health = onRequest((_request, response) => {
+  response.json({ message: "${config.stackLabel} functions are healthy" });
+});
+`,
+    "firebase.json": `${JSON.stringify({ functions: { source: "backend" }, emulators: { functions: { port: 5001 } } }, null, 2)}\n`
+  };
+}
+
+function djangoFiles(config) {
+  return {
+    "backend/README.md": `# Django Backend
+
+Create a virtual environment, install Django and djangorestframework, then run migrations.
+`,
+    "backend/manage.py": `#!/usr/bin/env python
+import os
+import sys
+
+def main():
+    os.environ.setdefault("DJANGO_SETTINGS_MODULE", "app.settings")
+    from django.core.management import execute_from_command_line
+    execute_from_command_line(sys.argv)
+
+if __name__ == "__main__":
+    main()
+`,
+    "backend/app/__init__.py": "",
+    "backend/app/settings.py": `SECRET_KEY = "change-me"
+DEBUG = True
+ROOT_URLCONF = "app.urls"
+INSTALLED_APPS = ["django.contrib.contenttypes", "django.contrib.auth", "rest_framework"]
+DATABASES = {"default": {"ENGINE": "django.db.backends.postgresql", "NAME": "my_fullstack_app"}}
+`,
+    "backend/app/urls.py": `from django.http import JsonResponse
+from django.urls import path
+
+def health(_request):
+    return JsonResponse({"message": "${config.stackLabel} API is healthy"})
+
+urlpatterns = [path("api/health/", health)]
+`,
+    "backend/requirements.txt": "django>=5.0\ndjangorestframework>=3.15\npsycopg[binary]>=3.2\n"
+  };
+}
+
+function laravelFiles(config) {
+  return {
+    "backend/README.md": `# Laravel Backend
+
+Run \`composer create-project laravel/laravel .\` inside this folder to expand the Laravel starter.
+`,
+    "backend/routes/api.php": `<?php
+
+use Illuminate\\Support\\Facades\\Route;
+
+Route::get('/health', fn () => ['message' => '${config.stackLabel} API is healthy']);
+`,
+    "backend/.env.example": "APP_NAME=MyFullstackApp\nAPP_ENV=local\nDB_CONNECTION=mysql\n"
+  };
+}
+
+function genericBackendFiles(config) {
+  return {
+    "backend/README.md": `# ${config.backend} Backend
+
+This folder is reserved for your selected backend framework.
+`
+  };
+}
+
+function t3Files(config) {
+  if (config.structure !== "t3") return {};
+  return {
+    "src/pages/index.tsx": `export default function Home() {
+  return <main><h1>${config.stackLabel}</h1><p>Your T3-style starter is ready.</p></main>;
+}
+`,
+    "server/api/root.ts": `export const appRouter = {};
+export type AppRouter = typeof appRouter;
+`,
+    "prisma/schema.prisma": `generator client {
+  provider = "prisma-client-js"
+}
+
+datasource db {
+  provider = "postgresql"
+  url      = env("DATABASE_URL")
+}
+`,
+    "app/.gitkeep": "",
+    "next.config.js": `const nextConfig = {};
+export default nextConfig;
+`,
+    "tsconfig.json": `${JSON.stringify({ compilerOptions: { strict: true, jsx: "preserve", moduleResolution: "bundler" } }, null, 2)}\n`
+  };
+}
+
+function backendDependencies(config) {
+  if (config.backend === "Fastify") {
+    return { "@fastify/cors": "^9.0.1", dotenv: "^16.4.5", fastify: "^4.28.1", ...databaseDeps(config) };
+  }
+  return { cors: "^2.8.5", dotenv: "^16.4.5", express: "^4.19.2", ...databaseDeps(config), ...authDeps(config) };
+}
+
+function databaseDeps(config) {
+  if (config.database === "MongoDB") return { mongoose: "^8.4.4" };
+  if (config.database === "PostgreSQL") return { pg: "^8.12.0" };
+  if (config.database === "MySQL") return { mysql2: "^3.10.2" };
+  if (config.database === "SQLite") return { sqlite3: "^5.1.7" };
+  if (config.features.includes("Prisma")) return { "@prisma/client": "^5.16.1" };
+  return {};
+}
+
+function authDeps(config) {
+  if (config.auth === "JWT") return { bcryptjs: "^2.4.3", jsonwebtoken: "^9.0.2" };
+  return {};
+}
+
+function databaseEnv(config) {
+  if (config.database === "MongoDB") return "MONGODB_URI=mongodb://localhost:27017/my_fullstack_app";
+  if (config.database === "PostgreSQL") return "DATABASE_URL=postgresql://postgres:postgres@localhost:5432/my_fullstack_app";
+  if (config.database === "MySQL") return "DATABASE_URL=mysql://root:password@localhost:3306/my_fullstack_app";
+  if (config.database === "SQLite") return "DATABASE_URL=file:./dev.db";
+  return "";
+}
+
+function databaseConfig(config) {
+  return `export const database = {
+  provider: "${config.database}",
+  url: process.env.DATABASE_URL || process.env.MONGODB_URI || ""
+};
+`;
+}

package/src/generators/templates/database.js

@@ -0,0 +1,45 @@
+export function createDatabaseFiles(config) {
+  if (config.database === "None" || config.structure === "t3") return {};
+
+  const files = {
+    "database/README.md": `# Database
+
+Provider: ${config.database}
+
+Add schema, migrations, seed data, and local setup notes here.
+`
+  };
+
+  if (config.database === "MongoDB") {
+    files["database/mongodb.md"] = "Default local URI: mongodb://localhost:27017/my_fullstack_app\n";
+  }
+
+  if (config.database === "PostgreSQL") {
+    files["database/schema.sql"] = "CREATE TABLE IF NOT EXISTS health_checks (id SERIAL PRIMARY KEY, created_at TIMESTAMP DEFAULT NOW());\n";
+  }
+
+  if (config.database === "MySQL") {
+    files["database/schema.sql"] = "CREATE TABLE IF NOT EXISTS health_checks (id INT AUTO_INCREMENT PRIMARY KEY, created_at TIMESTAMP DEFAULT CURRENT_TIMESTAMP);\n";
+  }
+
+  if (config.features.includes("Prisma")) {
+    files["database/prisma/schema.prisma"] = `generator client {
+  provider = "prisma-client-js"
+}
+
+datasource db {
+  provider = "${prismaProvider(config.database)}"
+  url      = env("DATABASE_URL")
+}
+`;
+  }
+
+  return files;
+}
+
+function prismaProvider(database) {
+  if (database === "PostgreSQL") return "postgresql";
+  if (database === "MySQL") return "mysql";
+  if (database === "SQLite") return "sqlite";
+  return "mongodb";
+}

package/src/generators/templates/frontend.js

@@ -0,0 +1,271 @@
+export function createFrontendFiles(config) {
+  if (config.frontend === "None" || config.structure === "t3") return {};
+  if (config.frontend === "React") return reactFiles(config);
+  if (config.frontend === "Next.js") return nextFiles(config);
+  if (config.frontend === "Angular") return angularFiles(config);
+  return genericFrontendFiles(config);
+}
+
+function reactFiles(config) {
+  const ext = config.language === "TypeScript" ? "tsx" : "jsx";
+  const mainExt = config.language === "TypeScript" ? "tsx" : "jsx";
+  const useTailwind = config.styling === "Tailwind CSS";
+
+  return {
+    "frontend/package.json": `${JSON.stringify({
+      name: "frontend",
+      version: "0.1.0",
+      private: true,
+      type: "module",
+      scripts: {
+        dev: "vite --host 0.0.0.0",
+        build: "vite build",
+        preview: "vite preview"
+      },
+      dependencies: frontendDependencies(config),
+      devDependencies: frontendDevDependencies(config)
+    }, null, 2)}\n`,
+    "frontend/index.html": `<div id="root"></div><script type="module" src="/src/main.${mainExt}"></script>\n`,
+    [`frontend/src/main.${mainExt}`]: `import React from "react";
+import ReactDOM from "react-dom/client";
+import { BrowserRouter } from "react-router-dom";
+import App from "./App.${ext}";
+import "./styles.css";
+
+ReactDOM.createRoot(document.getElementById("root")).render(
+  <React.StrictMode>
+    <BrowserRouter>
+      <App />
+    </BrowserRouter>
+  </React.StrictMode>
+);
+`,
+    [`frontend/src/App.${ext}`]: `import { Route, Routes } from "react-router-dom";
+import { Home } from "./pages/Home";
+
+export default function App() {
+  return (
+    <Routes>
+      <Route path="/" element={<Home />} />
+    </Routes>
+  );
+}
+`,
+    [`frontend/src/pages/Home.${ext}`]: `import { api } from "../services/api";
+
+export function Home() {
+  async function checkApi() {
+    const { data } = await api.get("/health");
+    alert(data.message);
+  }
+
+  return (
+    <main className="min-h-screen bg-slate-950 px-6 py-16 text-white">
+      <section className="mx-auto max-w-4xl">
+        <p className="text-sm uppercase tracking-widest text-cyan-300">${config.stackLabel}</p>
+        <h1 className="mt-4 text-4xl font-bold">Full-stack app ready.</h1>
+        <p className="mt-4 max-w-2xl text-slate-300">
+          Frontend, backend, routing, services, and project folders are already wired for your next build.
+        </p>
+        <button
+          className="mt-8 rounded-md bg-cyan-400 px-4 py-2 font-semibold text-slate-950"
+          onClick={checkApi}
+        >
+          Check API
+        </button>
+      </section>
+    </main>
+  );
+}
+`,
+    "frontend/src/services/api.js": `import axios from "axios";
+
+export const api = axios.create({
+  baseURL: import.meta.env.VITE_API_URL || "http://localhost:5000/api"
+});
+`,
+    "frontend/src/styles.css": useTailwind ? `@tailwind base;
+@tailwind components;
+@tailwind utilities;
+` : `body {
+  margin: 0;
+  font-family: Inter, ui-sans-serif, system-ui, -apple-system, BlinkMacSystemFont, "Segoe UI", sans-serif;
+}
+`,
+    "frontend/src/components/.gitkeep": "",
+    "frontend/src/hooks/.gitkeep": "",
+    "frontend/src/layouts/.gitkeep": "",
+    "frontend/src/utils/.gitkeep": "",
+    "frontend/src/assets/.gitkeep": "",
+    "frontend/src/context/.gitkeep": "",
+    "frontend/src/routes/.gitkeep": "",
+    "frontend/public/.gitkeep": "",
+    "frontend/vite.config.js": viteConfig(config),
+    ...(useTailwind ? tailwindFiles() : {}),
+    ...(config.language === "TypeScript" ? tsConfigFiles() : {})
+  };
+}
+
+function nextFiles(config) {
+  return {
+    "frontend/package.json": `${JSON.stringify({
+      name: "frontend",
+      version: "0.1.0",
+      private: true,
+      scripts: { dev: "next dev", build: "next build", start: "next start", lint: "next lint" },
+      dependencies: { next: "^14.2.5", react: "^18.3.1", "react-dom": "^18.3.1" },
+      devDependencies: config.styling === "Tailwind CSS" ? tailwindDevDeps() : {}
+    }, null, 2)}\n`,
+    "frontend/app/page.tsx": `export default function Home() {
+  return <main><h1>${config.stackLabel}</h1><p>Your Next.js app is ready.</p></main>;
+}
+`,
+    "frontend/app/layout.tsx": `import "./globals.css";
+
+export default function RootLayout({ children }) {
+  return <html lang="en"><body>{children}</body></html>;
+}
+`,
+    "frontend/app/globals.css": config.styling === "Tailwind CSS" ? "@tailwind base;\n@tailwind components;\n@tailwind utilities;\n" : "body { margin: 0; font-family: sans-serif; }\n",
+    ...(config.styling === "Tailwind CSS" ? tailwindFiles("frontend/") : {})
+  };
+}
+
+function angularFiles(config) {
+  return {
+    "frontend/package.json": `${JSON.stringify({
+      name: "frontend",
+      version: "0.1.0",
+      private: true,
+      scripts: { dev: "ng serve --host 0.0.0.0", build: "ng build" },
+      dependencies: { "@angular/core": "^18.0.0", "@angular/common": "^18.0.0", "@angular/router": "^18.0.0", rxjs: "^7.8.1", "zone.js": "^0.14.7" },
+      devDependencies: { "@angular/cli": "^18.0.0", typescript: "^5.4.5" }
+    }, null, 2)}\n`,
+    "frontend/src/app/app.component.ts": `export class AppComponent {
+  title = "${config.stackLabel}";
+}
+`,
+    "frontend/src/main.ts": `console.log("Angular starter generated. Run ng generate application to expand this shell.");\n`
+  };
+}
+
+function genericFrontendFiles(config) {
+  return {
+    "frontend/package.json": `${JSON.stringify({
+      name: "frontend",
+      version: "0.1.0",
+      private: true,
+      scripts: { dev: "vite --host 0.0.0.0", build: "vite build", preview: "vite preview" },
+      dependencies: {},
+      devDependencies: { vite: "^5.3.5" }
+    }, null, 2)}\n`,
+    "frontend/src/main.js": `console.log("${config.frontend} starter selected.");\n`
+  };
+}
+
+function frontendDependencies(config) {
+  const deps = {
+    "@vitejs/plugin-react": "^4.3.1",
+    axios: "^1.7.2",
+    react: "^18.3.1",
+    "react-dom": "^18.3.1",
+    "react-router-dom": "^6.24.1"
+  };
+  if (config.auth === "Firebase Auth" || config.database === "Firebase") {
+    deps.firebase = "^10.12.3";
+    deps["react-firebase-hooks"] = "^5.1.1";
+  }
+  if (config.features.includes("Zustand")) deps.zustand = "^4.5.4";
+  if (config.features.includes("Redux Toolkit")) {
+    deps["@reduxjs/toolkit"] = "^2.2.6";
+    deps["react-redux"] = "^9.1.2";
+  }
+  if (config.styling === "Chakra UI") {
+    deps["@chakra-ui/react"] = "^2.8.2";
+    deps["@emotion/react"] = "^11.11.4";
+    deps["@emotion/styled"] = "^11.11.5";
+    deps["framer-motion"] = "^11.2.12";
+  }
+  if (config.styling === "Material UI") {
+    deps["@mui/material"] = "^5.16.4";
+    deps["@emotion/react"] = "^11.11.4";
+    deps["@emotion/styled"] = "^11.11.5";
+  }
+  if (config.styling === "Styled Components") deps["styled-components"] = "^6.1.11";
+  return deps;
+}
+
+function frontendDevDependencies(config) {
+  const deps = { vite: "^5.3.5" };
+  if (config.language === "TypeScript") {
+    deps.typescript = "^5.5.3";
+    deps["@types/react"] = "^18.3.3";
+    deps["@types/react-dom"] = "^18.3.0";
+  }
+  if (config.styling === "Tailwind CSS") Object.assign(deps, tailwindDevDeps());
+  if (config.styling === "SCSS") deps.sass = "^1.77.8";
+  return deps;
+}
+
+function viteConfig(config) {
+  return `import { defineConfig } from "vite";
+import react from "@vitejs/plugin-react";
+
+export default defineConfig({
+  plugins: [react()],
+  server: {
+    port: 5173
+  }
+});
+`;
+}
+
+function tailwindDevDeps() {
+  return { tailwindcss: "^3.4.4", postcss: "^8.4.39", autoprefixer: "^10.4.19" };
+}
+
+function tailwindFiles(prefix = "frontend/") {
+  return {
+    [`${prefix}tailwind.config.js`]: `export default {
+  content: ["./index.html", "./src/**/*.{js,jsx,ts,tsx}", "./app/**/*.{js,jsx,ts,tsx}"],
+  theme: {
+    extend: {}
+  },
+  plugins: []
+};
+`,
+    [`${prefix}postcss.config.js`]: `export default {
+  plugins: {
+    tailwindcss: {},
+    autoprefixer: {}
+  }
+};
+`
+  };
+}
+
+function tsConfigFiles() {
+  return {
+    "frontend/tsconfig.json": `${JSON.stringify({
+      compilerOptions: {
+        target: "ES2020",
+        useDefineForClassFields: true,
+        lib: ["DOM", "DOM.Iterable", "ES2020"],
+        allowJs: false,
+        skipLibCheck: true,
+        esModuleInterop: true,
+        allowSyntheticDefaultImports: true,
+        strict: true,
+        forceConsistentCasingInFileNames: true,
+        module: "ESNext",
+        moduleResolution: "Node",
+        resolveJsonModule: true,
+        isolatedModules: true,
+        noEmit: true,
+        jsx: "react-jsx"
+      },
+      include: ["src"],
+      references: []
+    }, null, 2)}\n`
+  };
+}