starter-structure-cli 0.2.1 → 0.2.2

package/templates/fullstack/react-vite-ts-tailwind-express-mongoose/server/database/migrations/index.tsx

@@ -0,0 +1,12 @@
+export const migrationsPlan = [
+  {
+    id: "001_create_users",
+    description: "Create the users table or collection."
+  },
+  {
+    id: "002_create_roles",
+    description: "Create the permissions and roles structure."
+  }
+];
+
+export default migrationsPlan;

package/templates/fullstack/react-vite-ts-tailwind-express-mongoose/server/database/models/index.tsx

@@ -0,0 +1,15 @@
+export interface ModuleModelRecord {
+  id: string;
+  name: string;
+  status: "draft" | "active";
+  createdAt: string;
+}
+
+export const modelsFields = [
+  "id",
+  "name",
+  "status",
+  "createdAt"
+];
+
+export default modelsFields;

package/templates/fullstack/react-vite-ts-tailwind-express-mongoose/server/database/seeders/index.tsx

@@ -0,0 +1,12 @@
+export const seedersSeeds = [
+  {
+    id: "starter-admin",
+    name: "Starter Admin"
+  },
+  {
+    id: "starter-operator",
+    name: "Starter Operator"
+  }
+];
+
+export default seedersSeeds;

package/templates/fullstack/react-vite-ts-tailwind-express-mongoose/server/index.js

@@ -0,0 +1,44 @@
+const express = require("express");
+const cors = require("cors");
+const dotenv = require("dotenv");
+const helmet = require("helmet");
+const morgan = require("morgan");
+
+const connectDB = require("./config/db");
+const routes = require("./routes");
+const notFound = require("./middleware/not-found");
+const errorHandler = require("./middleware/error-handler");
+
+dotenv.config();
+
+const app = express();
+const PORT = process.env.PORT || 5000;
+
+connectDB();
+
+app.use(
+  cors({
+    origin: process.env.CLIENT_URL || "*",
+    credentials: true
+  })
+);
+app.use(helmet());
+app.use(morgan("dev"));
+app.use(express.json());
+app.use(express.urlencoded({ extended: true }));
+
+app.get("/", (_req, res) => {
+  res.json({
+    success: true,
+    message: "__APP_NAME__ API is running"
+  });
+});
+
+app.use("/api", routes);
+
+app.use(notFound);
+app.use(errorHandler);
+
+app.listen(PORT, () => {
+  console.log(`Server running on port ${PORT}`);
+});

package/templates/fullstack/react-vite-ts-tailwind-express-mongoose/server/middleware/authenticate/index.js

@@ -0,0 +1,35 @@
+const jwt = require("jsonwebtoken");
+
+const User = require("../models/user");
+const { errorResponse } = require("../utils/api-response");
+
+async function authenticate(req, res, next) {
+  try {
+    const authHeader = req.headers.authorization;
+
+    if (!authHeader || !authHeader.startsWith("Bearer ")) {
+      return errorResponse(res, "Unauthorized access.", 401);
+    }
+
+    const token = authHeader.split(" ")[1];
+    const decoded = jwt.verify(token, process.env.JWT_SECRET);
+
+    const user = await User.findById(decoded.id).select("_id name email role");
+    if (!user) {
+      return errorResponse(res, "User not found.", 401);
+    }
+
+    req.user = {
+      id: user._id.toString(),
+      name: user.name,
+      email: user.email,
+      role: user.role
+    };
+
+    next();
+  } catch (_error) {
+    return errorResponse(res, "Invalid or expired token.", 401);
+  }
+}
+
+module.exports = authenticate;

package/templates/fullstack/react-vite-ts-tailwind-express-mongoose/server/middleware/error-handler/index.js

@@ -0,0 +1,16 @@
+const { errorResponse } = require("../utils/api-response");
+
+function errorHandler(error, _req, res, _next) {
+  const statusCode = error.statusCode || 500;
+  const message = error.message || "Internal server error.";
+
+  if (process.env.NODE_ENV !== "test") {
+    console.error(error);
+  }
+
+  return errorResponse(res, message, statusCode, {
+    stack: process.env.NODE_ENV === "development" ? error.stack : undefined
+  });
+}
+
+module.exports = errorHandler;

