appinit-templates 1.0.0

package/base/common/,gitignore.ejs

@@ -0,0 +1,33 @@
+# Dependencies
+node_modules/
+jspm_packages/
+
+# Debug logs
+npm-debug.log*
+yarn-debug.log*
+yarn-error.log*
+
+# Environment variables (CRITICAL)
+.env
+.env.local
+.env.test
+
+# Build outputs
+dist/
+build/
+out/
+.next/
+
+# IDEs
+.vscode/
+.idea/
+*.swp
+
+# OS files
+.DS_Store
+Thumbs.db
+
+<%_ if (database === 'postgresql_prisma') { _%>
+# Prisma generated client
+src/generated/prisma
+<%_ } _%>

package/base/common/.prettierrc.ejs

@@ -0,0 +1,5 @@
+{
+  "semi": true,
+  "singleQuote": false,
+  "trailingComma": "all"
+}

package/base/common/db.ejs

@@ -0,0 +1,33 @@
+<%_ if (database === 'mongo') { _%>
+import mongoose from 'mongoose';
+
+const connectDb = async () => {
+  try {
+    if (mongoose.connection.readyState >= 1) return;
+    const conn = await mongoose.connect(process.env.MONGODB_URI);
+    console.log(`MongoDB Connected: ${conn.connection.host}`);
+  } catch (error) {
+    console.error(`MongoDB Connection Error: ${error instanceof Error ? error.message : error}`);
+    process.exit(1);
+  }
+};
+
+export default connectDb;
+
+<%_ } else if (database === 'postgresql_prisma') { _%>
+import { PrismaClient } from '@prisma/client';
+
+// Singleton to prevent connection exhaustion in dev
+const prisma = global.prisma || new PrismaClient();
+
+if (process.env.NODE_ENV !== 'production') {
+  global.prisma = prisma;
+}
+
+const connectDb = async () => {
+  await prisma.$connect();
+};
+
+export { prisma, connectDb };
+export default prisma;
+<%_ } _%>

package/base/common/env.ejs

@@ -0,0 +1,4 @@
+PORT = 3000
+NODE_ENV = development
+JWT_SECRET=your-super-secret-jwt-key-change-this-in-production
+JWT_EXPIRES_IN=7d

package/base/common/src/middleware/asyncHandler.ejs

@@ -0,0 +1,5 @@
+export const asyncHandler = (requestHandler) => {
+  return (req, res, next) => {
+    Promise.resolve(requestHandler(req, res)).catch(next);
+  };
+};

package/base/common/src/routes/health.routes.ejs

@@ -0,0 +1,12 @@
+import { Router } from "express";
+<%_ if (language === "ts") { _%>
+import { getHealth } from "../controllers/health.controller";
+<%_ } else { _%>
+import { getHealth } from "../controllers/health.controller.js";
+<%_ } _%>
+
+const router = Router();
+
+router.get("/", getHealth);
+
+export default router;

package/base/common/src/routes/index.ejs

@@ -0,0 +1,12 @@
+import { Router } from "express";
+<%_ if (language === "ts") { _%>
+import healthRoutes from "./health.routes";
+<%_ } else { _%>
+import healthRoutes from "./health.routes.js";
+<%_ } _%>
+
+const router = Router();
+
+router.use("/health", healthRoutes);
+
+export default router;

package/base/common/src/utils/ApiError.ejs

@@ -0,0 +1,9 @@
+class ApiError extends Error {
+  constructor(statusCode, message) {
+    super(message);
+    this.statusCode = statusCode;
+    this.success = false;
+  }
+}
+
+export default ApiError;

package/base/common/src/utils/logger.ejs

@@ -0,0 +1,25 @@
+import pino from "pino";
+<%_ if (language === "js") { _%>
+import { config } from "../config/env.js";
+<%_ } else { _%>
+import { config } from "../config/env";
+<%_ } _%>
+
+const logger =
+  config.nodeEnv === "development"
+    ? pino(
+        { level: "debug" },
+        pino.transport({
+          target: "pino-pretty",
+          options: {
+            colorize: true,
+            ignore: "pid,hostname",
+            translateTime: "SYS:standard",
+          },
+        }),
+      )
+    : pino({ level: "info" });
+
+export { logger };
+
+

