Ecosystem Packages
All packages in the ocpp-ws-io ecosystem — from the core RPC library to smart charging, version translation, CLI tooling, and the live browser simulator.
The ocpp-ws-io ecosystem is a modular suite of TypeScript packages, each solving a distinct challenge in EV charging infrastructure. Every package is designed to work independently or seamlessly together.
The proxy, the smart charge engine and the CLI are part of ocpp-ws-io from 3.1.0 (on npm's beta tag until it is released): import ocpp-ws-io/proxy and ocpp-ws-io/smart-charge, and run the ocpp command. The separate packages ocpp-protocol-proxy, ocpp-smart-charge-engine and ocpp-ws-cli are deprecated; their last releases only re-export or run ocpp-ws-io.
Core Packages
ocpp-ws-io
The foundational WebSocket RPC library. Unified client & server across OCPP 1.6, 2.0.1, and 2.1 with end-to-end type safety, JSON schema validation, Security Profiles 0–3 (mTLS), and Redis clustering.
ocpp-ws-board
Real-time telemetry dashboard with live message inspection, server logs, connection monitoring, and performance metrics. Ships with Express, Hono, and NestJS adapters.
ocpp-ws-io/proxy
Transport-agnostic OCPP version translation proxy. Bridge legacy OCPP 1.6 chargers to modern 2.1 backends using pluggable middleware pipelines and pre-built translation presets. Formerly ocpp-protocol-proxy.
ocpp-ws-io/smart-charge
Library-agnostic mathematical solver that distributes constraint-limited grid power fairly across active EV charging sessions. Supports equal-share, priority, and TOU pricing strategies. Formerly ocpp-smart-charge-engine.
Developer Tools
ocpp CLI
The ocpp command of ocpp-ws-io (formerly ocpp-ws-cli): a command-line toolbox for OCPP development. Scaffold projects, spin up mock CSMS servers, send test messages, generate TLS certificates, and run load tests — all from your terminal.
ocpp-ws-simulator
Full-featured browser GUI for visual debugging and demos. Connect to any CSMS, inspect live OCPP frames in real time, and simulate complete multi-charger sessions.
voltlog-io
High-performance structured logging layer powering the ecosystem's network diagnostics. Pluggable transports, correlation IDs, and OCPP-aware formatters.
Install at a Glance
# Core RPC — client & server
npm install ocpp-ws-io
# Real-time dashboard & monitoring
npm install ocpp-ws-board
# Version translation proxy and smart charging math, in ocpp-ws-io from 3.1.0 (beta):
# import "ocpp-ws-io/proxy" and "ocpp-ws-io/smart-charge"
npm install ocpp-ws-io@beta
# CLI tools (no install required)
npx ocpp-ws-io@beta --help
# Logging
npm install voltlog-ioChoosing the Right Package
| Need | Package |
|---|---|
| Build a CSMS or charge point in Node.js | ocpp-ws-io |
| Monitor & inspect OCPP traffic in real-time | ocpp-ws-board |
| Support legacy 1.6 hardware on a 2.1 backend | ocpp-ws-io/proxy |
| Distribute grid power across multiple chargers | ocpp-ws-io/smart-charge |
| Test, mock, or debug OCPP traffic locally | the ocpp CLI (ocpp-ws-io) |
| Visualize OCPP sessions in the browser | ocpp-ws-simulator |
| Structured, performant logging | voltlog-io |
Each package installs on its own; the proxy, the smart charge engine and the CLI come with ocpp-ws-io. You don't need the full ecosystem — pick only what your project requires.
Interoperability
All packages share the same TypeScript type definitions for OCPP messages, meaning data flows between them without any manual type casting. See the Architecture Overview for how they wire together.