@imksh/create 1.0.0

package/templates/mern-ts/client/src/store/useUiStore.ts

@@ -0,0 +1,54 @@
+import { create } from "zustand";
+
+export const useUiStore = create((set, get) => ({
+  open: false,
+  collapsed: false,
+  isMobileMenuOpened: false,
+  headerTitle: "Dashboard",
+  headerActions: null,
+  setHeaderTitle: (title) => set({ headerTitle: title }),
+  setHeaderActions: (actions) => set({ headerActions: actions }),
+  toggleCollapsed: () => set((state) => ({ collapsed: !state.collapsed })),
+
+  setMobileMenuOpened: (open) => {
+    set({ isMobileMenuOpened: open });
+  },
+  toggleMobileMenuOpened: () => {
+    set((state) => ({ isMobileMenuOpened: !state.isMobileMenuOpened }));
+  },
+
+  theme: localStorage.getItem("theme") || "light",
+
+  setTheme: (theme) => {
+    document.documentElement.setAttribute("data-theme", theme);
+
+    localStorage.setItem("theme", theme);
+
+    set({ theme });
+  },
+
+  toggleTheme: () => {
+    const nextTheme = get().theme === "light" ? "dark" : "light";
+
+    document.documentElement.setAttribute("data-theme", nextTheme);
+
+    localStorage.setItem("theme", nextTheme);
+
+    set({ theme: nextTheme });
+  },
+
+  toggleSidebar: () =>
+    set((state) => ({
+      open: !state.open,
+    })),
+
+  openSidebar: () =>
+    set({
+      open: true,
+    }),
+
+  close: () =>
+    set({
+      open: false,
+    }),
+}));

package/templates/mern-ts/client/src/utils/getInitials.ts

@@ -0,0 +1,10 @@
+export const getInitials = (name = "") => {
+  if (!name.trim()) return "";
+
+  return name
+    .trim()
+    .split(/\s+/)
+    .slice(0, 2)
+    .map((word) => word[0].toUpperCase())
+    .join("");
+};

package/templates/mern-ts/client/tsconfig.json

@@ -0,0 +1,25 @@
+{
+  "compilerOptions": {
+    "target": "ES2020",
+    "useDefineForClassFields": true,
+    "lib": ["ES2020", "DOM", "DOM.Iterable"],
+    "module": "ESNext",
+    "skipLibCheck": true,
+
+    /* Bundler mode */
+    "moduleResolution": "bundler",
+    "allowImportingTsExtensions": true,
+    "resolveJsonModule": true,
+    "isolatedModules": true,
+    "noEmit": true,
+    "jsx": "react-jsx",
+
+    /* Linting */
+    "strict": true,
+    "noUnusedLocals": true,
+    "noUnusedParameters": true,
+    "noFallthroughCasesInSwitch": true
+  },
+  "include": ["src"],
+  "references": [{ "path": "./tsconfig.node.json" }]
+}

package/templates/mern-ts/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/mern-ts/client/vite.config.ts

@@ -0,0 +1,8 @@
+import { defineConfig } from 'vite'
+import react from '@vitejs/plugin-react'
+import tailwindcss from '@tailwindcss/vite'
+
+// https://vitejs.dev/config/
+export default defineConfig({
+  plugins: [react(), tailwindcss()],
+})

package/templates/mern-ts/package.json

@@ -0,0 +1,19 @@
+{
+  "name": "mern-ts-template",
+  "version": "1.0.0",
+  "private": true,
+  "scripts": {
+    "postinstall": "npm run install:all",
+    "install:all": "npm run install:client && npm run install:server",
+    "install:client": "cd client && npm install",
+    "install:server": "cd server && npm install",
+    "dev": "concurrently \"npm run dev:client\" \"npm run dev:server\"",
+    "dev:client": "cd client && npm run dev",
+    "dev:server": "cd server && npm run dev",
+    "build": "cd client && npm run build",
+    "generate:vapid": "node ./server/src/utils/generateVapidKeys.js"
+  },
+  "devDependencies": {
+    "concurrently": "^8.2.2"
+  }
+}

package/templates/mern-ts/server/.env.example

