create-wabck 1.0.0 → 1.1.1

package/README.md

@@ -23,7 +23,7 @@ npm create wabck@latest my-api
 | 🔐 Auth | JWT, Clerk, Firebase, None |
 | ✅ Validation | Zod, Joi, Express Validator |
 | 🔗 API Style | REST or GraphQL (Apollo Server 4) |
-| 📖 Docs | Swagger / OpenAPI 3 |
+| 📖 Docs | Swagger UI + openapi.yaml (OpenAPI 3.0) |
 | 🐳 Docker | Multi-stage Dockerfile + docker-compose |
 | ⚡ Package managers | npm, pnpm, yarn, bun |
 
@@ -53,6 +53,7 @@ my-api/
 │   ├── graphql/         (GraphQL only)
 │   ├── app.js
 │   └── server.js
+├── openapi.yaml         (optional, OpenAPI 3.0 YAML spec)
 ├── .env.example
 ├── .prettierrc
 ├── eslint.config.js
@@ -73,6 +74,9 @@ my-api/
 | POST | `/api/v1/auth/register` | Register (JWT) |
 | POST | `/api/v1/auth/login` | Login (JWT) |
 | GET | `/api/v1/auth/me` | Profile (JWT) |
+| GET | `/api-docs` | Swagger UI (Interactive Docs) |
+| GET | `/api-docs.yaml` | OpenAPI 3.0 YAML Spec |
+| GET | `/api-docs.json` | OpenAPI 3.0 JSON Spec |
 
 ## 📜 License
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "create-wabck",
-  "version": "1.0.0",
+  "version": "1.1.1",
   "description": "Scaffold production-ready Express.js backends in seconds",
   "type": "module",
   "bin": {
@@ -40,9 +40,5 @@
     "graphql"
   ],
   "author": "w4simz",
-  "license": "MIT",
-  "repository": {
-    "type": "git",
-    "url": ""
-  }
+  "license": "MIT"
 }

package/src/generator.js

@@ -20,7 +20,7 @@ import * as T from './templates/index.js';
  * @returns {Promise<string>} - Absolute path to the created project
  */
 export async function generate(options) {
-  const { projectName, language, database, auth, validation, apiStyle, docker } = options;
+  const { projectName, language, database, auth, validation, apiStyle, docker, swagger } = options;
   const isTS    = language === 'typescript';
   const ext     = isTS ? 'ts' : 'js';
   const hasDB   = database !== 'none';
@@ -28,6 +28,7 @@ export async function generate(options) {
   const hasJwt  = auth === 'jwt';
   const isGql   = apiStyle === 'graphql';
   const hasValidation = validation && validation !== 'none';
+  const hasSwagger    = swagger === true;
 
   const projectDir = path.resolve(process.cwd(), projectName);
   const createdDirs = [];
@@ -93,6 +94,9 @@ export async function generate(options) {
     await write('.prettierrc',       T.prettierrc());
     await write('eslint.config.js',  T.eslintConfig(options));
     await write('README.md',         T.readme(options));
+    if (hasSwagger) {
+      await write('openapi.yaml',    T.swaggerYaml(options));
+    }
 
     // ── TypeScript extras ─────────────────────────────────────────────────
     if (isTS) {
@@ -107,6 +111,9 @@ export async function generate(options) {
     // ── Config ────────────────────────────────────────────────────────────
     await write(`src/config/db.${ext}`,  T.db(options));
     await write(`src/config/env.${ext}`, T.envConfig(options));
+    if (hasSwagger) {
+      await write(`src/config/swagger.${ext}`, T.swaggerConfig(options));
+    }
 
     // ── Routes ────────────────────────────────────────────────────────────
     await write(`src/routes/index.${ext}`,        T.routesIndex(options));

package/src/index.js

@@ -73,10 +73,10 @@ async function main() {
 // ─────────────────────────────────────────────────────────────────────────────
 
 function printSuccessSummary(options, projectDir) {
-  const { projectName, language, database, auth, validation, docker, packageManager, installDeps } = options;
+  const { projectName, language, database, auth, validation, docker, swagger, packageManager, installDeps } = options;
   const pm      = packageManager;
   const relDir  = path.relative(process.cwd(), projectDir) || projectName;
-  const devCmd  = language === 'typescript' ? `${pm} run dev` : `${pm} run dev`;
+  const devCmd  = `${pm} run dev`;
 
   // Progress recap
   log.success('Project scaffolded successfully!');
@@ -85,7 +85,8 @@ function printSuccessSummary(options, projectDir) {
   log.label('  Database',   database === 'none' ? 'None' : database);
   log.label('  Auth',       auth === 'none' ? 'None' : auth);
   if (validation && validation !== 'none') log.label('  Validation', validation);
-  if (docker)  log.label('  Docker',     'Dockerfile + docker-compose.yml');
+  if (swagger)  log.label('  OpenAPI Docs', 'Swagger UI → /api-docs (openapi.yaml)');
+  if (docker)   log.label('  Docker',     'Dockerfile + docker-compose.yml');
   log.blank();
 
   // Next steps

package/src/prompts.js

@@ -62,7 +62,7 @@ export async function runPrompts(initialName) {
     choices: [
       { name: `${chalk.yellow('JWT')}      — jsonwebtoken + bcryptjs`, value: 'jwt'      },
       { name: `${chalk.blue('Clerk')}     — @clerk/express`,           value: 'clerk'    },
-      { name: `${chalk.orange?.('Firebase') || chalk.red('Firebase')} — firebase-admin`, value: 'firebase' },
+      { name: `${chalk.hex('#FFA500')('Firebase')} — firebase-admin`, value: 'firebase' },
       { name: `${chalk.dim('None')}       — no auth`,                   value: 'none'     },
     ],
   });
@@ -93,12 +93,19 @@ export async function runPrompts(initialName) {
     default: true,
   });
 
-  // 9. Install Dependencies
+  // 9. Swagger / OpenAPI docs
+  const swagger = await confirm({
+    message: 'Include Swagger / OpenAPI 3 docs? (served at /api-docs)',
+    default: true,
+  });
+
+  // 10. Install Dependencies
   const installDeps = await confirm({
     message: `Install dependencies now with ${chalk.cyan(packageManager)}?`,
     default: true,
   });
 
+
   return {
     projectName: projectName.trim(),
     language,
@@ -108,6 +115,7 @@ export async function runPrompts(initialName) {
     validation,
     apiStyle,
     docker,
+    swagger,
     installDeps,
   };
 }