🎉 v1.0.0: Initial Release
We are thrilled to announce the first stable release of ChaosProxy, the localhost saboteur!
This release brings powerful chaos engineering capabilities straight to your local development environment, forcing your frontend to handle the unpredictable nature of real-world networks.
🚀 Key Features
- Pass-Through Proxy Engine: A robust, non-blocking reverse proxy built on Node.js and NestJS.
- Latency Jitter: Simulate slow networks by injecting static or randomized latency ranges (e.g., 150ms-500ms) without blocking concurrent traffic.
- Probabilistic Error Injection: Intentionally short-circuit requests to return specific HTTP errors (e.g., 500, 503) based on a configured percentage rate.
- Intelligent Configuration: Define global rules and route-specific overrides (e.g., targeting only
POST /api/checkout) via a strongly typed, Zod-validatedchaos.jsonfile. - Developer-First UI: Beautiful, color-coded terminal logs that clearly distinguish between
[PASS],[DELAY],[CHAOS], and[DROP]events.
📦 Installation
npm install -g @akshatv21/chaosproxy
⚡ Quick Start
Run the proxy targeting your local backend on port 8080, adding 500ms of delay to all requests:
chaos --target http://localhost:8080 --port 3000 --delay 500
For full configuration options, including complex route-level error injection, please check out the README on the repository homepage.
A huge thank you to everyone who tests this out. Feel free to open an issue if you encounter any bugs or have feature requests!