@imksh/create 1.0.24 → 1.0.26

package/templates/production-fullstack/mobile/src/store/useNotificationStore.ts

@@ -0,0 +1,53 @@
+import { create } from 'zustand';
+import { getSocket } from '../lib/socket';
+import * as Notifications from 'expo-notifications';
+
+export interface NotificationState {
+  notifications: any[];
+  pushToken: string | null;
+  listenForSocketEvents: () => void;
+  registerForPushNotificationsAsync: () => Promise<void>;
+  fetchNotifications: () => Promise<void>;
+}
+
+export const useNotificationStore = create<NotificationState>((set, get) => ({
+  notifications: [],
+  pushToken: null,
+
+  listenForSocketEvents: () => {
+    const socket = getSocket();
+    if (!socket) return;
+
+    socket.on('new_notification', (data) => {
+      set((state) => ({ notifications: [data, ...state.notifications] }));
+    });
+  },
+
+  registerForPushNotificationsAsync: async () => {
+    try {
+      const { status: existingStatus } = await Notifications.getPermissionsAsync();
+      let finalStatus = existingStatus;
+      if (existingStatus !== 'granted') {
+        const { status } = await Notifications.requestPermissionsAsync();
+        finalStatus = status;
+      }
+      if (finalStatus !== 'granted') {
+        console.log('Failed to get push token for push notification!');
+        return;
+      }
+      // Note: projectId is required for Expo Go and EAS.
+      const token = (await Notifications.getExpoPushTokenAsync()).data;
+      set({ pushToken: token });
+      
+      // Here you would typically send the pushToken to your backend
+    } catch (e) {
+      console.warn("Failed to register for push notifications", e);
+    }
+  },
+
+  fetchNotifications: async () => {
+    // API call to fetch notifications could go here
+    // e.g., const data = await api.get('/notifications');
+    set({ notifications: [] });
+  }
+}));

package/templates/production-fullstack/mobile/src/types/common.type.ts

@@ -0,0 +1,6 @@
+export interface ApiResponse<T = any> {
+  data: T;
+  message?: string;
+  success?: boolean;
+  token?: string;
+}

package/templates/production-fullstack/mobile/src/types/images.d.ts

@@ -0,0 +1,24 @@
+declare module "*.png" {
+  const value: any;
+  export default value;
+}
+
+declare module "*.jpg" {
+  const value: any;
+  export default value;
+}
+
+declare module "*.jpeg" {
+  const value: any;
+  export default value;
+}
+
+declare module "*.gif" {
+  const value: any;
+  export default value;
+}
+
+declare module "*.svg" {
+  const value: any;
+  export default value;
+}

package/templates/production-fullstack/mobile/src/utils/toast.ts

@@ -0,0 +1,26 @@
+// utils/toast.ts
+
+import Toast from "react-native-toast-message";
+
+export const toast = {
+  success: (title: string, message?: string) =>
+    Toast.show({
+      type: "success",
+      text1: title,
+      text2: message,
+    }),
+
+  error: (title: string, message?: string) =>
+    Toast.show({
+      type: "error",
+      text1: title,
+      text2: message,
+    }),
+
+  info: (title: string, message?: string) =>
+    Toast.show({
+      type: "info",
+      text1: title,
+      text2: message,
+    }),
+};

package/templates/production-fullstack/mobile/tailwind.config.js

