starter-structure-cli 0.2.1 → 0.2.2

package/templates/fullstack/react-vite-ts-tailwind-express-sequelize-mysql/client/src/styles/index.tsx

@@ -0,0 +1,11 @@
+export const stylesTokens = {
+  background: "#f8fafc",
+  panel: "#ffffff",
+  accent: "#0f172a",
+  muted: "#64748b",
+  border: "#e2e8f0"
+};
+
+export function getStylesShadow() {
+  return "0 24px 64px rgba(15, 23, 42, 0.08)";
+}

package/templates/fullstack/react-vite-ts-tailwind-express-sequelize-mysql/client/src/types/index.tsx

@@ -0,0 +1,13 @@
+export type TypesStatus = "draft" | "active" | "archived";
+
+export interface TypesRecord {
+  id: string;
+  title: string;
+  description: string;
+  status: TypesStatus;
+}
+
+export interface TypesFilter {
+  search?: string;
+  status?: TypesStatus;
+}

package/templates/fullstack/react-vite-ts-tailwind-express-sequelize-mysql/client/src/utils/index.tsx

@@ -0,0 +1,13 @@
+export function toUtilsSlug(value: string) {
+  return value
+    .trim()
+    .toLowerCase()
+    .replace(/[^a-z0-9]+/g, "-")
+    .replace(/^-|-$/g, "");
+}
+
+export function formatUtilsLabel(value: string) {
+  return value
+    .replace(/[-_]+/g, " ")
+    .replace(/\b\w/g, (character) => character.toUpperCase());
+}

package/templates/fullstack/react-vite-ts-tailwind-express-sequelize-mysql/client/src/view/admin/index.tsx

@@ -0,0 +1,29 @@
+const tasks = [
+  "Connect the page to real data",
+  "Replace starter metrics",
+  "Hook up page-specific actions"
+];
+
+export default function AdminPage() {
+  return (
+    <main className="space-y-6">
+      <section className="rounded-3xl border border-slate-200 bg-white p-6 shadow-sm">
+        <p className="text-xs font-semibold uppercase tracking-[0.24em] text-slate-500">
+          Admin
+        </p>
+        <h1 className="mt-2 text-3xl font-semibold text-slate-900">Admin Page</h1>
+        <p className="mt-3 max-w-2xl text-sm leading-6 text-slate-600">
+          Use this starter page as the first real implementation for the admin section.
+        </p>
+      </section>
+
+      <section className="grid gap-4 md:grid-cols-3">
+        {tasks.map((task) => (
+          <article key={task} className="rounded-2xl bg-slate-50 px-4 py-5 text-sm text-slate-700">
+            {task}
+          </article>
+        ))}
+      </section>
+    </main>
+  );
+}

package/templates/fullstack/react-vite-ts-tailwind-express-sequelize-mysql/client/src/view/auth/index.tsx

@@ -0,0 +1,29 @@
+const tasks = [
+  "Connect the page to real data",
+  "Replace starter metrics",
+  "Hook up page-specific actions"
+];
+
+export default function AuthPage() {
+  return (
+    <main className="space-y-6">
+      <section className="rounded-3xl border border-slate-200 bg-white p-6 shadow-sm">
+        <p className="text-xs font-semibold uppercase tracking-[0.24em] text-slate-500">
+          Auth
+        </p>
+        <h1 className="mt-2 text-3xl font-semibold text-slate-900">Auth Page</h1>
+        <p className="mt-3 max-w-2xl text-sm leading-6 text-slate-600">
+          Use this starter page as the first real implementation for the auth section.
+        </p>
+      </section>
+
+      <section className="grid gap-4 md:grid-cols-3">
+        {tasks.map((task) => (
+          <article key={task} className="rounded-2xl bg-slate-50 px-4 py-5 text-sm text-slate-700">
+            {task}
+          </article>
+        ))}
+      </section>
+    </main>
+  );
+}

package/templates/fullstack/react-vite-ts-tailwind-express-sequelize-mysql/client/src/view/home/index.tsx