package/templates/fullstack/react-vite-ts-tailwind-express-mongoose/server/middleware/not-found/index.js

@@ -0,0 +1,7 @@
+const { errorResponse } = require("../utils/api-response");
+
+function notFound(req, res) {
+  return errorResponse(res, `Route not found: ${req.originalUrl}`, 404);
+}
+
+module.exports = notFound;

package/templates/fullstack/react-vite-ts-tailwind-express-mongoose/server/models/user/index.js

@@ -0,0 +1,54 @@
+const bcrypt = require("bcryptjs");
+const mongoose = require("mongoose");
+
+const userSchema = new mongoose.Schema(
+  {
+    name: {
+      type: String,
+      required: true,
+      trim: true
+    },
+    email: {
+      type: String,
+      required: true,
+      unique: true,
+      lowercase: true,
+      trim: true
+    },
+    password: {
+      type: String,
+      required: true,
+      minlength: 6
+    },
+    role: {
+      type: String,
+      enum: ["admin", "user"],
+      default: "user"
+    }
+  },
+  {
+    timestamps: true
+  }
+);
+
+userSchema.pre("save", async function preSave(next) {
+  if (!this.isModified("password")) {
+    return next();
+  }
+
+  const salt = await bcrypt.genSalt(10);
+  this.password = await bcrypt.hash(this.password, salt);
+  next();
+});
+
+userSchema.methods.comparePassword = function comparePassword(candidatePassword) {
+  return bcrypt.compare(candidatePassword, this.password);
+};
+
+userSchema.methods.toJSON = function toJSON() {
+  const userObject = this.toObject();
+  delete userObject.password;
+  return userObject;
+};
+
+module.exports = mongoose.model("User", userSchema);

package/templates/fullstack/react-vite-ts-tailwind-express-mongoose/server/package.json

@@ -0,0 +1,30 @@
+{
+  "name": "__APP_NAME__",
+  "version": "1.0.0",
+  "description": "Express + Mongoose + JWT starter API",
+  "main": "index.js",
+  "scripts": {
+    "dev": "nodemon index.js",
+    "start": "node index.js"
+  },
+  "keywords": [
+    "express",
+    "mongoose",
+    "jwt",
+    "api"
+  ],
+  "license": "MIT",
+  "dependencies": {
+    "bcryptjs": "^2.4.3",
+    "cors": "^2.8.5",
+    "dotenv": "^16.4.7",
+    "express": "^4.21.2",
+    "helmet": "^8.0.0",
+    "jsonwebtoken": "^9.0.2",
+    "mongoose": "^8.9.5",
+    "morgan": "^1.10.0"
+  },
+  "devDependencies": {
+    "nodemon": "^3.1.9"
+  }
+}

package/templates/fullstack/react-vite-ts-tailwind-express-mongoose/server/routes/auth/index.js

@@ -0,0 +1,12 @@
+const express = require("express");
+
+const { login, me, register } = require("../../controllers/auth");
+const authenticate = require("../../middleware/authenticate");
+
+const router = express.Router();
+
+router.post("/register", register);
+router.post("/login", login);
+router.get("/me", authenticate, me);
+
+module.exports = router;

package/templates/fullstack/react-vite-ts-tailwind-express-mongoose/server/routes/common/index.tsx

@@ -0,0 +1,23 @@
+export type ApiRouteDefinition = {
+  method: "GET" | "POST" | "PATCH" | "DELETE";
+  path: string;
+  handler: string;
+  protected?: boolean;
+};
+
+export const commonApiRoutes: ApiRouteDefinition[] = [
+  {
+    method: "GET",
+    path: "/common",
+    handler: "listCommon",
+    protected: true
+  },
+  {
+    method: "POST",
+    path: "/common",
+    handler: "createCommon",
+    protected: true
+  }
+];
+
+export default commonApiRoutes;