@@ -0,0 +1,71 @@
+/** @type {import('tailwindcss').Config} */
+module.exports = {
+  darkMode: "class",
+  content: ["./src/app/**/*.{js,jsx,ts,tsx}", "./src/components/**/*.{js,jsx,ts,tsx}"],
+  presets: [require("nativewind/preset")],
+  theme: {
+    extend: {
+      keyframes: {
+        bounce: {
+          "0%, 100%": {
+            transform: "translateY(-25%)",
+            animationTimingFunction: "cubic-bezier(0.8,0,1,1)",
+          },
+          "50%": {
+            transform: "translateY(0)",
+            animationTimingFunction: "cubic-bezier(0,0,0.2,1)",
+          },
+        },
+        floatUp: {
+          "0%": { transform: "translateY(50%)", opacity: "0" },
+          "50%": { transform: "translateY(-50%)", opacity: "1" },
+          "100%": { transform: "translateY(-100%)", opacity: "0" },
+        },
+        dice: {
+          "0%": { transform: "rotate(0deg)"},
+          "100%": { transform: "rotate(360deg)" },
+        },
+        flip: {
+          "0%": { transform: "rotatey(0deg)"},
+          "100%": { transform: "rotatey(360deg)" },
+        },
+      },
+      animation: {
+        bounce: "bounce 1s infinite",
+        "float-up": "floatUp 2s ease-in-out forwards",
+        "dice1": "dice 0.3s ease-in-out forwards infinite",
+        "dice2": "dice 0.3s ease-in-out forwards infinite",
+        "flip": "dice 0.8s ease-in-out forwards infinite",
+      },
+      colors: {
+        base: {
+          100: "rgb(var(--color-base-100) / <alpha-value>)",
+          200: "rgb(var(--color-base-200) / <alpha-value>)",
+          300: "rgb(var(--color-base-300) / <alpha-value>)",
+          content: "rgb(var(--color-base-content) / <alpha-value>)",
+        },
+        primary: {
+          DEFAULT: "rgb(var(--color-primary) / <alpha-value>)",
+          content: "rgb(var(--color-primary-content) / <alpha-value>)",
+        },
+        secondary: {
+          DEFAULT: "rgb(var(--color-secondary) / <alpha-value>)",
+          content: "rgb(var(--color-secondary-content) / <alpha-value>)",
+        },
+        accent: {
+          DEFAULT: "rgb(var(--color-accent) / <alpha-value>)",
+          content: "rgb(var(--color-accent-content) / <alpha-value>)",
+        },
+        neutral: {
+          DEFAULT: "rgb(var(--color-neutral) / <alpha-value>)",
+          content: "rgb(var(--color-neutral-content) / <alpha-value>)",
+        },
+        info: "rgb(var(--color-info) / <alpha-value>)",
+        success: "rgb(var(--color-success) / <alpha-value>)",
+        warning: "rgb(var(--color-warning) / <alpha-value>)",
+        error: "rgb(var(--color-error) / <alpha-value>)",
+      },
+    },
+  },
+  plugins: [],
+};

package/templates/production-fullstack/mobile/tsconfig.json

@@ -0,0 +1,23 @@
+{
+  "extends": "expo/tsconfig.base",
+  "compilerOptions": {
+    "jsx": "react-jsx",
+    "strict": true,
+    "noImplicitAny": false,
+    "paths": {
+      "@/*": [
+        "./src/*"
+      ],
+      "@/assets/*": [
+        "./assets/*"
+      ]
+    }
+  },
+  "include": [
+    "**/*.ts",
+    "**/*.tsx",
+    ".expo/types/**/*.ts",
+    "expo-env.d.ts",
+    "nativewind-env.d.ts"
+  ]
+}

package/templates/production-fullstack/server/.env.example

@@ -0,0 +1,63 @@
+# ==========================
+# Application
+# ==========================
+NODE_ENV=development
+PORT=5000
+
+APP_NAME=My App
+APP_URL=http://localhost:5173
+APP_EMAIL=noreply@example.com
+APP_PRIMARY_COLOR=#2563eb
+
+# ==========================
+# Database
+# ==========================
+
+DATABASE_URL="postgresql://johndoe:randompassword@localhost:5432/mydb?schema=public"
+
+# ==========================
+# 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/production-fullstack/server/README.md

@@ -0,0 +1,75 @@
+# Node.js TypeScript Prisma Backend Boilerplate
+
+A production-ready, strongly-typed Node.js & Express boilerplate project with best-practice architectures, modular routing, Prisma ORM, and TSX engine compilation.
+
+## Features
+
+- ⚙️ **Modular Architecture:** Express application setup decoupled into `app.ts` (middleware + router wiring) and `index.ts` (server initialization & db connection).
+- 🗄️ **Prisma ORM:** Built-in PostgreSQL datasource configuration and schema mapping for `User`, `Otp`, and `PushSubscription` models.
+- 📝 **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 TS runner with native ESM specifier resolution support.
+
+## 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
+DATABASE_URL=postgresql://user:password@localhost:5432/db_name
+
+# Cloudinary
+CLOUDINARY_CLOUD_NAME=your_cloud_name
+CLOUDINARY_API_KEY=your_api_key
+CLOUDINARY_API_SECRET=your_api_secret
+
+# SMTP Settings
+SMTP_USER=your_email@gmail.com
+SMTP_PASS=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 & Sync Schema
+
+```bash
+# Install dependencies
+npm install
+
+# Push database schema changes locally
+npm run db:push
+
+# Generate Prisma Client types
+npm run db:generate
+
+# Start development server with reload (via tsx)
+npm run dev
+
+# Build the project to JS
+npm run build
+```
+
+## 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/production-fullstack/server/eslint.config.js

