node-best-practices

When to use

Use this skill whenever you are dealing with Node.js code to obtain domain-specific knowledge for building robust, performant, and maintainable Node.js applications.

TypeScript with Type Stripping

When writing TypeScript for Node.js, use type stripping (Node.js 22.6+) instead of build tools like ts-node or tsx. Type stripping runs TypeScript directly by removing type annotations at runtime without transpilation.

Key requirements for type stripping compatibility:

• Use import type for type-only imports
• Use const objects instead of enums
• Avoid namespaces and parameter properties
• Use .ts extensions in imports

See rules/typescript.md for complete configuration and examples.

How to use

Read individual rule files for detailed explanations and code examples:

• rules/error-handling.md – Error handling patterns in Node.js
• rules/async-patterns.md – Async/await and Promise patterns
• rules/streams.md – Working with Node.js streams
• rules/modules.md – ES Modules and CommonJS patterns
• rules/testing.md – Testing strategies for Node.js applications
• rules/flaky-tests.md – Identifying and diagnosing flaky tests with node:test
• rules/node-modules-exploration.md – Navigating and analyzing node_modules directories
• rules/performance.md – Performance optimization techniques
• rules/caching.md – Caching patterns and libraries
• rules/profiling.md – Profiling and benchmarking tools
• rules/logging.md – Logging and debugging patterns
• rules/environment.md – Environment configuration and secrets management
• rules/graceful-shutdown.md – Graceful shutdown and signal handling
• rules/typescript.md – TypeScript configuration and type stripping in Node.js