package/templates/fullstack/react-vite-ts-tailwind-express-mongoose/server/routes/index.js

@@ -0,0 +1,16 @@
+const express = require("express");
+
+const authRoutes = require("./auth");
+
+const router = express.Router();
+
+router.get("/health", (_req, res) => {
+  res.json({
+    success: true,
+    message: "Server is healthy"
+  });
+});
+
+router.use("/auth", authRoutes);
+
+module.exports = router;

package/templates/fullstack/react-vite-ts-tailwind-express-mongoose/server/routes/reports/index.tsx

@@ -0,0 +1,23 @@
+export type ApiRouteDefinition = {
+  method: "GET" | "POST" | "PATCH" | "DELETE";
+  path: string;
+  handler: string;
+  protected?: boolean;
+};
+
+export const reportsApiRoutes: ApiRouteDefinition[] = [
+  {
+    method: "GET",
+    path: "/reports",
+    handler: "listReports",
+    protected: true
+  },
+  {
+    method: "POST",
+    path: "/reports",
+    handler: "createReports",
+    protected: true
+  }
+];
+
+export default reportsApiRoutes;

package/templates/fullstack/react-vite-ts-tailwind-express-mongoose/server/scripts/index.tsx

@@ -0,0 +1,12 @@
+export const scriptsTasks = [
+  "migrate",
+  "seed",
+  "verify"
+];
+
+export function runScriptsTask(taskName: string) {
+  return {
+    taskName,
+    executedAt: new Date().toISOString()
+  };
+}

package/templates/fullstack/react-vite-ts-tailwind-express-mongoose/server/services/index.tsx

@@ -0,0 +1,16 @@
+export const servicesService = {
+  summarize(items: Array<Record<string, unknown>>) {
+    return {
+      count: items.length,
+      updatedAt: new Date().toISOString()
+    };
+  },
+  emptyState() {
+    return {
+      title: "Services service",
+      description: "Replace this starter service with your real business logic."
+    };
+  }
+};
+
+export default servicesService;

package/templates/fullstack/react-vite-ts-tailwind-express-mongoose/server/src/controllers/common/index.tsx

@@ -0,0 +1,35 @@
+export type StarterRequest = {
+  params?: Record<string, string>;
+  query?: Record<string, string>;
+  body?: Record<string, unknown>;
+  user?: {
+    id: string;
+    role: string;
+  };
+};
+
+export type StarterResponse = {
+  statusCode: number;
+  body: Record<string, unknown>;
+};
+
+export async function listCommon(request: StarterRequest): Promise<StarterResponse> {
+  return {
+    statusCode: 200,
+    body: {
+      feature: "common",
+      filters: request.query ?? {},
+      items: []
+    }
+  };
+}
+
+export async function createCommon(request: StarterRequest): Promise<StarterResponse> {
+  return {
+    statusCode: 201,
+    body: {
+      feature: "common",
+      payload: request.body ?? {}
+    }
+  };
+}

package/templates/fullstack/react-vite-ts-tailwind-express-mongoose/server/src/controllers/reports/index.tsx

@@ -0,0 +1,35 @@
+export type StarterRequest = {
+  params?: Record<string, string>;
+  query?: Record<string, string>;
+  body?: Record<string, unknown>;
+  user?: {
+    id: string;
+    role: string;
+  };
+};
+
+export type StarterResponse = {
+  statusCode: number;
+  body: Record<string, unknown>;
+};
+
+export async function listReports(request: StarterRequest): Promise<StarterResponse> {
+  return {
+    statusCode: 200,
+    body: {
+      feature: "reports",
+      filters: request.query ?? {},
+      items: []
+    }
+  };
+}
+
+export async function createReports(request: StarterRequest): Promise<StarterResponse> {
+  return {
+    statusCode: 201,
+    body: {
+      feature: "reports",
+      payload: request.body ?? {}
+    }
+  };
+}