package/base/javascript/.prettierrc.ejs

@@ -0,0 +1 @@
+<%- await include("../common/.prettierrc.ejs") %>

package/base/javascript/Readme.md.ejs

@@ -0,0 +1,135 @@
+# <%= name %>
+
+Production-ready Node.js backend starter generated by StackForge.
+
+## Template
+<%_ if (template.includes("websocket")) { _%>
+- Type: WebSocket + REST API
+- WebSocket engine: <%= websocket_package %>
+<%_ } else { _%>
+- Type: REST API
+<%_ } _%>
+- Language: JavaScript (ESM)
+<%_ if (database === "mongo") { _%>
+- Database: MongoDB (Mongoose)
+<%_ } else if (database === "postgresql_prisma") { _%>
+- Database: PostgreSQL (Prisma)
+<%_ } else { _%>
+- Database: None
+<%_ } _%>
+
+## Included Packages
+- express
+- dotenv
+- cors
+- helmet
+- jsonwebtoken
+- zod
+- pino
+- pino-http
+- pino-pretty
+<%_ if (template.includes("websocket")) { _%>
+- <%= websocket_package %>
+<%_ } _%>
+<%_ if (database === "mongo") { _%>
+- mongoose
+<%_ } else if (database === "postgresql_prisma") { _%>
+- @prisma/client
+- prisma
+<%_ } _%>
+- nodemon
+- eslint
+- prettier
+
+## Boilerplate Structure
+```txt
+.
+|-- .env
+|-- .gitignore
+|-- eslint.config.js
+<%_ if (Dockerfile) { _%>
+|-- Dockerfile
+<%_ } _%>
+|-- index.js
+|-- package.json
+|-- src
+|   |-- config
+|   |   |-- env.js
+|   |   `-- db.js
+|   |-- controllers
+|   |   `-- health.controller.js
+|   |-- middleware
+|   |   |-- asyncHandler.js
+|   |   `-- errorHandler.js
+|   |-- routes
+|   |   |-- index.js
+|   |   `-- health.routes.js
+|   `-- utils
+|       |-- ApiError.js
+|       `-- logger.js
+`-- Readme
+```
+
+## Quick Start
+```bash
+npm run dev
+```
+
+Server default: `http://localhost:3000`  
+Health route: `GET /api/health`
+
+## Environment Variables
+Base variables:
+- `PORT`
+- `NODE_ENV`
+- `JWT_SECRET`
+- `JWT_EXPIRES_IN`
+<%_ if (database === "mongo") { _%>
+- `MONGODB_URI` (required for MongoDB)
+<%_ } else if (database === "postgresql_prisma") { _%>
+- `DATABASE_URL` (required for PostgreSQL + Prisma)
+<%_ } _%>
+
+Update `.env` before running in production.
+
+## Database Notes
+<%_ if (database === "mongo") { _%>
+- `src/config/db.js` includes a `connectDb` helper using Mongoose.
+- Add your Mongo connection string in `.env` as `MONGODB_URI`.
+- Call `connectDb()` during app bootstrap if your flow requires explicit DB connection startup.
+<%_ } else if (database === "postgresql_prisma") { _%>
+- Prisma is initialized when the project is generated.
+- Set `DATABASE_URL` in `.env`.
+- Generate/apply schema as needed:
+```bash
+npx prisma generate
+npx prisma migrate dev
+```
+<%_ } else { _%>
+- No database package is enabled.
+- You can add one later by installing your preferred client/ORM and updating `src/config/db.js`.
+<%_ } _%>
+
+<%_ if (template.includes("websocket")) { _%>
+## WebSocket Notes
+- HTTP and WebSocket share the same server instance.
+<%_ if (websocket_package === "socket.io") { _%>
+- Socket.io server is configured in `index.js`.
+- Starter event flow includes a ping/pong example.
+- Use Socket.io client for browser/app connections.
+<%_ } else { _%>
+- `ws` server is configured in `index.js`.
+- Messages are expected in JSON format.
+- Starter flow includes ping handling and basic socket error/close behavior.
+<%_ } _%>
+<%_ } _%>
+
+<%_ if (Dockerfile) { _%>
+## Dockerfile
+- A Dockerfile is generated in the project root.
+- Basic usage:
+```bash
+docker build -t <%= name %> .
+docker run --env-file .env -p 3000:3000 <%= name %>
+```
+<%_ } _%>

