starter-structure-cli 0.2.1 → 0.2.2

package/templates/fullstack/vue-vite-ts-tailwind-express-prisma-mysql/server/src/utils/api-response/index.ts

@@ -0,0 +1,27 @@
+import { Response } from "express";
+
+export function successResponse(
+  res: Response,
+  data: unknown = null,
+  message = "Success",
+  statusCode = 200
+) {
+  return res.status(statusCode).json({
+    success: true,
+    message,
+    data
+  });
+}
+
+export function errorResponse(
+  res: Response,
+  message = "Something went wrong",
+  statusCode = 500,
+  errors: unknown = null
+) {
+  return res.status(statusCode).json({
+    success: false,
+    message,
+    errors
+  });
+}

package/templates/fullstack/vue-vite-ts-tailwind-express-prisma-mysql/server/src/utils/generate-token/index.ts

@@ -0,0 +1,9 @@
+import jwt from "jsonwebtoken";
+
+export default function generateToken(userId: number) {
+  const expiresIn = (process.env.JWT_EXPIRES_IN || "7d") as jwt.SignOptions["expiresIn"];
+
+  return jwt.sign({ id: userId }, process.env.JWT_SECRET as string, {
+    expiresIn
+  });
+}

package/templates/fullstack/vue-vite-ts-tailwind-express-prisma-mysql/server/src/utils/user-select/index.ts

@@ -0,0 +1,10 @@
+const userSelect = {
+  id: true,
+  name: true,
+  email: true,
+  role: true,
+  createdAt: true,
+  updatedAt: true
+} as const;
+
+export default userSelect;

package/templates/fullstack/vue-vite-ts-tailwind-express-prisma-mysql/server/tsconfig.json

@@ -0,0 +1,21 @@
+{
+  "compilerOptions": {
+    "target": "ES2022",
+    "module": "CommonJS",
+    "moduleResolution": "Node",
+    "rootDir": "./src",
+    "outDir": "./dist",
+    "strict": true,
+    "esModuleInterop": true,
+    "skipLibCheck": true,
+    "forceConsistentCasingInFileNames": true,
+    "resolveJsonModule": true
+  },
+  "include": [
+    "src/**/*.ts"
+  ],
+  "exclude": [
+    "node_modules",
+    "dist"
+  ]
+}

package/templates/monorepo-client-server/nextjs-express-prisma/.env.example

@@ -0,0 +1,10 @@
+# web
+VITE_APP_NAME=__APP_NAME__
+VITE_API_URL=http://localhost:5000/api
+
+# api
+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/monorepo-client-server/nextjs-express-prisma/README.md

@@ -0,0 +1,19 @@
+# __APP_NAME__
+
+Client and server monorepo starter using npm workspaces.
+
+## Workspace apps
+
+- `apps/web`: frontend app
+- `apps/api`: backend API
+
+## Getting started
+
+```bash
+npm install
+cp .env.example .env
+npm run dev:api
+npm run dev:web
+```
+
+Prisma-based variants default to MySQL in the copied API app. Change the provider and `DATABASE_URL` if you want a different database.

package/templates/monorepo-client-server/nextjs-express-prisma/apps/api/.env.example

@@ -0,0 +1,6 @@
+PORT=5000
+NODE_ENV=development
+DATABASE_URL="mysql://root:password@localhost:3306/__APP_NAME__"
+JWT_SECRET=change-this-secret
+JWT_EXPIRES_IN=7d
+CLIENT_URL=http://localhost:5173

package/templates/monorepo-client-server/nextjs-express-prisma/apps/api/README.md

@@ -0,0 +1,47 @@
+# __APP_NAME__
+
+Express + Prisma + MySQL + JWT starter API.
+
+## Features
+
+- User registration and login
+- Password hashing with `bcryptjs`
+- JWT authentication middleware
+- Prisma ORM with MySQL
+- Structured route/controller/middleware/utils layout
+- Ready-to-edit Prisma schema
+
+## Project structure
+
+```text
+.
+├── config/
+├── controllers/
+├── middleware/
+├── prisma/
+├── routes/
+├── utils/
+├── .env.example
+├── .gitignore
+├── index.js
+└── package.json
+```
+
+## Getting started
+
+```bash
+npm install
+cp .env.example .env
+npx prisma generate
+npx prisma migrate dev --name init
+npm run dev
+```
+
+
+## API endpoints
+
+- `GET /api/health`
+- `POST /api/auth/register`
+- `POST /api/auth/login`
+- `GET /api/auth/me`
+

package/templates/monorepo-client-server/nextjs-express-prisma/apps/api/config/prisma/index.js

@@ -0,0 +1,5 @@
+const { PrismaClient } = require("@prisma/client");
+
+const prisma = new PrismaClient();
+
+module.exports = prisma;