@@ -0,0 +1,62 @@
+# ==========================
+# Application
+# ==========================
+NODE_ENV=development
+PORT=5001
+
+APP_NAME=My App
+APP_URL=http://localhost:5173
+APP_EMAIL=noreply@example.com
+APP_PRIMARY_COLOR=#2563eb
+
+# ==========================
+# Database
+# ==========================
+MONGO_URI=
+
+# ==========================
+# JWT
+# ==========================
+JWT_SECRET=
+JWT_EXPIRES_IN=7d
+
+# ==========================
+# Cloudinary
+# ==========================
+CLOUDINARY_CLOUD_NAME=
+CLOUDINARY_API_KEY=
+CLOUDINARY_API_SECRET=
+
+# ==========================
+# Email (SMTP)
+# ==========================
+SMTP_HOST=smtp.gmail.com
+SMTP_PORT=587
+SMTP_SECURE=false
+SMTP_USER=
+SMTP_PASS=
+SMTP_FROM="My App <noreply@example.com>"
+
+# ==========================
+# CORS
+# ==========================
+CLIENT_URL=http://localhost:5173
+
+# ==========================
+# Cookie
+# ==========================
+COOKIE_NAME=token
+COOKIE_EXPIRES_IN=7d
+
+# ==========================
+# Rate Limiting
+# ==========================
+RATE_LIMIT_WINDOW=15
+RATE_LIMIT_MAX=100
+
+# ==========================
+# Rate Limiting
+# ==========================
+VAPID_PRIVATE_KEY=
+VAPID_PUBLIC_KEY=
+VAPID_SUBJECT=mailto:noreply@example.com

package/templates/mern-ts/server/README.md

@@ -0,0 +1,69 @@
+# Node.js TypeScript Backend Boilerplate
+
+A production-ready, strongly-typed Node.js & Express boilerplate project with best-practice architectures, modular routing, and TypeScript compilation.
+
+## Features
+
+- ⚙️ **Modular Architecture:** Express application setup decoupled into `app.ts` (middleware + router wiring) and `index.ts` (server initialization & db connection).
+- 📝 **Colorized Logging:** Zero-dependency custom logger with timestamped success, warning, info, and error layouts.
+- 🛡️ **Security Out-of-the-Box:** Pre-configured with Helmet headers, CORS policies, and global rate limiters (`apiLimiter`, `authLimiter`, `uploadLimiter`).
+- 🔑 **Authentication & JWT:** Custom middlewares for route protection, sign-ups, and log-ins with HTTP-only cookie-based tokens.
+- 📧 **SMTP Mailer & OTP:** Standard mailer transport using Gmail NodeMailer wrapper, integrated with an OTP generator and email template.
+- 🖼️ **File Uploads:** Cloudinary integration utilizing Multer memory buffers for secure, single or multi-file uploads.
+- 🔌 **Socket.io Setup:** Pre-installed Socket.io hooks mapping connected user sessions to active sockets.
+- ✉️ **Web Push:** Push notifications integration powered by VAPID key generators and web-push subscriptions.
+- 📦 **TSX Engine:** Fast runtime TS loader supporting ESM resolutions natively with instant reloads.
+
+## Getting Started
+
+### 1. Configure Environment Variables
+
+Create a `.env` file in the root directory (based on `.env.example`):
+
+```env
+PORT=5002
+JWT_SECRET=your_super_secret_jwt_key
+MONGO_URI=your_mongodb_connection_uri
+
+# Cloudinary
+CLOUDINARY_CLOUD_NAME=your_cloud_name
+CLOUDINARY_API_KEY=your_api_key
+CLOUDINARY_API_SECRET=your_api_secret
+
+# SMTP Settings
+GMAIL_USER=your_email@gmail.com
+GMAIL_PASSCODE=your_app_password
+
+# Web Push
+VAPID_SUBJECT=mailto:your_email@example.com
+VAPID_PUBLIC_KEY=your_vapid_public_key
+VAPID_PRIVATE_KEY=your_vapid_private_key
+```
+
+### 2. Install & Start Development
+
+```bash
+# Install dependencies
+npm install
+
+# Start development server with reload (via tsx)
+npm run dev
+
+# Build the project to JS
+npm run build
+
+# Start production compiled server
+npm start
+```
+
+## API Endpoints
+
+### Auth Routes (`/api/auth`)
+- `POST /signup` - Registers a new user session
+- `POST /login` - Log in user and write token cookie
+- `POST /logout` - Clear token session cookies
+- `GET /me` - Returns logged-in user profile (requires auth)
+- `PUT /me` - Edit profile info and upload avatars (requires auth)
+
+### Upload Routes (`/api/upload`)
+- `POST /` - Securely uploads image/file to Cloudinary (requires auth)