package/base/javascript/eslint.config.js.ejs

@@ -0,0 +1,26 @@
+import js from "@eslint/js";
+
+export default [
+  js.configs.recommended,
+  {
+    files: ["**/*.js"],
+    languageOptions: {
+      ecmaVersion: 2022,
+      sourceType: "module",
+      globals: {
+        console: "readonly",
+        process: "readonly",
+      },
+    },
+    rules: {
+      "no-console": "off",
+      "no-unused-vars": [
+        "warn",
+        {
+          argsIgnorePattern: "^_",
+          varsIgnorePattern: "^_",
+        },
+      ],
+    },
+  },
+];

package/base/javascript/src/config/db.js.ejs

@@ -0,0 +1,34 @@
+<%_ if (database === 'mongo') { _%>
+import mongoose from "mongoose";
+
+const connectDb = async () => {
+  try {
+    if (mongoose.connection.readyState >= 1) return;
+    const conn = await mongoose.connect(process.env.MONGODB_URI);
+    console.log(`MongoDB Connected: ${conn.connection.host}`);
+  } catch (error) {
+    console.error(
+      `MongoDB Connection Error: ${error instanceof Error ? error.message : error}`
+    );
+    process.exit(1);
+  }
+};
+
+export default connectDb;
+<%_ } else if (database === 'postgresql_prisma') { _%>
+import { PrismaClient } from "@prisma/client";
+
+const prisma = global.prisma || new PrismaClient();
+
+if (process.env.NODE_ENV !== "production") {
+  global.prisma = prisma;
+}
+
+const connectDb = async () => {
+  await prisma.$connect();
+  console.log("PostgreSQL Connected");
+};
+
+export { prisma, connectDb };
+export default prisma;
+<%_ } _%>

package/base/javascript/src/config/env.js.ejs

@@ -0,0 +1,37 @@
+import dotenv from "dotenv";
+import { z } from "zod";
+
+dotenv.config();
+
+const envSchema = z.object({
+  NODE_ENV: z.enum(["development", "production", "test"]).default("development"),
+  PORT: z.coerce.number().default(3000),
+  <%_ if (database === 'mongo') { _%>
+  MONGODB_URI: z.string().min(1, "MongoDB URI is required"),
+  <%_ } else if (database === 'postgresql_prisma') { _%>
+  DATABASE_URL: z.string().min(1, "Database URL is required"),
+  <%_ } _%>
+  JWT_SECRET: z.string().min(1, "JWT secret is required"),
+  JWT_EXPIRES_IN: z.string().default("7d"),
+});
+
+const parsed = envSchema.safeParse(process.env);
+
+if (!parsed.success) {
+  console.error("Invalid environment variables:", parsed.error.format());
+  process.exit(1);
+}
+
+export const config = {
+  nodeEnv: parsed.data.NODE_ENV,
+  port: parsed.data.PORT,
+  <%_ if (database === 'mongo') { _%>
+  mongoUri: parsed.data.MONGODB_URI,
+  <%_ } else if (database === 'postgresql_prisma') { _%>
+  databaseUrl: parsed.data.DATABASE_URL,
+  <%_ } _%>
+  jwt: {
+    secret: parsed.data.JWT_SECRET,
+    expiresIn: parsed.data.JWT_EXPIRES_IN,
+  },
+};

package/base/javascript/src/controllers/health.controller.js.ejs