package/templates/monorepo-client-server/nextjs-express-prisma/apps/api/controllers/auth/index.js

@@ -0,0 +1,115 @@
+const bcrypt = require("bcryptjs");
+
+const prisma = require("../../config/prisma");
+const { successResponse, errorResponse } = require("../../utils/api-response");
+const generateToken = require("../../utils/generate-token");
+const userSelect = require("../../utils/user-select");
+
+async function register(req, res, next) {
+  try {
+    const { name, email, password } = req.body;
+
+    if (!name || !email || !password) {
+      return errorResponse(res, "Name, email, and password are required.", 400);
+    }
+
+    const normalizedEmail = email.toLowerCase();
+    const existingUser = await prisma.user.findUnique({
+      where: { email: normalizedEmail }
+    });
+
+    if (existingUser) {
+      return errorResponse(res, "User already exists with this email.", 409);
+    }
+
+    const hashedPassword = await bcrypt.hash(password, 10);
+
+    const user = await prisma.user.create({
+      data: {
+        name,
+        email: normalizedEmail,
+        password: hashedPassword
+      },
+      select: userSelect
+    });
+
+    const token = generateToken(user.id);
+
+    return successResponse(
+      res,
+      {
+        user,
+        token
+      },
+      "Registration successful.",
+      201
+    );
+  } catch (error) {
+    next(error);
+  }
+}
+
+async function login(req, res, next) {
+  try {
+    const { email, password } = req.body;
+
+    if (!email || !password) {
+      return errorResponse(res, "Email and password are required.", 400);
+    }
+
+    const normalizedEmail = email.toLowerCase();
+    const user = await prisma.user.findUnique({
+      where: { email: normalizedEmail }
+    });
+
+    if (!user) {
+      return errorResponse(res, "Invalid email or password.", 401);
+    }
+
+    const isPasswordValid = await bcrypt.compare(password, user.password);
+    if (!isPasswordValid) {
+      return errorResponse(res, "Invalid email or password.", 401);
+    }
+
+    const token = generateToken(user.id);
+
+    const safeUser = await prisma.user.findUnique({
+      where: { id: user.id },
+      select: userSelect
+    });
+
+    return successResponse(
+      res,
+      {
+        user: safeUser,
+        token
+      },
+      "Login successful."
+    );
+  } catch (error) {
+    next(error);
+  }
+}
+
+async function me(req, res, next) {
+  try {
+    const user = await prisma.user.findUnique({
+      where: { id: req.user.id },
+      select: userSelect
+    });
+
+    if (!user) {
+      return errorResponse(res, "User not found.", 404);
+    }
+
+    return successResponse(res, { user }, "Authenticated user fetched.");
+  } catch (error) {
+    next(error);
+  }
+}
+
+module.exports = {
+  register,
+  login,
+  me
+};

package/templates/monorepo-client-server/nextjs-express-prisma/apps/api/controllers/booking/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 listBooking(request: StarterRequest): Promise<StarterResponse> {
+  return {
+    statusCode: 200,
+    body: {
+      feature: "booking",
+      filters: request.query ?? {},
+      items: []
+    }
+  };
+}
+
+export async function createBooking(request: StarterRequest): Promise<StarterResponse> {
+  return {
+    statusCode: 201,
+    body: {
+      feature: "booking",
+      payload: request.body ?? {}
+    }
+  };
+}

package/templates/monorepo-client-server/nextjs-express-prisma/apps/api/controllers/category/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 listCategory(request: StarterRequest): Promise<StarterResponse> {
+  return {
+    statusCode: 200,
+    body: {
+      feature: "category",
+      filters: request.query ?? {},
+      items: []
+    }
+  };
+}
+
+export async function createCategory(request: StarterRequest): Promise<StarterResponse> {
+  return {
+    statusCode: 201,
+    body: {
+      feature: "category",
+      payload: request.body ?? {}
+    }
+  };
+}

package/templates/monorepo-client-server/nextjs-express-prisma/apps/api/controllers/contact/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 listContact(request: StarterRequest): Promise<StarterResponse> {
+  return {
+    statusCode: 200,
+    body: {
+      feature: "contact",
+      filters: request.query ?? {},
+      items: []
+    }
+  };
+}
+
+export async function createContact(request: StarterRequest): Promise<StarterResponse> {
+  return {
+    statusCode: 201,
+    body: {
+      feature: "contact",
+      payload: request.body ?? {}
+    }
+  };
+}

package/templates/monorepo-client-server/nextjs-express-prisma/apps/api/controllers/story/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 listStory(request: StarterRequest): Promise<StarterResponse> {
+  return {
+    statusCode: 200,
+    body: {
+      feature: "story",
+      filters: request.query ?? {},
+      items: []
+    }
+  };
+}
+
+export async function createStory(request: StarterRequest): Promise<StarterResponse> {
+  return {
+    statusCode: 201,
+    body: {
+      feature: "story",
+      payload: request.body ?? {}
+    }
+  };
+}