package/templates/mern-ts/server/_gitignore

@@ -0,0 +1,24 @@
+# Logs
+logs
+*.log
+npm-debug.log*
+yarn-debug.log*
+yarn-error.log*
+pnpm-debug.log*
+lerna-debug.log*
+
+node_modules
+dist
+dist-ssr
+*.local
+
+# Editor directories and files
+.vscode/*
+!.vscode/extensions.json
+.idea
+.DS_Store
+*.suo
+*.ntvs*
+*.njsproj
+*.sln
+*.sw?

package/templates/mern-ts/server/package.json

@@ -0,0 +1,47 @@
+{
+  "name": "/Users/karan/workspace/Projects/boilerplate/test-app-node-ts",
+  "version": "1.0.0",
+  "main": "src/index.ts",
+  "type": "module",
+  "scripts": {
+    "start": "tsx src/index.ts",
+    "dev": "tsx watch src/index.ts",
+    "build": "tsc",
+    "generate:vapid": "node ./src/utils/generateVapidKeys.js"
+  },
+  "dependencies": {
+    "bcrypt": "^5.1.1",
+    "cloudinary": "^2.0.0",
+    "compression": "^1.7.4",
+    "cookie-parser": "^1.4.6",
+    "cors": "^2.8.5",
+    "dotenv": "^16.3.1",
+    "express": "^4.18.2",
+    "express-rate-limit": "^7.1.4",
+    "helmet": "^7.1.0",
+    "jsonwebtoken": "^9.0.2",
+    "mongoose": "^8.0.0",
+    "morgan": "^1.10.0",
+    "multer": "^1.4.5-lts.1",
+    "nodemailer": "^6.9.7",
+    "socket.io": "^4.7.2",
+    "web-push": "^3.6.6"
+  },
+  "devDependencies": {
+    "@types/bcrypt": "^5.0.2",
+    "@types/compression": "^1.7.5",
+    "@types/cookie-parser": "^1.4.6",
+    "@types/cors": "^2.8.17",
+    "@types/express": "^4.17.21",
+    "@types/jsonwebtoken": "^9.0.5",
+    "@types/morgan": "^1.9.9",
+    "@types/multer": "^1.4.11",
+    "@types/node": "^20.9.0",
+    "@types/nodemailer": "^6.4.14",
+    "@types/web-push": "^3.6.3",
+    "nodemon": "^3.0.1",
+    "ts-node": "^10.9.1",
+    "tsx": "^4.23.1",
+    "typescript": "^5.2.2"
+  }
+}

package/templates/mern-ts/server/src/app.ts

@@ -0,0 +1,36 @@
+import express, { Request, Response, NextFunction } from "express";
+import helmet from "helmet";
+import cors from "cors";
+import compression from "compression";
+import cookieParser from "cookie-parser";
+import morgan from "morgan";
+import apiRoutes from "./routes/index.js";
+import { notFound, errorHandler } from "./middleware/errorHandler.js";
+import { apiLimiter } from "./middleware/rateLimiter.js";
+
+const app = express();
+
+app.use(helmet());
+app.use(
+  cors({
+    origin: process.env.CLIENT_URL || "http://localhost:5173",
+    credentials: true,
+  })
+);
+app.use(compression());
+app.use(express.json());
+app.use(express.urlencoded({ extended: true }));
+app.use(cookieParser());
+app.use(morgan("dev"));
+
+app.use(apiLimiter);
+app.use("/api", apiRoutes);
+
+app.get("/api/health", (req: Request, res: Response) => {
+  res.status(200).json({ success: true, message: "API is running" });
+});
+
+app.use(notFound);
+app.use(errorHandler);
+
+export default app;

package/templates/mern-ts/server/src/config/cloudinary.ts

@@ -0,0 +1,9 @@
+import { v2 as cloudinary } from "cloudinary";
+
+cloudinary.config({
+  cloud_name: process.env.CLOUDINARY_CLOUD_NAME,
+  api_key: process.env.CLOUDINARY_API_KEY,
+  api_secret: process.env.CLOUDINARY_API_SECRET,
+});
+
+export default cloudinary;

package/templates/mern-ts/server/src/config/db.ts

@@ -0,0 +1,15 @@
+import mongoose from "mongoose";
+import logger from "../utils/logger.js";
+
+const connectDB = async () => {
+  try {
+    const MONGO_URI = process.env.MONGO_URI || "mongodb://localhost:27017/test";
+    const conn = await mongoose.connect(MONGO_URI);
+    logger.success(`MongoDB connected: ${conn.connection.host}`);
+  } catch (error: any) {
+    logger.error(`MongoDB connection error: ${error.message}`, error);
+    process.exit(1);
+  }
+};
+
+export default connectDB;

package/templates/mern-ts/server/src/config/dotenv.ts

@@ -0,0 +1,2 @@
+import dotenv from "dotenv";
+dotenv.config();

package/templates/mern-ts/server/src/config/email.ts

@@ -0,0 +1,28 @@
+import nodemailer from "nodemailer";
+import logger from "../utils/logger.js";
+
+const sendEmail = async (to: string, subject: string, message: string) => {
+  try {
+    const transporter = nodemailer.createTransport({
+      service: "gmail",
+      auth: {
+        user: process.env.GMAIL_USER,
+        pass: process.env.GMAIL_PASSCODE,
+      },
+    });
+
+    const mailOptions = {
+      from: process.env.GMAIL_USER,
+      to,
+      subject,
+      html: message,
+    };
+
+    const res = await transporter.sendMail(mailOptions);
+    logger.success(`Email sent to ${to}: ${res.messageId}`);
+  } catch (error) {
+    logger.error("Failed to send email", error);
+  }
+};
+
+export default sendEmail;

package/templates/mern-ts/server/src/config/socket.ts

@@ -0,0 +1,54 @@
+import { Server } from "socket.io";
+import logger from "../utils/logger.js";
+
+let io: Server;
+
+const userSocketMap: { [key: string]: Set<string> } = {};
+
+const initializeSocket = (server: any) => {
+  io = new Server(server, {
+    cors: {
+      origin: ["http://localhost:5173"],
+      credentials: true,
+    },
+  });
+
+  io.on("connection", (socket) => {
+    const userId = socket.handshake.auth.userId as string | undefined;
+
+    if (!userId) {
+      logger.warn("No userId, disconnecting socket");
+      socket.disconnect();
+      return;
+    }
+
+    logger.info(`Socket connected: ${socket.id} (User: ${userId})`);
+
+    if (!userSocketMap[userId]) {
+      userSocketMap[userId] = new Set<string>();
+    }
+    userSocketMap[userId].add(socket.id);
+
+    socket.on("disconnect", (reason) => {
+      if (!userId) return;
+      userSocketMap[userId].delete(socket.id);
+      logger.info(`Socket disconnected: ${socket.id} (Reason: ${reason})`);
+    });
+  });
+
+  return io;
+};
+
+export const getIO = () => {
+  if (!io) {
+    throw new Error("Socket.IO has not been initialized yet");
+  }
+  return io;
+};
+
+const getReceiverSocketIds = (userId: string) =>
+  userSocketMap[userId] ? Array.from(userSocketMap[userId]) : [];
+
+export { io, getReceiverSocketIds, userSocketMap };
+
+export default initializeSocket;

package/templates/mern-ts/server/src/config/webPush.ts

@@ -0,0 +1,9 @@
+import webpush from "web-push";
+
+webpush.setVapidDetails(
+  process.env.VAPID_SUBJECT as string || "", 
+  process.env.VAPID_PUBLIC_KEY as string || "",
+  process.env.VAPID_PRIVATE_KEY as string || ""
+);
+
+export default webpush;

package/templates/mern-ts/server/src/controllers/auth.controller.ts

@@ -0,0 +1,126 @@
+import { Request, Response, NextFunction } from "express";
+import { authService } from "../services/auth.service.js";
+import { generateToken } from "../utils/jwt.js";
+import genOtpToken from "../utils/genOtpToken.js";
+import logger from "../utils/logger.js";
+
+export const signup = async (req: Request, res: Response, next: NextFunction) => {
+  try {
+    const { name, email, phone, password } = req.body;
+    if (!email || !password || !name) {
+      return next({ status: 400, message: "All fields are required." });
+    }
+    const newUser = await authService.signup({ name, email, phone, password });
+    const token = await generateToken(newUser, res);
+    const safeUser: any = newUser.toObject();
+    delete safeUser.password;
+    res.status(201).json({ message: "Registration Successful", data: safeUser, token });
+  } catch (error) {
+    logger.error("Error in signup controller", error);
+    next(error);
+  }
+};
+
+export const login = async (req: Request, res: Response, next: NextFunction) => {
+  try {
+    const { email, password } = req.body;
+    if (!email || !password) {
+      return next({ status: 400, message: "All fields are required." });
+    }
+    const user = await authService.login({ email, password });
+    const token = await generateToken(user, res);
+    const safeUser: any = user.toObject();
+    delete safeUser.password;
+    res.status(200).json({ message: "Login successfully", data: safeUser, token });
+  } catch (error) {
+    logger.error("Error in login controller", error);
+    next(error);
+  }
+};
+
+export const logout = async (req: Request, res: Response, next: NextFunction) => {
+  try {
+    res.clearCookie("token", {
+      httpOnly: true,
+      secure: process.env.NODE_ENV === "production",
+      sameSite: "strict",
+      path: "/",
+    });
+    res.status(200).json({ message: "Logout Successfully" });
+  } catch (error) {
+    logger.error("Error in logout controller", error);
+    next(error);
+  }
+};
+
+export const getMe = async (req: Request, res: Response, next: NextFunction) => {
+  try {
+    const safeUser: any = req.user.toObject();
+    delete safeUser.password;
+    res.status(200).json({ message: "User Authenticated", data: safeUser });
+  } catch (error) {
+    logger.error("Error in getMe controller", error);
+    next(error);
+  }
+};
+
+export const genOtp = async (req: Request, res: Response, next: NextFunction) => {
+  try {
+    const { email } = req.body;
+    if (!email) {
+      return next({ status: 400, message: "Email is required." });
+    }
+    await authService.generateOtp(email);
+    res.status(200).json({ message: "Otp sent successfully" });
+  } catch (error) {
+    logger.error("Error in genOtp", error);
+    next(error);
+  }
+};
+
+export const verifyOtp = async (req: Request, res: Response, next: NextFunction) => {
+  try {
+    const { email, otp } = req.body;
+    if (!email || !otp) {
+      return next({ status: 400, message: "All fields are required." });
+    }
+    const user = await authService.verifyOtp({ email, otp });
+    await genOtpToken(user, res);
+    res.status(200).json({ message: "Otp verified successfully" });
+  } catch (error) {
+    logger.error("Error in verifyOtp", error);
+    next(error);
+  }
+};
+
+export const resetPassword = async (req: Request, res: Response, next: NextFunction) => {
+  try {
+    const { newPassword } = req.body;
+    const currentUser = req.user;
+    if (!newPassword) {
+      return next({ status: 400, message: "All fields are required." });
+    }
+    await authService.resetPassword(currentUser, newPassword);
+    res.status(200).json({ message: "Password updated successfully" });
+  } catch (error) {
+    logger.error("Error in resetPassword", error);
+    next(error);
+  }
+};
+
+export const updateMe = async (req: Request, res: Response, next: NextFunction) => {
+  try {
+    const { name, phone } = req.body;
+    const user = await authService.updateProfile(req.user._id, {
+      name,
+      phone,
+      file: req.file,
+    });
+    const safeUser: any = user.toObject();
+    delete safeUser.password;
+    res.status(200).json({ success: true, data: safeUser });
+  } catch (error) {
+    logger.error("Error updating profile", error);
+    next(error);
+  }
+};

package/templates/mern-ts/server/src/controllers/upload.controller.ts

@@ -0,0 +1,22 @@
+import { Request, Response, NextFunction } from "express";
+import { uploadSingleToCloudinary } from "../utils/cloudinaryUpload.js";
+import logger from "../utils/logger.js";
+
+export const uploadFile = async (req: Request, res: Response, next: NextFunction) => {
+  try {
+    if (!req.file) {
+      return res.status(400).json({ success: false, message: "No file uploaded" });
+    }
+    const result = await uploadSingleToCloudinary(req.file, {
+      folder: req.body.folder || "general_uploads",
+    });
+    res.status(200).json({
+      success: true,
+      message: "File uploaded successfully",
+      data: result,
+    });
+  } catch (error) {
+    logger.error("Upload controller error", error);
+    next(error);
+  }
+};

package/templates/mern-ts/server/src/index.ts

@@ -0,0 +1,17 @@
+import dotenv from "dotenv";
+import http from "http";
+import app from "./app.js";
+import connectDB from "./config/db.js";
+import logger from "./utils/logger.js";
+
+dotenv.config();
+
+const PORT = process.env.PORT || 5000;
+
+connectDB();
+
+const server = http.createServer(app);
+
+server.listen(PORT, () => {
+  logger.success(`Server is running on port ${PORT}`);
+});