@@ -0,0 +1,13 @@
+import eslint from '@eslint/js';
+import tseslint from 'typescript-eslint';
+
+export default tseslint.config(
+  eslint.configs.recommended,
+  ...tseslint.configs.recommended,
+  {
+    rules: {
+      'no-console': 'error',
+      '@typescript-eslint/no-explicit-any': 'error',
+    },
+  }
+);

package/templates/production-fullstack/server/package.json

@@ -0,0 +1,58 @@
+{
+  "name": "server",
+  "version": "1.0.0",
+  "main": "src/index.ts",
+  "type": "module",
+  "scripts": {
+    "start": "tsx src/index.ts",
+    "dev": "tsx watch src/index.ts",
+    "build": "tsc",
+    "db:push": "prisma db push",
+    "db:generate": "prisma generate",
+    "generate:vapid": "node ./src/utils/generateVapidKeys.js",
+    "lint": "eslint src/**/*.ts"
+  },
+  "dependencies": {
+    "@prisma/adapter-pg": "^7.9.1",
+    "@prisma/client": "^7.9.1",
+    "@prisma/config": "^7.9.1",
+    "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",
+    "expo-server-sdk": "^3.11.0",
+    "express": "^4.18.2",
+    "express-rate-limit": "^7.1.4",
+    "helmet": "^7.1.0",
+    "jsonwebtoken": "^9.0.2",
+    "morgan": "^1.10.0",
+    "multer": "^1.4.5-lts.1",
+    "nodemailer": "^6.9.7",
+    "pg": "^8.22.0",
+    "socket.io": "^4.7.2",
+    "web-push": "^3.6.6"
+  },
+  "devDependencies": {
+    "@eslint/js": "^10.0.1",
+    "@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",
+    "@typescript-eslint/eslint-plugin": "^8.66.0",
+    "@typescript-eslint/parser": "^8.66.0",
+    "eslint": "^10.8.0",
+    "prisma": "^7.9.1",
+    "tsx": "^4.23.1",
+    "typescript": "^5.2.2",
+    "typescript-eslint": "^8.66.0"
+  }
+}

package/templates/production-fullstack/server/prisma/schema/core/attachment.prisma

@@ -0,0 +1,14 @@
+model Attachment {
+  id        String          @id @default(uuid())
+  provider  StorageProvider
+  publicId  String // Cloudinary public_id, S3 key, or local path
+  url       String
+  fileName  String
+  mimeType  String
+  extension String
+  size      Int // File size in bytes
+  type      AttachmentType
+  createdAt DateTime        @default(now())
+  updatedAt DateTime        @updatedAt
+  deletedAt DateTime?
+}

package/templates/production-fullstack/server/prisma/schema/core/notification.prisma

@@ -0,0 +1,18 @@
+model Notification {
+  id        String           @id @default(uuid())
+  userId    String
+  title     String
+  message   String
+  type      NotificationType
+  actionUrl String?
+  metadata  Json?
+  isRead    Boolean          @default(false)
+  createdAt DateTime         @default(now())
+  updatedAt DateTime         @updatedAt
+  deletedAt DateTime?
+
+  user User @relation(fields: [userId], references: [id], onDelete: Cascade)
+
+  @@index([userId])
+  @@index([isRead])
+}

package/templates/production-fullstack/server/prisma/schema/core/permission.prisma

@@ -0,0 +1,26 @@
+model Permission {
+  id          String   @id @default(uuid())
+  action      String // e.g., "CREATE_USER", "VIEW_REPORTS"
+  module      String // e.g., "USER_MANAGEMENT", "FINANCE"
+  description String?
+  createdAt   DateTime @default(now())
+  updatedAt   DateTime @updatedAt
+
+  roles RolePermission[]
+
+  @@unique([action])
+}
+
+model RolePermission {
+  id           String   @id @default(uuid())
+  roleId       String
+  permissionId String
+  createdAt    DateTime @default(now())
+
+  role       Role       @relation(fields: [roleId], references: [id], onDelete: Cascade)
+  permission Permission @relation(fields: [permissionId], references: [id], onDelete: Cascade)
+
+  @@unique([roleId, permissionId])
+  @@index([roleId])
+  @@index([permissionId])
+}

