barrage/felony ↗

About barrage/felony

Felony is a Node.js framework built by Barrage that wraps Express.js with security defaults and development tools designed for developers who want good code structure with minimal setup. Written in TypeScript and requiring Node 14+, it's built as an ESM module and comes pre-configured with industry-standard security packages including Helmet, HPP, and CORS protection, all with sensible defaults that can be customized per environment.

The framework provides an integrated CLI toolset for generating routes, middleware, commands, database connections, events, listeners, and cron jobs, allowing developers to scaffold project components quickly. It includes a built-in async job queue system powered by Redis for handling long-running tasks in separate worker processes, letting the main HTTP instance dispatch work without blocking user requests. The framework also features its own event system called FelonyEvent that allows developers to raise and listen for application events, promoting loose coupling and easier feature extensions.

Configuration management is automatic, loading files from a `config/` directory with support for environment-specific overrides through `config/environments/{NODE_ENV}/` subdirectories. The project has been Barrage's internal framework for years and includes database abstraction for connecting any database or ORM, scheduled task execution via integrated cron scheduling, and comprehensive middleware support for routes. The framework emphasizes code inspection and learning through its own codebase, particularly the `base/` directory classes that serve as foundational components.