@@ -0,0 +1,29 @@
+const tasks = [
+  "Connect the page to real data",
+  "Replace starter metrics",
+  "Hook up page-specific actions"
+];
+
+export default function HomePage() {
+  return (
+    <main className="space-y-6">
+      <section className="rounded-3xl border border-slate-200 bg-white p-6 shadow-sm">
+        <p className="text-xs font-semibold uppercase tracking-[0.24em] text-slate-500">
+          Home
+        </p>
+        <h1 className="mt-2 text-3xl font-semibold text-slate-900">Home Page</h1>
+        <p className="mt-3 max-w-2xl text-sm leading-6 text-slate-600">
+          Use this starter page as the first real implementation for the home section.
+        </p>
+      </section>
+
+      <section className="grid gap-4 md:grid-cols-3">
+        {tasks.map((task) => (
+          <article key={task} className="rounded-2xl bg-slate-50 px-4 py-5 text-sm text-slate-700">
+            {task}
+          </article>
+        ))}
+      </section>
+    </main>
+  );
+}

package/templates/fullstack/react-vite-ts-tailwind-express-sequelize-mysql/client/src/view/pricing/index.tsx

@@ -0,0 +1,29 @@
+const tasks = [
+  "Connect the page to real data",
+  "Replace starter metrics",
+  "Hook up page-specific actions"
+];
+
+export default function PricingPage() {
+  return (
+    <main className="space-y-6">
+      <section className="rounded-3xl border border-slate-200 bg-white p-6 shadow-sm">
+        <p className="text-xs font-semibold uppercase tracking-[0.24em] text-slate-500">
+          Pricing
+        </p>
+        <h1 className="mt-2 text-3xl font-semibold text-slate-900">Pricing Page</h1>
+        <p className="mt-3 max-w-2xl text-sm leading-6 text-slate-600">
+          Use this starter page as the first real implementation for the pricing section.
+        </p>
+      </section>
+
+      <section className="grid gap-4 md:grid-cols-3">
+        {tasks.map((task) => (
+          <article key={task} className="rounded-2xl bg-slate-50 px-4 py-5 text-sm text-slate-700">
+            {task}
+          </article>
+        ))}
+      </section>
+    </main>
+  );
+}

package/templates/fullstack/react-vite-ts-tailwind-express-sequelize-mysql/client/src/vite-env.d.ts

@@ -0,0 +1 @@
+/// <reference types="vite/client" />

package/templates/fullstack/react-vite-ts-tailwind-express-sequelize-mysql/client/tsconfig.app.json

@@ -0,0 +1,20 @@
+{
+  "compilerOptions": {
+    "target": "ES2020",
+    "useDefineForClassFields": true,
+    "lib": ["ES2020", "DOM", "DOM.Iterable"],
+    "module": "ESNext",
+    "skipLibCheck": true,
+    "moduleResolution": "Bundler",
+    "allowImportingTsExtensions": false,
+    "resolveJsonModule": true,
+    "isolatedModules": true,
+    "moduleDetection": "force",
+    "noEmit": true,
+    "jsx": "react-jsx",
+    "strict": true,
+    "noUnusedLocals": true,
+    "noUnusedParameters": true
+  },
+  "include": ["src"]
+}

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

@@ -0,0 +1,7 @@
+{
+  "files": [],
+  "references": [
+    { "path": "./tsconfig.app.json" },
+    { "path": "./tsconfig.node.json" }
+  ]
+}

package/templates/fullstack/react-vite-ts-tailwind-express-sequelize-mysql/client/tsconfig.node.json

@@ -0,0 +1,10 @@
+{
+  "compilerOptions": {
+    "composite": true,
+    "skipLibCheck": true,
+    "module": "ESNext",
+    "moduleResolution": "Bundler",
+    "allowSyntheticDefaultImports": true
+  },
+  "include": ["vite.config.ts"]
+}

package/templates/fullstack/react-vite-ts-tailwind-express-sequelize-mysql/client/vite.config.ts

