starter-structure-cli 0.2.1 → 0.2.2

package/templates/monorepo-client-server/react-vite-ts-express-prisma/apps/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/monorepo-client-server/react-vite-ts-express-prisma/apps/server/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/react-vite-ts-express-prisma/apps/server/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/react-vite-ts-express-prisma/apps/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/monorepo-client-server/react-vite-ts-express-prisma/apps/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/monorepo-client-server/react-vite-ts-express-prisma/apps/server/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/react-vite-ts-express-prisma/apps/server/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/react-vite-ts-express-prisma/apps/server/routes/admin/index.tsx

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

package/templates/monorepo-client-server/react-vite-ts-express-prisma/apps/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/monorepo-client-server/react-vite-ts-express-prisma/apps/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/monorepo-client-server/react-vite-ts-express-prisma/apps/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/monorepo-client-server/react-vite-ts-express-prisma/apps/server/routes/student/index.tsx

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

package/templates/monorepo-client-server/react-vite-ts-express-prisma/apps/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/monorepo-client-server/react-vite-ts-express-prisma/apps/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/monorepo-client-server/react-vite-ts-express-prisma/apps/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/monorepo-client-server/react-vite-ts-express-prisma/apps/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/monorepo-client-server/react-vite-ts-express-prisma/apps/server/utils/user-select/index.js

@@ -0,0 +1,8 @@
+module.exports = {
+  id: true,
+  name: true,
+  email: true,
+  role: true,
+  createdAt: true,
+  updatedAt: true
+};

package/templates/monorepo-client-server/react-vite-ts-express-prisma/package.json

@@ -0,0 +1,12 @@
+{
+  "name": "__APP_NAME__",
+  "private": true,
+  "workspaces": [
+    "apps/*"
+  ],
+  "scripts": {
+    "dev:web": "npm run dev --workspace web",
+    "dev:api": "npm run dev --workspace api",
+    "build": "npm run build --workspaces --if-present"
+  }
+}

package/templates/monorepo-client-server/vue-vite-ts-express-mongoose/.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/vue-vite-ts-express-mongoose/README.md

@@ -0,0 +1,19 @@
+# __APP_NAME__
+
+Client and server monorepo starter using npm workspaces.
+
+## Workspace apps
+
+- `apps/client`: frontend app (`web` workspace)
+- `apps/server`: backend API (`api` workspace)
+
+## 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/vue-vite-ts-express-mongoose/apps/client/.env.example

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

package/templates/monorepo-client-server/vue-vite-ts-express-mongoose/apps/client/README.md

@@ -0,0 +1,18 @@
+# __APP_NAME__
+
+Vue + Vite + Tailwind starter in TypeScript.
+
+## Included
+
+- Vue 3 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/monorepo-client-server/vue-vite-ts-express-mongoose/apps/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 Vue, Vite, and Tailwind."
+    />
+    <title>__APP_NAME__</title>
+  </head>
+  <body>
+    <div id="app"></div>
+    <script type="module" src="/src/main.ts"></script>
+  </body>
+</html>

package/templates/monorepo-client-server/vue-vite-ts-express-mongoose/apps/client/package.json

@@ -0,0 +1,24 @@
+{
+  "name": "web",
+  "private": true,
+  "version": "1.0.0",
+  "type": "module",
+  "scripts": {
+    "dev": "vite",
+    "build": "vue-tsc -b && vite build",
+    "preview": "vite preview"
+  },
+  "dependencies": {
+    "vue": "^3.5.13"
+
+  },
+  "devDependencies": {
+    "@tailwindcss/vite": "^4.1.0",
+    "@vitejs/plugin-vue": "^5.2.1",
+    "tailwindcss": "^4.1.0",
+    "typescript": "^5.8.2",
+    "vite": "^6.2.0",
+    "vue-tsc": "^2.2.8"
+
+  }
+}

package/templates/monorepo-client-server/vue-vite-ts-express-mongoose/apps/client/public/index.tsx

@@ -0,0 +1,16 @@
+export const publicManifest = [
+  {
+    key: "public-hero",
+    label: "Public hero",
+    path: "/public/hero-placeholder"
+  },
+  {
+    key: "public-cover",
+    label: "Public cover",
+    path: "/public/cover-placeholder"
+  }
+];
+
+export const publicSource = "monorepo-client-server-enterprise-structure/shared/apps/client/public/index.tsx";
+
+export default publicManifest;

package/templates/monorepo-client-server/vue-vite-ts-express-mongoose/apps/client/src/App.vue