@@ -0,0 +1,40 @@
+import { asyncHandler } from "../middleware/asyncHandler.js";
+<%_ if (database === 'mongo') { _%>
+import mongoose from "mongoose";
+<%_ } else if (database === 'postgresql_prisma') { _%>
+import prisma from "../config/db.js";
+<%_ } _%>
+
+export const getHealth = asyncHandler(async (req, res) => {
+  const uptime = process.uptime();
+  <%_ if (database === 'none') { _%>
+  const dbStatus = "disconnected";
+  const isHealthy = true;
+  <%_ } else { _%>
+  let dbStatus = "disconnected";
+
+  <%_ if (database === 'mongo') { _%>
+  dbStatus = mongoose.connection.readyState === 1 ? "connected" : "disconnected";
+  
+  <%_ } else if (database === 'postgresql_prisma') { _%>
+  try {
+    await prisma.$queryRaw`SELECT 1`;
+    dbStatus = "connected";
+  } catch (e) {
+    dbStatus = "error";
+  }
+  <%_ } _%>
+
+  const isHealthy = dbStatus === "connected";
+  <%_ } _%>
+
+  res.status(isHealthy ? 200 : 503).json({
+    success: true,
+    data: {
+      status: "ok",
+      timestamp: new Date().toISOString(),
+      uptime: `${Math.floor(uptime)}s`,
+      database: dbStatus,
+    },
+  });
+});

package/base/javascript/src/index.js.ejs

@@ -0,0 +1,54 @@
+// javascript index file
+import express from "express";
+import helmet from "helmet";
+import cors from "cors";
+import routes from "./src/routes/index.js";
+import errorHandler from "./src/middleware/errorHandler.js";
+import { logger } from "./src/utils/logger.js";
+import { config } from "./src/config/env.js";
+
+<%_ if (database === 'postgresql_prisma') { _%>
+// Prisma note: in prisma/schema.prisma use:
+// provider = "prisma-client-js"
+// output = "../generated/prisma"
+<%_ } _%>
+
+const app = express();
+const port = config.port;
+
+app.use(express.json());
+app.use(helmet());
+app.use(cors());
+app.use(express.urlencoded({ extended: true }));
+
+// Call connectDb() from ./src/config/db.js to connect to your database and also update the env vars with database url
+
+// logger middleware
+app.use((req, res, next) => {
+  logger.info({
+    method: req.method,
+    path: req.path,
+    ip: req.ip,
+  });
+  next();
+});
+
+app.use("/api", routes);
+
+app.use(errorHandler);
+
+app.listen(port, () => {
+  logger.info(`Server running on port ${port}`);
+  logger.info(`Environment: ${config.nodeEnv}`);
+});
+
+process.on("SIGINT", () => {
+  console.log("SIGINT received, forcefully stopping the server");
+  process.exit(0);
+});
+process.on("SIGTERM", () => {
+  console.log("SIGTERM received, gracefully stopping the server");
+  process.exit(0);
+});
+
+export default app;

package/base/javascript/src/middleware/asyncHandler.js.ejs

@@ -0,0 +1 @@
+<%- await include("../../../common/src/middleware/asyncHandler.ejs") %>

package/base/javascript/src/middleware/errorHandler.js.ejs

@@ -0,0 +1,11 @@
+const errorHandler = (err,req,res,next)=>{
+  const statusCode = err.statusCode || 500;
+  const message = err.message || "Internal Server Error";
+
+  res.status(statusCode).json({
+    success: false,
+    message: message,
+  });
+}
+
+export default errorHandler;

package/base/javascript/src/routes/health.routes.js.ejs

@@ -0,0 +1 @@
+<%- await include("../../../common/src/routes/health.routes.ejs") %>

package/base/javascript/src/routes/index.js.ejs

@@ -0,0 +1,7 @@
+<%_ if (database === 'postgresql_prisma') { _%>
+// Prisma note: in prisma/schema.prisma use:
+// provider = "prisma-client-js"
+// output = "../generated/prisma"
+<%_ } _%>
+
+<%- await include("../../../common/src/routes/index.ejs") %>

package/base/javascript/src/utils/ApiError.js.ejs

@@ -0,0 +1 @@
+<%- await include("../../../common/src/utils/ApiError.ejs") %>

package/base/javascript/src/utils/logger.js.ejs

@@ -0,0 +1 @@
+<%- await include("../../../common/src/utils/logger.ejs") %>

package/base/typescript/.prettierrc.ejs

@@ -0,0 +1 @@
+<%- await include("../common/.prettierrc.ejs") %>

package/base/typescript/Readme.md.ejs