@@ -0,0 +1,7 @@
+import { defineConfig } from "vite";
+import react from "@vitejs/plugin-react";
+import tailwindcss from "@tailwindcss/vite";
+
+export default defineConfig({
+  plugins: [react(), tailwindcss()]
+});

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

@@ -0,0 +1,10 @@
+{
+  "name": "__APP_NAME__",
+  "private": true,
+  "scripts": {
+    "setup": "npm install --prefix client && npm install --prefix server",
+    "dev:client": "npm --prefix client run dev",
+    "dev:server": "npm --prefix server run dev",
+    "build:client": "npm --prefix client run build"
+  }
+}

package/templates/fullstack/react-vite-ts-tailwind-express-sequelize-mysql/server/.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/fullstack/react-vite-ts-tailwind-express-sequelize-mysql/server/README.md

@@ -0,0 +1,43 @@
+# __APP_NAME__
+
+Express + Mongoose + JWT starter API.
+
+## Features
+
+- User registration and login
+- Password hashing with `bcryptjs`
+- JWT authentication middleware
+- MongoDB connection with Mongoose
+- Structured route/controller/model layout
+- Standard API response helpers
+
+## Project structure
+
+```text
+.
+├── config/
+├── controllers/
+├── middleware/
+├── models/
+├── routes/
+├── utils/
+├── .env.example
+├── .gitignore
+├── index.js
+└── package.json
+```
+
+## Getting started
+
+```bash
+npm install
+cp .env.example .env
+npm run dev
+```
+
+## API endpoints
+
+- `GET /api/health`
+- `POST /api/auth/register`
+- `POST /api/auth/login`
+- `GET /api/auth/me`

package/templates/fullstack/react-vite-ts-tailwind-express-sequelize-mysql/server/config/db/index.js

@@ -0,0 +1,22 @@
+const { Sequelize } = require("sequelize");
+
+const sequelize = new Sequelize(process.env.DATABASE_URL, {
+  dialect: "mysql",
+  logging: false
+});
+
+async function connectDB() {
+  try {
+    await sequelize.authenticate();
+    await sequelize.sync();
+    console.log("MySQL connected");
+  } catch (error) {
+    console.error("MySQL connection failed:", error.message);
+    process.exit(1);
+  }
+}
+
+module.exports = {
+  sequelize,
+  connectDB
+};

package/templates/fullstack/react-vite-ts-tailwind-express-sequelize-mysql/server/controllers/auth/index.js

@@ -0,0 +1,95 @@
+const User = require("../../models/user");
+const { successResponse, errorResponse } = require("../../utils/api-response");
+const generateToken = require("../../utils/generate-token");
+
+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 existingUser = await User.findOne({
+      where: { email: email.toLowerCase() }
+    });
+    if (existingUser) {
+      return errorResponse(res, "User already exists with this email.", 409);
+    }
+
+    const user = await User.create({
+      name,
+      email: email.toLowerCase(),
+      password
+    });
+
+    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 user = await User.findOne({
+      where: { email: email.toLowerCase() }
+    });
+    if (!user) {
+      return errorResponse(res, "Invalid email or password.", 401);
+    }
+
+    const isPasswordValid = await user.comparePassword(password);
+    if (!isPasswordValid) {
+      return errorResponse(res, "Invalid email or password.", 401);
+    }
+
+    const token = generateToken(user.id);
+
+    return successResponse(
+      res,
+      {
+        user,
+        token
+      },
+      "Login successful."
+    );
+  } catch (error) {
+    next(error);
+  }
+}
+
+async function me(req, res, next) {
+  try {
+    const user = await User.findByPk(req.user.id);
+
+    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/fullstack/react-vite-ts-tailwind-express-sequelize-mysql/server/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-sequelize-mysql/server/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-sequelize-mysql/server/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-sequelize-mysql/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-sequelize-mysql/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-sequelize-mysql/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-sequelize-mysql/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-sequelize-mysql/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.findByPk(decoded.id);
+    if (!user) {
+      return errorResponse(res, "User not found.", 401);
+    }
+
+    req.user = {
+      id: String(user.id),
+      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-sequelize-mysql/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-sequelize-mysql/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;