@@ -0,0 +1,101 @@
+<script setup>
+const appName = import.meta.env.VITE_APP_NAME || "__APP_NAME__";
+
+const launchTracks = [
+  "Landing page sections with clear content hierarchy",
+  "Tailwind v4 styling with a warm editorial visual language",
+  "Simple Vue structure that is easy to extend"
+];
+
+const checklist = [
+  { label: "Brand system", value: "Colors, voice, layout" },
+  { label: "Core pages", value: "Home, feature, CTA blocks" },
+  { label: "Launch speed", value: "Fast local edits with Vite" }
+];
+
+const cards = [
+  {
+    title: "Intentional look",
+    body: "Warm neutrals, sharp typography, and layered surfaces give the starter a point of view immediately."
+  },
+  {
+    title: "Fast edits",
+    body: "Sections are plain Vue markup, so changing copy and layout stays straightforward."
+  },
+  {
+    title: "Portable setup",
+    body: "You can turn this into a SaaS page, agency site, waitlist, or docs front page without redoing the base."
+  }
+];
+</script>
+
+<template>
+  <main class="px-6 py-8 md:px-10 lg:px-12">
+    <section class="mx-auto grid min-h-[calc(100vh-4rem)] max-w-6xl gap-10 rounded-[2rem] border border-[var(--line)] bg-[var(--panel)] p-8 shadow-[0_30px_120px_rgba(15,23,42,0.08)] backdrop-blur md:grid-cols-[1.2fr_0.8fr] md:p-12">
+      <div class="flex flex-col justify-between gap-8">
+        <div class="space-y-6">
+          <span class="inline-flex w-fit rounded-full border border-amber-300 bg-amber-50 px-4 py-2 text-sm font-medium text-amber-900">
+            Vue + Vite + Tailwind starter
+          </span>
+          <div class="space-y-4">
+            <h1 class="max-w-3xl text-5xl font-semibold tracking-tight text-slate-900 md:text-6xl">
+              {{ appName }} ships with a clean marketing shell, not a blank page.
+            </h1>
+            <p class="max-w-2xl text-lg leading-8 text-[var(--muted)]">
+              Start from a deliberate layout with strong spacing, textured color, and clear
+              sections instead of rebuilding the same landing page structure on every project.
+            </p>
+          </div>
+        </div>
+
+        <div class="grid gap-4 sm:grid-cols-3">
+          <article
+            v-for="item in launchTracks"
+            :key="item"
+            class="rounded-3xl border border-white/70 bg-white/75 p-5 text-sm leading-7 text-slate-700 shadow-sm"
+          >
+            {{ item }}
+          </article>
+        </div>
+      </div>
+
+      <aside class="flex flex-col justify-between rounded-[1.75rem] bg-slate-950 p-6 text-slate-50 shadow-[0_20px_80px_rgba(15,23,42,0.3)]">
+        <div class="space-y-4">
+          <p class="text-sm uppercase tracking-[0.24em] text-slate-400">Launch checklist</p>
+          <div class="space-y-3">
+            <div
+              v-for="item in checklist"
+              :key="item.label"
+              class="rounded-2xl border border-white/10 bg-white/5 p-4"
+            >
+              <p class="text-sm text-slate-400">{{ item.label }}</p>
+              <p class="mt-1 text-base font-medium text-white">{{ item.value }}</p>
+            </div>
+          </div>
+        </div>
+
+        <div class="mt-8 rounded-3xl bg-linear-to-br from-orange-400 via-amber-300 to-lime-200 p-[1px]">
+          <div class="rounded-[calc(1.5rem-1px)] bg-slate-950/95 p-5">
+            <p class="text-sm text-slate-400">Ready for the next template layer?</p>
+            <p class="mt-2 text-lg font-medium">
+              Add auth, CMS, or dashboard modules on top of this shell.
+            </p>
+          </div>
+        </div>
+      </aside>
+    </section>
+
+    <section class="mx-auto mt-10 max-w-6xl">
+      <div class="grid gap-4 md:grid-cols-3">
+        <article
+          v-for="card in cards"
+          :key="card.title"
+          class="rounded-[1.75rem] border border-[var(--line)] bg-white/70 p-6 shadow-sm"
+        >
+          <p class="text-lg font-semibold text-slate-900">{{ card.title }}</p>
+          <p class="mt-3 text-sm leading-7 text-slate-600">{{ card.body }}</p>
+        </article>
+      </div>
+    </section>
+  </main>
+</template>

package/templates/monorepo-client-server/vue-vite-ts-express-mongoose/apps/client/src/assets/index.tsx

@@ -0,0 +1,16 @@
+export const assetsManifest = [
+  {
+    key: "assets-hero",
+    label: "Assets hero",
+    path: "/assets/hero-placeholder"
+  },
+  {
+    key: "assets-cover",
+    label: "Assets cover",
+    path: "/assets/cover-placeholder"
+  }
+];
+
+export const assetsSource = "monorepo-client-server-enterprise-structure/shared/apps/client/src/assets/index.tsx";
+
+export default assetsManifest;

package/templates/monorepo-client-server/vue-vite-ts-express-mongoose/apps/client/src/components/common/index.tsx

@@ -0,0 +1,37 @@
+type CommonProps = {
+  title?: string;
+  description?: string;
+  items?: string[];
+};
+
+const defaultItems = [
+  "Wire up real API calls",
+  "Replace placeholder copy",
+  "Connect this module to your route tree"
+];
+
+export default function Common({
+  title = "Common",
+  description = "Starter implementation for the common module.",
+  items = defaultItems
+}: CommonProps) {
+  return (
+    <section className="rounded-3xl border border-slate-200 bg-white p-6 shadow-sm">
+      <div className="space-y-2">
+        <p className="text-xs font-semibold uppercase tracking-[0.24em] text-slate-500">
+          Common
+        </p>
+        <h2 className="text-2xl font-semibold text-slate-900">{title}</h2>
+        <p className="text-sm leading-6 text-slate-600">{description}</p>
+      </div>
+
+      <div className="mt-5 grid gap-3 sm:grid-cols-3">
+        {items.map((item) => (
+          <article key={item} className="rounded-2xl bg-slate-50 px-4 py-3 text-sm text-slate-700">
+            {item}
+          </article>
+        ))}
+      </div>
+    </section>
+  );
+}