package/templates/monorepo-client-server/nextjs-express-prisma/apps/api/index.js

@@ -0,0 +1,54 @@
+const express = require("express");
+const cors = require("cors");
+const dotenv = require("dotenv");
+const helmet = require("helmet");
+const morgan = require("morgan");
+
+const prisma = require("./config/prisma");
+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;
+
+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);
+
+async function startServer() {
+  try {
+    await prisma.$connect();
+    console.log("Prisma connected");
+
+    app.listen(PORT, () => {
+      console.log(`Server running on port ${PORT}`);
+    });
+  } catch (error) {
+    console.error("Failed to start server:", error.message);
+    process.exit(1);
+  }
+}
+
+startServer();

package/templates/monorepo-client-server/nextjs-express-prisma/apps/api/middleware/admin/index.tsx

@@ -0,0 +1,20 @@
+export type AccessContext = {
+  role?: string;
+  permissions?: string[];
+};
+
+export function requireAdmin(context: AccessContext) {
+  if (!context.role) {
+    return {
+      allowed: false,
+      reason: "Missing authenticated role."
+    };
+  }
+
+  return {
+    allowed: true,
+    reason: "Admin access granted."
+  };
+}
+
+export default requireAdmin;

package/templates/monorepo-client-server/nextjs-express-prisma/apps/api/middleware/authenticate/index.js

@@ -0,0 +1,34 @@
+const jwt = require("jsonwebtoken");
+
+const prisma = require("../config/prisma");
+const { errorResponse } = require("../utils/api-response");
+const userSelect = require("../utils/user-select");
+
+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 prisma.user.findUnique({
+      where: { id: decoded.id },
+      select: userSelect
+    });
+
+    if (!user) {
+      return errorResponse(res, "User not found.", 401);
+    }
+
+    req.user = user;
+    next();
+  } catch (_error) {
+    return errorResponse(res, "Invalid or expired token.", 401);
+  }
+}
+
+module.exports = authenticate;

package/templates/monorepo-client-server/nextjs-express-prisma/apps/api/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/monorepo-client-server/nextjs-express-prisma/apps/api/middleware/guide/index.tsx

@@ -0,0 +1,20 @@
+export type AccessContext = {
+  role?: string;
+  permissions?: string[];
+};
+
+export function requireGuide(context: AccessContext) {
+  if (!context.role) {
+    return {
+      allowed: false,
+      reason: "Missing authenticated role."
+    };
+  }
+
+  return {
+    allowed: true,
+    reason: "Guide access granted."
+  };
+}
+
+export default requireGuide;

package/templates/monorepo-client-server/nextjs-express-prisma/apps/api/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/monorepo-client-server/nextjs-express-prisma/apps/api/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/monorepo-client-server/nextjs-express-prisma/apps/api/package.json

@@ -0,0 +1,37 @@
+{
+  "name": "api",
+  "version": "1.0.0",
+  "description": "Express + Prisma + MySQL + JWT starter API",
+  "main": "index.js",
+  "scripts": {
+    "dev": "nodemon index.js",
+    "start": "node index.js",
+    "prisma:generate": "prisma generate",
+    "prisma:migrate": "prisma migrate dev",
+    "prisma:studio": "prisma studio"
+  },
+  "keywords": [
+    "express",
+    "prisma",
+    "mysql",
+    "jwt",
+    "api"
+  ],
+  "license": "MIT",
+  "dependencies": {
+    "@prisma/client": "^6.5.0",
+    "bcryptjs": "^2.4.3",
+    "cors": "^2.8.5",
+    "dotenv": "^16.4.7",
+    "express": "^4.21.2",
+    "helmet": "^8.0.0",
+    "jsonwebtoken": "^9.0.2",
+    "morgan": "^1.10.0"
+
+  },
+  "devDependencies": {
+    "nodemon": "^3.1.9",
+    "prisma": "^6.5.0"
+
+  }
+}

package/templates/monorepo-client-server/nextjs-express-prisma/apps/api/prisma/schema.prisma

@@ -0,0 +1,18 @@
+generator client {
+  provider = "prisma-client-js"
+}
+
+datasource db {
+  provider = "mysql"
+  url      = env("DATABASE_URL")
+}
+
+model User {
+  id        Int      @id @default(autoincrement())
+  name      String
+  email     String   @unique
+  password  String
+  role      String   @default("user")
+  createdAt DateTime @default(now())
+  updatedAt DateTime @updatedAt
+}

package/templates/monorepo-client-server/nextjs-express-prisma/apps/api/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;