package/templates/production-fullstack/server/prisma/schema/core/role.prisma

@@ -0,0 +1,25 @@
+model Role {
+  id            String    @id @default(uuid())
+  name          String    @unique
+  description   String?
+  createdAt     DateTime  @default(now())
+  updatedAt     DateTime  @updatedAt
+  deletedAt     DateTime?
+
+  permissions RolePermission[]
+  users       UserRole[]
+}
+
+model UserRole {
+  id        String   @id @default(uuid())
+  userId    String
+  roleId    String
+  createdAt DateTime @default(now())
+
+  user User @relation(fields: [userId], references: [id], onDelete: Cascade)
+  role Role @relation(fields: [roleId], references: [id], onDelete: Cascade)
+
+  @@unique([userId, roleId])
+  @@index([userId])
+  @@index([roleId])
+}

package/templates/production-fullstack/server/prisma/schema/core/user.prisma

@@ -0,0 +1,56 @@
+model User {
+  id            String     @id @default(uuid())
+  email         String     @unique
+  password      String
+  phone         String?
+  firstName     String
+  lastName      String
+  avatar        String?
+  status        UserStatus @default(ACTIVE)
+  emailVerified Boolean    @default(false)
+  lastLogin     DateTime?
+  createdAt     DateTime   @default(now())
+  updatedAt     DateTime   @updatedAt
+  deletedAt     DateTime?
+
+  // Relations
+  roles             UserRole[]
+  pushSubscriptions PushSubscription[]
+  notifications     Notification[]
+
+  @@index([email])
+  @@index([status])
+}
+
+model Otp {
+  id         String   @id @default(uuid())
+  identifier String // Can be email or phone
+  otp        String
+  expiresAt  DateTime
+  createdAt  DateTime @default(now())
+
+  @@index([identifier])
+}
+
+model PushSubscription {
+  id       String               @id @default(uuid())
+  type     PushSubscriptionType @default(WEB)
+
+  // For Web Push
+  endpoint String?
+  keys     Json?
+
+  // For Expo
+  token    String?
+
+  userId String
+  user   User   @relation(fields: [userId], references: [id], onDelete: Cascade)
+
+  createdAt DateTime  @default(now())
+  updatedAt DateTime  @updatedAt
+  deletedAt DateTime?
+
+  @@index([userId])
+  @@index([token])
+  @@index([endpoint])
+}

package/templates/production-fullstack/server/prisma/schema/enums/common.prisma

@@ -0,0 +1,13 @@
+enum StorageProvider {
+  LOCAL
+  S3
+  CLOUDINARY
+}
+
+enum AttachmentType {
+  IMAGE
+  DOCUMENT
+  VIDEO
+  AUDIO
+  OTHER
+}

package/templates/production-fullstack/server/prisma/schema/enums/notification.prisma

@@ -0,0 +1,6 @@
+enum NotificationType {
+  ALERT
+  REMINDER
+  MESSAGE
+  SYSTEM
+}

package/templates/production-fullstack/server/prisma/schema/enums/user.prisma

@@ -0,0 +1,11 @@
+enum UserStatus {
+  ACTIVE
+  INACTIVE
+  SUSPENDED
+  DELETED
+}
+
+enum PushSubscriptionType {
+  WEB
+  EXPO
+}

package/templates/production-fullstack/server/prisma/schema/schema.prisma

@@ -0,0 +1,7 @@
+generator client {
+  provider = "prisma-client-js"
+}
+
+datasource db {
+  provider = "postgresql"
+}

package/templates/production-fullstack/server/prisma.config.ts

@@ -0,0 +1,14 @@
+/// <reference types="node" />
+import { defineConfig } from '@prisma/config'
+import 'dotenv/config'
+
+export default defineConfig({
+  schema: 'prisma/schema',
+  migrations: {
+    path: 'prisma/migrations',
+    seed: 'npx tsx prisma/seed.ts',
+  },
+  datasource: {
+    url: process.env.DATABASE_URL,
+  },
+})

package/templates/production-fullstack/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 "./common/middlewares/errorHandler.js";
+import { apiLimiter } from "./common/middlewares/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/v1", 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;