nodejs-best-practices

Guide framework, runtime, and architecture decisions for Node.js projects.

Updated Jan 21, 2026

Search Tags:#architecture #security #runtime #best-practices #nodejs #decision-making #framework-selection

Ready to run

npx skills add https://github.com/ollieb89/orchestrator --skill nodejs-best-practices-ollieb89

💬 Prompt for ChatGPT / Claude Chat▼

Please help me install this Agent Skill.
Skill: nodejs-best-practices
Source: https://github.com/ollieb89/orchestrator/tree/main/.cursor/skills/nodejs-best-practices
Command: npx skills add https://github.com/ollieb89/orchestrator --skill nodejs-best-practices-ollieb89

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Node.js teams often struggle to select the right runtime, framework, and architecture, leading to inconsistent patterns and fragile codebases. This skill helps teams think through decisions, aligning on a context-driven approach that scales with project needs.

Core Features & Use Cases

Decision framework for framework selection among Hono, Fastify, Express, NestJS, and Next.js API Routes based on deployment and team context.
Runtime and architecture guidance covering module systems, layering, error handling, testing, and security considerations.
Practical use cases: starting a new Node.js project, refactoring an existing codebase to a scalable architecture, or evaluating performance and security trade-offs.

Quick Start

Discuss your project requirements with stakeholders, then apply the framework selection and runtime principles to pick an architecture and patterns that fit the context.

Frequently Asked Questions about nodejs-best-practices

High-intent search queries and answers about installing and using this skill.

FAQPage Schema

How do I choose the right Node.js framework for my project?▼

Selecting a Node.js runtime system and framework involves evaluating project context to align architecture, error handling, and security patterns. This approach scales with project needs and prevents inconsistent patterns.

What is the best way to structure a Node.js project for scalability?▼

The best way to structure a Node.js project for scalability is adopting a layered architecture. This pattern separates concerns, guiding error handling, validation, and security considerations to maintain a robust codebase.

How do I refactor an existing Node.js codebase to a new framework?▼

Refactoring a Node.js codebase involves applying framework selection and runtime principles to transition to a scalable architecture. Teams align on context-driven decisions to resolve inconsistent patterns and fragile codebases.

NestJS vs Fastify: which Node.js framework should I pick?▼

Comparing NestJS vs Fastify depends on deployment and team context. Framework evaluation guides decisions based on project specifics, ensuring the selected runtime system and architecture fit performance and scaling needs.

What security and testing considerations apply to Node.js architecture decisions?▼

Node.js architecture decisions must integrate security and testing considerations alongside error handling and validation. Context-driven framework selection ensures these layers are properly evaluated to prevent fragile codebases.