package/templates/fullstack/react-vite-ts-tailwind-express-mongoose/server/src/database/config/index.tsx

@@ -0,0 +1,10 @@
+export const configConfig = {
+  client: process.env.DB_CLIENT || "mysql",
+  host: process.env.DB_HOST || "localhost",
+  port: Number(process.env.DB_PORT || 3306),
+  database: process.env.DB_NAME || "__APP_NAME__",
+  username: process.env.DB_USER || "root",
+  password: process.env.DB_PASSWORD || ""
+};
+
+export default configConfig;

package/templates/fullstack/react-vite-ts-tailwind-express-mongoose/server/src/database/migrations/index.tsx

@@ -0,0 +1,12 @@
+export const migrationsPlan = [
+  {
+    id: "001_create_users",
+    description: "Create the users table or collection."
+  },
+  {
+    id: "002_create_roles",
+    description: "Create the permissions and roles structure."
+  }
+];
+
+export default migrationsPlan;

package/templates/fullstack/react-vite-ts-tailwind-express-mongoose/server/src/database/models/index.tsx

@@ -0,0 +1,15 @@
+export interface ModuleModelRecord {
+  id: string;
+  name: string;
+  status: "draft" | "active";
+  createdAt: string;
+}
+
+export const modelsFields = [
+  "id",
+  "name",
+  "status",
+  "createdAt"
+];
+
+export default modelsFields;

package/templates/fullstack/react-vite-ts-tailwind-express-mongoose/server/src/database/seeders/index.tsx

@@ -0,0 +1,12 @@
+export const seedersSeeds = [
+  {
+    id: "starter-admin",
+    name: "Starter Admin"
+  },
+  {
+    id: "starter-operator",
+    name: "Starter Operator"
+  }
+];
+
+export default seedersSeeds;

package/templates/fullstack/react-vite-ts-tailwind-express-mongoose/server/src/routes/common/index.tsx

@@ -0,0 +1,23 @@
+export type ApiRouteDefinition = {
+  method: "GET" | "POST" | "PATCH" | "DELETE";
+  path: string;
+  handler: string;
+  protected?: boolean;
+};
+
+export const commonApiRoutes: ApiRouteDefinition[] = [
+  {
+    method: "GET",
+    path: "/common",
+    handler: "listCommon",
+    protected: true
+  },
+  {
+    method: "POST",
+    path: "/common",
+    handler: "createCommon",
+    protected: true
+  }
+];
+
+export default commonApiRoutes;

package/templates/fullstack/react-vite-ts-tailwind-express-mongoose/server/src/routes/reports/index.tsx

@@ -0,0 +1,23 @@
+export type ApiRouteDefinition = {
+  method: "GET" | "POST" | "PATCH" | "DELETE";
+  path: string;
+  handler: string;
+  protected?: boolean;
+};
+
+export const reportsApiRoutes: ApiRouteDefinition[] = [
+  {
+    method: "GET",
+    path: "/reports",
+    handler: "listReports",
+    protected: true
+  },
+  {
+    method: "POST",
+    path: "/reports",
+    handler: "createReports",
+    protected: true
+  }
+];
+
+export default reportsApiRoutes;

package/templates/fullstack/react-vite-ts-tailwind-express-mongoose/server/src/services/index.tsx

@@ -0,0 +1,16 @@
+export const servicesService = {
+  summarize(items: Array<Record<string, unknown>>) {
+    return {
+      count: items.length,
+      updatedAt: new Date().toISOString()
+    };
+  },
+  emptyState() {
+    return {
+      title: "Services service",
+      description: "Replace this starter service with your real business logic."
+    };
+  }
+};
+
+export default servicesService;

package/templates/fullstack/react-vite-ts-tailwind-express-mongoose/server/utils/api-response/index.js

