2.2.1 • Public • Published

HTML Canvas Gauges v2.2+

This is a fork from from the original project. The project is not maintained anymore.

This fork aims to fix known issues. I do not plan to improve the library but PRs are welcomed!

Package available on npm as @godind/canvas-gauges

Fixes in v2.2.0

  • Crash caused by canvas context stack leak. Both Radial and Linear gauges leaked but Linear was severe. Tests after 24h with multiple gauges and fast updates reveal no leaks (context stack still returns to 0). This fix is a refactoring of context management.
  • Bug with Radial animationTarget='plate' not working.
  • Animation frame not set to null causing leak.
  • Improved Destroy clean up.


  • Added Progress bar example pages to cover for fast animation scenarios.
  • Added npm script commands to facilitate dev.

ORIGINAL - HTML Canvas Gauges v2.1+

Build Status Test Coverage Documentation Coverage License run on repl.it

Canvas Gauges

This is tiny implementation of highly configurable gauge using pure JavaScript and HTML5 canvas. No dependencies. Suitable for IoT devices because of minimum code base.


Canvas gauges can be simply installed using npm package manager. Depending on your needs there is possibility to install whole gauge library or only that part you really need for your project. To install the whole library, run:

$ npm install canvas-gauges

If you only need the exact type of the gauge it can be installed using the appropriate npm tag. Currently the following gauges are supported: linear, radial.

To install only linear gauge, run:

$ npm install canvas-gauges@linear

To install only radial gauge, run:

$ npm install canvas-gauges@radial

This strategy useful only if you need to minimize your code base and plan to use ONLY a specific gauge type. If you need to use various gauge types in your project it is recommended to use whole gauge package.



You can find complete docs on the canvas gauges web-site:


Here are some third-party libraries which are developed and delivered to use canvas-gauges as components for a different popular frameworks:

Special Thanks


For supporting development!


For testing support!

And to all contributors!


This code is subject to MIT license.

Package Sidebar


npm i @godind/canvas-gauges

Weekly Downloads






Unpacked Size

50.3 kB

Total Files


Last publish


  • godind