@@ -0,0 +1,141 @@
+# <%= name %>
+
+Production-ready Node.js backend starter generated by StackForge.
+
+## Template
+<%_ if (template.includes("websocket")) { _%>
+- Type: WebSocket + REST API
+- WebSocket engine: <%= websocket_package %>
+<%_ } else { _%>
+- Type: REST API
+<%_ } _%>
+- Language: TypeScript
+<%_ if (database === "mongo") { _%>
+- Database: MongoDB (Mongoose)
+<%_ } else if (database === "postgresql_prisma") { _%>
+- Database: PostgreSQL (Prisma)
+<%_ } else { _%>
+- Database: None
+<%_ } _%>
+
+## Included Packages
+- express
+- dotenv
+- cors
+- helmet
+- jsonwebtoken
+- zod
+- pino
+- pino-http
+- pino-pretty
+<%_ if (template.includes("websocket")) { _%>
+- <%= websocket_package %>
+<%_ } _%>
+<%_ if (database === "mongo") { _%>
+- mongoose
+<%_ } else if (database === "postgresql_prisma") { _%>
+- @prisma/client
+- prisma
+<%_ } _%>
+- typescript
+- ts-node
+- nodemon
+- eslint
+- prettier
+
+## Boilerplate Structure
+```txt
+.
+|-- .env
+|-- .gitignore
+|-- eslint.config.js
+<%_ if (Dockerfile) { _%>
+|-- Dockerfile
+<%_ } _%>
+|-- package.json
+|-- tsconfig.json
+|-- src
+|   |-- index.ts
+|   |-- config
+|   |   |-- env.ts
+|   |   `-- db.ts
+|   |-- controllers
+|   |   `-- health.controller.ts
+|   |-- middleware
+|   |   `-- errorHandler.ts
+|   |-- routes
+|   |   |-- index.ts
+|   |   `-- health.routes.ts
+|   `-- utils
+|       |-- ApiError.ts
+|       `-- logger.ts
+`-- Readme
+```
+
+## Quick Start
+```bash
+npm run dev
+```
+
+Server default: `http://localhost:3000`  
+Health route: `GET /api/health`
+
+## Environment Variables
+Base variables:
+- `PORT`
+- `NODE_ENV`
+- `JWT_SECRET`
+- `JWT_EXPIRES_IN`
+<%_ if (database === "mongo") { _%>
+- `MONGODB_URI` (required for MongoDB)
+<%_ } else if (database === "postgresql_prisma") { _%>
+- `DATABASE_URL` (required for PostgreSQL + Prisma)
+<%_ } _%>
+
+Update `.env` before running in production.
+
+## Database Notes
+<%_ if (database === "mongo") { _%>
+- `src/config/db.ts` includes a `connectDb` helper using Mongoose.
+- Add your Mongo connection string in `.env` as `MONGODB_URI`.
+- Call `connectDb()` during app bootstrap if your flow requires explicit DB connection startup.
+<%_ } else if (database === "postgresql_prisma") { _%>
+- Prisma is initialized when the project is generated.
+- Set `DATABASE_URL` in `.env`.
+- Generate/apply schema as needed:
+```bash
+npx prisma generate
+npx prisma migrate dev
+```
+<%_ } else { _%>
+- No database package is enabled.
+- You can add one later by installing your preferred client/ORM and updating `src/config/db.ts`.
+<%_ } _%>
+
+<%_ if (template.includes("websocket")) { _%>
+## WebSocket Notes
+- HTTP and WebSocket share the same server instance.
+<%_ if (websocket_package === "socket.io") { _%>
+- Socket.io server is configured in `src/index.ts`.
+- Starter event flow includes a ping/pong example.
+- Use Socket.io client for browser/app connections.
+<%_ } else { _%>
+- `ws` server is configured in `src/index.ts`.
+- Messages are expected in JSON format.
+- Starter flow includes ping handling and basic socket error/close behavior.
+<%_ } _%>
+<%_ } _%>
+
+## Scripts
+- `npm run dev`: Run in development mode with `ts-node`.
+- `npm run build`: Build TypeScript output.
+
+<%_ if (Dockerfile) { _%>
+## Dockerfile
+- A Dockerfile is generated in the project root.
+- Basic usage:
+```bash
+docker build -t <%= name %> .
+docker run --env-file .env -p 3000:3000 <%= name %>
+```
+<%_ } _%>