@@ -0,0 +1,20 @@
+function successResponse(res, data = null, message = "Success", statusCode = 200) {
+  return res.status(statusCode).json({
+    success: true,
+    message,
+    data
+  });
+}
+
+function errorResponse(res, message = "Something went wrong", statusCode = 500, errors = null) {
+  return res.status(statusCode).json({
+    success: false,
+    message,
+    errors
+  });
+}
+
+module.exports = {
+  successResponse,
+  errorResponse
+};

package/templates/fullstack/react-vite-ts-tailwind-express-mongoose/server/utils/generate-token/index.js

@@ -0,0 +1,9 @@
+const jwt = require("jsonwebtoken");
+
+function generateToken(userId) {
+  return jwt.sign({ id: userId }, process.env.JWT_SECRET, {
+    expiresIn: process.env.JWT_EXPIRES_IN || "7d"
+  });
+}
+
+module.exports = generateToken;

package/templates/fullstack/react-vite-ts-tailwind-express-prisma-mysql/.env.example

@@ -0,0 +1,10 @@
+# client
+VITE_APP_NAME=__APP_NAME__
+VITE_API_URL=http://localhost:5000/api
+
+# server
+PORT=5000
+CLIENT_URL=http://localhost:5173
+JWT_SECRET=replace-me
+DATABASE_URL=mysql://root:password@localhost:3306/__APP_NAME__
+MONGODB_URI=mongodb://127.0.0.1:27017/__APP_NAME__

package/templates/fullstack/react-vite-ts-tailwind-express-prisma-mysql/README.md

@@ -0,0 +1,19 @@
+# __APP_NAME__
+
+Fullstack starter with separate `client/` and `server/` apps.
+
+## Structure
+
+- `client/`: frontend app
+- `server/`: API app
+
+## Getting started
+
+```bash
+npm run setup
+cp .env.example .env
+npm run dev:server
+npm run dev:client
+```
+
+Set the database values in `server/.env` or copy the root values into that app before running migrations or connecting the API.

package/templates/fullstack/react-vite-ts-tailwind-express-prisma-mysql/client/.env.example

@@ -0,0 +1 @@
+VITE_APP_NAME=__APP_NAME__

package/templates/fullstack/react-vite-ts-tailwind-express-prisma-mysql/client/README.md

@@ -0,0 +1,18 @@
+# __APP_NAME__
+
+React + Vite + Tailwind starter in TypeScript.
+
+## Included
+
+- React powered by Vite
+- Tailwind CSS v4 with the Vite plugin
+- A polished single-page starter layout
+- Ready-to-edit sections and shared styles
+
+## Getting started
+
+```bash
+npm install
+npm run dev
+```
+

package/templates/fullstack/react-vite-ts-tailwind-express-prisma-mysql/client/index.html

@@ -0,0 +1,16 @@
+<!doctype html>
+<html lang="en">
+  <head>
+    <meta charset="UTF-8" />
+    <meta name="viewport" content="width=device-width, initial-scale=1.0" />
+    <meta
+      name="description"
+      content="Starter project for __APP_NAME__ powered by React, Vite, and Tailwind."
+    />
+    <title>__APP_NAME__</title>
+  </head>
+  <body>
+    <div id="root"></div>
+    <script type="module" src="/src/main.tsx"></script>
+  </body>
+</html>

package/templates/fullstack/react-vite-ts-tailwind-express-prisma-mysql/client/package.json

@@ -0,0 +1,26 @@
+{
+  "name": "__APP_NAME__",
+  "private": true,
+  "version": "1.0.0",
+  "type": "module",
+  "scripts": {
+    "dev": "vite",
+    "build": "tsc -b && vite build",
+    "preview": "vite preview"
+  },
+  "dependencies": {
+    "react": "^19.0.0",
+    "react-dom": "^19.0.0"
+
+  },
+  "devDependencies": {
+    "@tailwindcss/vite": "^4.1.0",
+    "@types/react": "^19.0.10",
+    "@types/react-dom": "^19.0.4",
+    "@vitejs/plugin-react": "^4.3.4",
+    "tailwindcss": "^4.1.0",
+    "typescript": "^5.8.2",
+    "vite": "^6.2.0"
+
+  }
+}