{"id":49068813,"url":"https://github.com/paudang/nodejs-quickstart-structure","last_synced_at":"2026-04-27T13:00:28.420Z","repository":{"id":336232177,"uuid":"1148795357","full_name":"paudang/nodejs-quickstart-structure","owner":"paudang","description":"🚀 Powerful Node.js Generator to scaffold production-ready Microservices using MVC or Clean Architecture. Built-in Kafka, GraphQL, Security \u0026 AI-Native Support.","archived":false,"fork":false,"pushed_at":"2026-04-20T06:17:08.000Z","size":2647,"stargazers_count":7,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-04-20T06:27:54.322Z","etag":null,"topics":["ai-native","boilerplate","clean-architecture","enterprise","generator","graphql","javascript","kafka","microservices","mvc","nodejs","productivity","redis","scaffolding","typescript"],"latest_commit_sha":null,"homepage":"https://paudang.github.io/nodejs-quickstart-structure/","language":"EJS","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"isc","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/paudang.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":"SECURITY.md","support":"SUPPORT.md","governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2026-02-03T11:27:07.000Z","updated_at":"2026-04-20T04:35:54.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/paudang/nodejs-quickstart-structure","commit_stats":null,"previous_names":["paudang/nodejs-quickstart-structure"],"tags_count":16,"template":false,"template_full_name":null,"purl":"pkg:github/paudang/nodejs-quickstart-structure","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/paudang%2Fnodejs-quickstart-structure","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/paudang%2Fnodejs-quickstart-structure/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/paudang%2Fnodejs-quickstart-structure/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/paudang%2Fnodejs-quickstart-structure/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/paudang","download_url":"https://codeload.github.com/paudang/nodejs-quickstart-structure/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/paudang%2Fnodejs-quickstart-structure/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":32212819,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-04-24T03:15:14.334Z","status":"ssl_error","status_checked_at":"2026-04-24T03:15:11.608Z","response_time":64,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.6:443 state=error: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["ai-native","boilerplate","clean-architecture","enterprise","generator","graphql","javascript","kafka","microservices","mvc","nodejs","productivity","redis","scaffolding","typescript"],"created_at":"2026-04-20T06:14:46.919Z","updated_at":"2026-04-27T13:00:28.401Z","avatar_url":"https://github.com/paudang.png","language":"EJS","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Node.js Quickstart Generator\n\n[![npm version](https://img.shields.io/npm/v/nodejs-quickstart-structure.svg?style=flat-square)](https://www.npmjs.com/package/nodejs-quickstart-structure)\n![Total Clones](https://img.shields.io/badge/dynamic/json?color=brightgreen\u0026label=total%20clones\u0026query=total_clones\u0026url=https%3A%2F%2Fraw.githubusercontent.com%2Fpaudang%2Fnodejs-quickstart-structure%2Foutput%2Ftotal_stats.json\u0026style=flat-square)\n[![npm total downloads](https://img.shields.io/npm/dt/nodejs-quickstart-structure?style=flat-square\u0026color=emerald\u0026label=Downloads)](https://www.npmjs.com/package/nodejs-quickstart-structure)\n[![npm monthly downloads](https://img.shields.io/npm/dm/nodejs-quickstart-structure.svg?style=flat-square)](https://www.npmjs.com/package/nodejs-quickstart-structure)\n[![License: ISC](https://img.shields.io/badge/License-ISC-blue.svg?style=flat-square)](https://opensource.org/licenses/ISC)\n\n\n---\n\nA powerful ecosystem to scaffold production-ready Node.js microservices with built-in best practices. Choose between **MVC** or **Clean Architecture**, **JavaScript** or **TypeScript**, and your preferred tech stack in seconds.\n\n## Table of Contents\n\n- [Quick Start](#choose-your-journey)\n- [What's New](#whats-new-in-v21-the-authentication-release)\n- [Key Features](#key-features)\n- [Professional Standards](#professional-standards)\n- [5,280+ Project Combinations](#5280-project-combinations)\n- [Configuration Options](#configuration-options)\n- [Generated Project Structure](#generated-project-structure)\n- [Documentation](#documentation)\n- [Support \u0026 Roadmap](#support--roadmap)\n\n## Choose Your Journey\n \n| **Path A: Next-Gen Web UI** (Recommended) | **Path B: Interactive CLI** |\n| :--- | :--- |\n| \u003ca href=\"https://paudang.github.io/nodejs-quickstart-structure/#configurator\"\u003e\u003cimg src=\"docs/public/v2-preview.png\" width=\"100%\" alt=\"UI Preview\"\u003e\u003c/a\u003e | \u003cimg src=\"docs/demo.gif\" width=\"100%\" alt=\"CLI Demo\"\u003e |\n| [Try Visual Configurator →](https://paudang.github.io/nodejs-quickstart-structure/#configurator) | [See CLI Commands ↓](#path-b-interactive-cli) |\n| **Visual Preview**: Real-time folder simulation. | **Fast \u0026 Direct**: Quickly scaffold in terminal. |\n| **Zero-Prompt**: Paste a tailored command. | **AI-Ready**: Generates `.cursorrules`. |\n\n---\n\n### Path B: Interactive CLI\n**Scaffold your project directly from your terminal in seconds.**\n\n```bash\nnpx nodejs-quickstart-structure@latest init\n```\n\n*Or install globally:*\n```bash\nnpm install -g nodejs-quickstart-structure\n# Then run:\nnodejs-quickstart init\n```\n\n---\n\n## What's New in v2.1 (The Authentication Release)\n \n The v2.1.0 release is a major leap forward, turning the generator into a **Community Standard**:\n \n- **Pluggable JWT Authentication**: Production-ready access \u0026 refresh token patterns with automatic PM2/Environment configuration.\n- **AI-Native Foundation**: Built-in `.cursorrules` optimized for **Cursor** \u0026 AI agents—projects are \"Born to be Autonomously Coded.\"\n- **Next-Gen Web UI**: A browser-based visual project simulator with real-time folder previews.\n- **Enterprise Clean Architecture**: High-fidelity structure for professional Microservices (TS/JS).\n- **Hardened Security**: Integrated Snyk \u0026 SonarCloud logic in core templates.\n- **Zero-Prompt Workflow**: Generate projects with a single CLI command.\n\n---\n\n\n## Key Features\n\n- **Interactive CLI**: Smooth, guided configuration process.\n- **Multiple Architectures**: Supports both **MVC** and **Clean Architecture**.\n- **Modern Languages**: Choice of **JavaScript** or **TypeScript**.\n- **Database Ready**: Pre-configured for **MySQL**, **PostgreSQL**, or **MongoDB**.\n- **Communication Patterns**: Supports **REST**, **GraphQL** (Apollo), and **Kafka** (Event-driven).\n- **Multi-layer Caching**: Integrated **Redis** or built-in **Memory Cache**.\n- **Pluggable Authentication**: Built-in **JWT** support (Refresh/Access tokens).\n- **AI-Native Optimized**: specifically designed for **Cursor** and AI agents, including built-in `.cursorrules` and Agent Skill prompts.\n\n---\n\n## Professional Standards\n\nWe don't just generate boilerplate; we generate **production-ready** foundations. Every project includes:\n\n- **Code Quality**: Pre-configured `Eslint` and `Prettier`.\n- **Enterprise Security**: Integrated **Snyk (SCA)**, **SonarCloud (SAST)**, `Helmet`, `HPP`, and Rate-Limiting.\n- **Robust Error Handling**: Centralized global error middleware with custom error classes (`ApiError`, `NotFoundError`, etc.) — consistent across REST \u0026 GraphQL.\n- **Testing Excellence**: Integrated `Jest` and `Supertest` with **\u003e80% Unit Test coverage** out of the box.\n- **DevOps \u0026 CI/CD**: Optimized **Multi-Stage Dockerfiles**, health checks, infrastructure retry logic, and workflows for **GitHub Actions**, **Jenkins**, **GitLab CI**, **CircleCI**, and **Bitbucket Pipelines**.\n- **Scalable Deployment**: Integrated **PM2 Ecosystem** config for zero-downtime reloads.\n\n---\n\n## 5,280+ Project Combinations\n\nThe CLI supports a massive number of configurations to fit your exact needs:\n\n- **480 Core Combinations**:\n  - **MVC Architecture**: 360 variants (Languages × View Engines × Databases × Communication Patterns × Caching × Auth)\n  - **Clean Architecture**: 120 variants (Languages × Databases × Communication Patterns × Caching × Auth)\n- **5,280+ Total Scenarios**:\n  - Every combination can be generated across 5 CI/CD providers.\n  - Optional **Enterprise-Grade Security Hardening** doubles the scenarios.\n  - Every single scenario is verified to be compatible with our **80% Coverage Threshold** policy.\n\n---\n\n## Configuration Options\n\nThe CLI will guide you through:\n1. **Project Name**\n2. **Language**: `JavaScript` | `TypeScript`\n3. **Architecture**: `MVC` | `Clean Architecture`\n4. **View Engine**: (MVC only) `None` | `EJS` | `Pug`\n5. **Database**: `MySQL` | `PostgreSQL` | `MongoDB`\n6. **Communication**: `REST` | `GraphQL` | `Kafka`\n7. **Caching**: `None` | `Redis` | `Memory Cache`\n8. **Auth**: `None` | `JWT`\n9. **CI/CD**: `GitHub Actions` | `Jenkins` | `GitLab CI` | `CircleCI` | `Bitbucket Pipelines`\n10. **Security**: (Optional) Snyk \u0026 SonarCloud Hardening\n\n---\n\n## Generated Project Structure\nDepending on your choices, the structure adapts. Here is a **TypeScript + Clean Architecture** preview:\n\n```text\n.\n├── src/\n│   ├── application/     # Use cases \u0026 Business logic\n│   ├── domain/          # Entities \u0026 Repository interfaces\n│   ├── infrastructure/  # DB, External services, Repositories\n│   ├── interfaces/      # Controllers, Routes, GraphQL, Kafka\n│   ├── errors/          # Custom Error Classes\n│   ├── config/          # Environment \u0026 Global settings\n│   └── index.ts         # Server entry point\n├── flyway/sql/          # SQL migrations (if applicable)\n├── docker-compose.yml   # Infrastructure services\n├── package.json         # Scripts and dependencies\n├── .cursorrules         # AI assistance rules (The \"AI Brain\")\n└── .env.example         # Environment template\n```\n\n---\n\n## Documentation\n\nFor full guides, architecture deep-dives, and feature references, visit our **[Official Documentation Site](https://paudang.github.io/nodejs-quickstart-structure/guide/getting-started.html)**.\n\n---\n\n## Support \u0026 Roadmap\n\n### Support the Project\nIf this tool helped you build your project faster, please support us:\n- Give us a ⭐ on [GitHub](https://github.com/paudang/nodejs-quickstart-structure) to help us reach our next milestone!\n- Read our [Medium Series](https://medium.com/@paudang/nodejs-quickstart-generator-93c276d60e0b) for architecture deep-dives.\n\n### Roadmap\nTrack our progress and vote for features on our public board:\n**[View our Public Roadmap on Trello](https://trello.com/b/TPTo8ylF/nodejs-quickstart-structure-product)**\n\n---\n\n## Why Star us?\n\nWe are on a mission to build the best AI-Native Node.js scaffolding experience. Your star is not just a \"like\"—it's a vote of confidence that helps us:\n\n1. **Attract Contributors**: More stars attract professional maintainers to keep this project secure and up-to-date.\n2. **AI Model Awareness**: Popular repositories are weighted higher by AI coding assistants (Cursor, Copilot, etc.), making the generated code even better.\n3. **Open Source Sustainability**: It motivates us to keep building and shipping \"Enterprise-Grade\" features for free.\n\nIf this tool saved you hours of work, **[please give us a Star!](https://github.com/paudang/nodejs-quickstart-structure)**\n\n---\n\n## License\n\nISC\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fpaudang%2Fnodejs-quickstart-structure","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fpaudang%2Fnodejs-quickstart-structure","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fpaudang%2Fnodejs-quickstart-structure/lists"}