Complete BackForge v1.7.0 - Enterprise Backend Generator

Author: CodewithEvilxd

README.md

@@ -1,6 +1,6 @@
 {
   "name": "backforge-cli",
-  "version": "1.0.9",
+  "version": "1.7.0",
   "description": "BackForge CLI - Production-ready backend scaffolder (Global CLI wrapper)",
   "bin": {
     "backforge": "bin/backforge.js"
@@ -25,7 +25,7 @@
     "node": ">=18.0.0"
   },
   "dependencies": {
-    "backforge-core": "^1.0.12"
+    "backforge-core": "^1.7.0"
   },
   "scripts": {
     "build": "echo skip"

packages/backforge-cli/package.json

@@ -1,6 +1,6 @@
 {
   "name": "backforge-core",
-  "version": "1.0.12",
+  "version": "1.7.0",
   "description": "Production-ready backend scaffolder for Node.js and Bun - Core library",
   "main": "./dist/index.js",
   "module": "./dist/index.mjs",

packages/backforge-core/package.json

@@ -4,7 +4,7 @@ import * as p from '@clack/prompts';
 import pc from 'picocolors';
 import type { CLIOptions } from '../types';
 import { normalizeGenerateOptions } from '../scaffold/normalize';
-import { resolveDeps } from '../scaffold/deps';
+import { resolveDeps, getFeatureDependencies } from '../scaffold/deps';
 import { generateProjectFromTemplate } from '../scaffold/writer';
 import { installDependencies, detectPackageManager } from '../utils/pm';
 import { log, setSilent } from '../utils/log';
@@ -22,10 +22,21 @@ export async function createProject(
     const orm = (inOpts.orm ?? 'mongoose') as 'mongoose' | 'prisma';
     const framework = (inOpts.framework ?? 'express') as 'express' | 'fastify';
     const stackDeps = resolveDeps({ runtime, language, orm, framework });
+    const projectName = String(inOpts.projectName ?? normalized.context?.projectName ?? path.basename(String(normalized.targetRoot)));
+    const features = inOpts.features || [];
+
+    // Add feature-specific dependencies
+    const featureDeps = getFeatureDependencies(features, language);
+    const allDeps = { ...stackDeps.dependencies, ...featureDeps.dependencies };
+    const allDevDeps = { ...stackDeps.devDependencies, ...featureDeps.devDependencies };
+    const allScripts = { ...stackDeps.scripts, ...featureDeps.scripts };
+
     const ctx = Object.assign({}, normalized.context ?? {}, {
-      deps: stackDeps.dependencies,
-      devDependencies: stackDeps.devDependencies,
-      scripts: stackDeps.scripts ?? {},
+      deps: allDeps,
+      devDependencies: allDevDeps,
+      scripts: allScripts ?? {},
+      appName: projectName,
+      features,
     });
     const opts = {
       templatesRoot: String(normalized.templatesRoot),
@@ -36,8 +47,6 @@ export async function createProject(
     };
     setSilent(false);
 
-    const projectName = String(inOpts.projectName ?? ctx.projectName ?? path.basename(opts.targetRoot));
-    
     p.note(
       `Creating project ${pc.cyan(projectName)}
 Runtime: ${pc.green(runtime)}
@@ -107,6 +116,7 @@ export async function main() {
         language: userAnswers.language,
         orm: userAnswers.orm,
         framework: userAnswers.framework,
+        features: userAnswers.features,
         ...options
       };
 

packages/backforge-core/src/cli/index.ts

@@ -55,13 +55,62 @@ export async function askQuestions(): Promise<CLIOptions> {
     process.exit(1);
   }
 
+  // Additional features
+  const features = await p.multiselect({
+    message: 'Choose additional features (use SPACEBAR to select/deselect, ARROW keys to navigate, ENTER to confirm)',
+    options: [
+      { value: 'oauth', label: 'OAuth 2.0 (Google, GitHub)', hint: 'Social login integration' },
+      { value: 'clerk-auth', label: 'Clerk Authentication', hint: 'Modern auth service' },
+      { value: 'graphql', label: 'GraphQL (Apollo Server)', hint: 'GraphQL API with Apollo' },
+      { value: 'microservices', label: 'Microservices Template', hint: 'Service discovery & communication' },
+      { value: 'websocket', label: 'WebSocket (Socket.io)', hint: 'Real-time communication' },
+      { value: 'message-queue', label: 'Message Queue (RabbitMQ)', hint: 'Async messaging' },
+      { value: 's3-upload', label: 'S3 File Upload', hint: 'AWS S3 integration' },
+      { value: 'email', label: 'Email Service (SendGrid)', hint: 'Transactional emails' },
+      { value: 'payment-stripe', label: 'Payment (Stripe)', hint: 'Global payment processing' },
+      { value: 'payment-razorpay', label: 'Payment (Razorpay)', hint: 'Indian payment gateway' },
+      { value: 'admin-dashboard', label: 'Admin Dashboard', hint: 'Basic admin interface' },
+      { value: 'migrations-ui', label: 'Database Migrations UI', hint: 'Web-based migrations' },
+      { value: 'load-testing', label: 'Load Testing (k6)', hint: 'Performance testing scripts' },
+    ],
+    required: false,
+  }) as string[];
+
+  // Show selected features
+  if (features && features.length > 0) {
+    console.log('\n📋 Selected features:');
+    features.forEach((feature: string) => {
+      const option = [
+        { value: 'oauth', label: 'OAuth 2.0 (Google, GitHub)' },
+        { value: 'clerk-auth', label: 'Clerk Authentication' },
+        { value: 'graphql', label: 'GraphQL (Apollo Server)' },
+        { value: 'microservices', label: 'Microservices Template' },
+        { value: 'websocket', label: 'WebSocket (Socket.io)' },
+        { value: 'message-queue', label: 'Message Queue (RabbitMQ)' },
+        { value: 's3-upload', label: 'S3 File Upload' },
+        { value: 'email', label: 'Email Service (SendGrid)' },
+        { value: 'payment-stripe', label: 'Payment (Stripe)' },
+        { value: 'payment-razorpay', label: 'Payment (Razorpay)' },
+        { value: 'admin-dashboard', label: 'Admin Dashboard' },
+        { value: 'migrations-ui', label: 'Database Migrations UI' },
+        { value: 'load-testing', label: 'Load Testing (k6)' },
+      ].find(opt => opt.value === feature);
+      console.log(`  ✅ ${option?.label}`);
+    });
+    console.log('');
+  }
+  if (p.isCancel(features)) {
+    p.cancel('Operation aborted');
+    process.exit(1);
+  }
+
   p.log.info(pc.green('Configuration complete'));
 
   return {
-
     language: language as CLIOptions['language'],
     orm: orm as CLIOptions['orm'],
     framework: framework as CLIOptions['framework'],
     projectName: String(projectName),
+    features: features as string[],
   };
 }

packages/backforge-core/src/cli/questions.ts

@@ -60,6 +60,17 @@ const versions = {
   typescript_eslint: '^8.0.0',
   globals: '^15.14.0',
   eslint_js: '^9.0.0',
+  bcrypt: '^5.1.0',
+  jsonwebtoken: '^9.0.0',
+  swagger_jsdoc: '^6.2.0',
+  swagger_ui_express: '^5.0.0',
+  jest: '^29.0.0',
+  ts_jest: '^29.0.0',
+  mongodb_memory_server: '^10.0.0',
+  supertest: '^7.0.0',
+  types_bcrypt: '^5.0.0',
+  types_jsonwebtoken: '^9.0.0',
+  types_supertest: '^6.0.0',
 };
 
 export function resolveDeps(input: StackInput): StackDeps {
@@ -73,6 +84,10 @@ export function resolveDeps(input: StackInput): StackDeps {
   deps.uuid = versions.uuid;
   deps.winston = versions.winston;
   deps['winston-daily-rotate-file'] = versions.winston_daily_rotate_file;
+  deps.bcrypt = versions.bcrypt;
+  deps.jsonwebtoken = versions.jsonwebtoken;
+  deps['swagger-jsdoc'] = versions.swagger_jsdoc;
+  deps['swagger-ui-express'] = versions.swagger_ui_express;
 
   if (input.framework === 'express') {
     deps.express = versions.express;
@@ -138,11 +153,21 @@ export function resolveDeps(input: StackInput): StackDeps {
       dev['@types/hpp'] = '^0.2.5';
       dev['@types/compression'] = '^1.7.5';
       dev['@types/morgan'] = '^1.9.9';
+      dev.jest = versions.jest;
+      dev['ts-jest'] = versions.ts_jest;
+      dev['mongodb-memory-server'] = versions.mongodb_memory_server;
+      dev.supertest = versions.supertest;
+      dev['@types/bcrypt'] = versions.types_bcrypt;
+      dev['@types/jsonwebtoken'] = versions.types_jsonwebtoken;
+      dev['@types/supertest'] = versions.types_supertest;
     }
 
     scripts.build = 'rimraf dist && tsc';
     scripts.format = 'prettier --write "src/**/*.ts"';
     scripts.lint = 'eslint "src/**/*.ts" --fix';
+    scripts.test = 'jest';
+    scripts['test:watch'] = 'jest --watch';
+    scripts['test:coverage'] = 'jest --coverage';
 
     if (input.runtime === 'bun') {
       scripts.dev = 'bun run --watch src/server.ts';
@@ -183,3 +208,83 @@ export function resolveDeps(input: StackInput): StackDeps {
     scripts,
   };
 }
+
+export function getFeatureDependencies(features: string[], _language: 'ts' | 'js') {
+  const deps: Record<string, string> = {};
+  const dev: Record<string, string> = {};
+  const scripts: Record<string, string> = {};
+
+  if (features.includes('oauth')) {
+    deps['passport'] = '^0.7.0';
+    deps['passport-google-oauth20'] = '^2.0.0';
+    deps['passport-github2'] = '^0.1.12';
+  }
+
+  if (features.includes('clerk-auth')) {
+    deps['@clerk/clerk-sdk-node'] = '^4.13.14';
+    deps['@clerk/express'] = '^0.1.7';
+  }
+
+  if (features.includes('graphql')) {
+    deps['apollo-server-express'] = '^3.13.0';
+    deps['graphql'] = '^16.8.1';
+    deps['class-validator'] = '^0.14.1';
+    deps['type-graphql'] = '^2.0.0-beta.6';
+  }
+
+  if (features.includes('microservices')) {
+    deps['kafkajs'] = '^2.2.4';
+    deps['amqplib'] = '^0.10.4';
+    deps['redis'] = '^4.6.13';
+    deps['axios'] = '^1.6.7';
+  }
+
+  if (features.includes('websocket')) {
+    deps['socket.io'] = '^4.7.5';
+    deps['socket.io-client'] = '^4.7.5';
+  }
+
+  if (features.includes('message-queue')) {
+    deps['amqplib'] = '^0.10.4';
+  }
+
+  if (features.includes('s3-upload')) {
+    deps['aws-sdk'] = '^2.1606.0';
+    deps['multer'] = '^1.4.5-lts.1';
+    deps['multer-s3'] = '^3.0.1';
+    deps['uuid'] = '^9.0.1';
+  }
+
+  if (features.includes('email')) {
+    deps['@sendgrid/mail'] = '^8.1.3';
+    deps['nodemailer'] = '^6.9.13';
+  }
+
+  if (features.includes('payment-stripe')) {
+    deps['stripe'] = '^15.7.0';
+  }
+
+  if (features.includes('payment-razorpay')) {
+    deps['razorpay'] = '^2.9.2';
+  }
+
+  if (features.includes('admin-dashboard')) {
+    deps['adminjs'] = '^7.1.0';
+    deps['@adminjs/express'] = '^6.1.0';
+    deps['@adminjs/mongoose'] = '^4.0.0';
+  }
+
+  if (features.includes('migrations-ui')) {
+    deps['migrate-mongo'] = '^11.0.0';
+  }
+
+  if (features.includes('load-testing')) {
+    dev['k6'] = '^0.52.0';
+  }
+
+  return {
+    dependencies: deps,
+    devDependencies: dev,
+    scripts,
+  };
+}

packages/backforge-core/src/scaffold/deps.ts

@@ -13,6 +13,7 @@ function ensureAbsolute(p: string): string {
   return path.isAbsolute(p) ? p : path.resolve(process.cwd(), p);
 }
 
+// eslint-disable-next-line @typescript-eslint/no-unused-vars
 async function exists(p: string): Promise<boolean> {
   try {
     await fs.access(p);

packages/backforge-core/src/scaffold/normalize.ts

@@ -0,0 +1,36 @@
+<% if (features.includes('oauth')) { %>
+// OAuth2.0 Configuration (Google & GitHub)
+import passport from 'passport';
+import { Strategy as GoogleStrategy } from 'passport-google-oauth20';
+import { Strategy as GitHubStrategy } from 'passport-github2';
+
+passport.use(new GoogleStrategy({
+  clientID: process.env.GOOGLE_CLIENT_ID!,
+  clientSecret: process.env.GOOGLE_CLIENT_SECRET!,
+  callbackURL: `${process.env.BASE_URL}/api/v1/auth/google/callback`
+}, async (accessToken, refreshToken, profile, done) => {
+  try {
+    // Find or create user logic here
+    const user = { id: profile.id, email: profile.emails?.[0].value, name: profile.displayName };
+    return done(null, user);
+  } catch (error) {
+    return done(error, null);
+  }
+}));
+
+passport.use(new GitHubStrategy({
+  clientID: process.env.GITHUB_CLIENT_ID!,
+  clientSecret: process.env.GITHUB_CLIENT_SECRET!,
+  callbackURL: `${process.env.BASE_URL}/api/v1/auth/github/callback`
+}, async (accessToken, refreshToken, profile, done) => {
+  try {
+    // Find or create user logic here
+    const user = { id: profile.id, email: profile.emails?.[0].value, name: profile.displayName };
+    return done(null, user);
+  } catch (error) {
+    return done(error, null);
+  }
+}));
+
+export default passport;
+<% } %>

packages/backforge-core/src/scaffold/templates/features/oauth.ts.ejs

@@ -0,0 +1,31 @@
+FROM node:18-alpine AS builder
+
+WORKDIR /app
+
+COPY package*.json ./
+RUN npm ci --only=production
+
+COPY . .
+RUN npm run build
+
+FROM node:18-alpine AS runner
+
+RUN apk add --no-cache tini
+
+WORKDIR /app
+
+COPY --from=builder /app/dist ./dist
+COPY --from=builder /app/node_modules ./node_modules
+COPY --from=builder /app/package.json ./
+
+ENV NODE_ENV=production
+
+EXPOSE 3000
+
+USER node
+
+ENTRYPOINT ["/sbin/tini", "--"]
+CMD ["node", "dist/server.js"]
+
+HEALTHCHECK --interval=30s --timeout=3s --start-period=5s --retries=3 \
+  CMD node dist/healthcheck.js || exit 1

packages/backforge-core/src/scaffold/templates/stacks/ts/ts-mongoose-express/Dockerfile

@@ -0,0 +1,12 @@
+FROM node:18-alpine
+
+WORKDIR /app
+
+COPY package*.json ./
+RUN npm install
+
+COPY . .
+
+EXPOSE 3000
+
+CMD ["npm", "run", "dev"]