npm package discovery and stats viewer.

Discover Tips

  • General search

    [free text search, go nuts!]

  • Package details

    pkg:[package-name]

  • User packages

    @[username]

Sponsor

Optimize Toolset

I’ve always been into building performant and accessible sites, but lately I’ve been taking it extremely seriously. So much so that I’ve been building a tool to help me optimize and monitor the sites that I build to make sure that I’m making an attempt to offer the best experience to those who visit them. If you’re into performant, accessible and SEO friendly sites, you might like it too! You can check it out at Optimize Toolset.

About

Hi, 👋, I’m Ryan Hefner  and I built this site for me, and you! The goal of this site was to provide an easy way for me to check the stats on my npm packages, both for prioritizing issues and updates, and to give me a little kick in the pants to keep up on stuff.

As I was building it, I realized that I was actually using the tool to build the tool, and figured I might as well put this out there and hopefully others will find it to be a fast and useful way to search and browse npm packages as I have.

If you’re interested in other things I’m working on, follow me on Twitter or check out the open source projects I’ve been publishing on GitHub.

I am also working on a Twitter bot for this site to tweet the most popular, newest, random packages from npm. Please follow that account now and it will start sending out packages soon–ish.

Open Software & Tools

This site wouldn’t be possible without the immense generosity and tireless efforts from the people who make contributions to the world and share their work via open source initiatives. Thank you 🙏

© 2026 – Pkg Stats / Ryan Hefner

signalk-wind-flow

v0.1.0

Published

Animated wind flow over the chart for Signal K chartplotters that support plotter extensions, drawn from the Signal K Weather API

Readme

Wind Flow

Animated wind particles over the chart, in the style of Windy, for Signal K chartplotters that support plotter extensions. The wind comes from the boat's own Signal K Weather API.

Wind flow round a depression, from the stand-in data of the dev host

Requirements

  • A chartplotter that supports image overlays (overlays.image), such as Freeboard-SK 3.4 or later. A plotter that also supports overlays.animated animates the layer smoothly; without it the particles move at the plotter's normal live-frame rate.
  • A weather provider plugin for the Signal K Weather API, such as @signalk/open-meteo-provider.

Install

Install Wind Flow from the Signal K App Store and enable it. There is nothing to configure on the server.

In the chartplotter, Wind flow appears in the layer controls, where you show, hide and fade it like any other layer. Its settings are on the same row.

| Setting | | |---|---| | Shade the chart by wind speed | Colours the chart by wind speed and turns the particles white. Off by default, because shading dims soundings and nav-aid symbols. | | Particles | Fewer, Normal or More. Fewer costs less on a slow display. |

A Wind flow legend widget shows the colour scale in your speed unit and the time of the wind shown. Add it from the plotter's widget areas.

The same view with shading on

How it works

The extension declares an image overlay drawn by a background runtime. The runtime never touches the plotter's page:

  • It asks the Weather API for the wind on a small grid over the view, about 50 positions, which sit on fixed multiples of the grid step. After a pan or zoom most of them are already cached, in the runtime and in the server's weather provider, which every display on the boat shares.
  • A Web Worker interpolates the grid (Catmull-Rom, held within each cell's corners), moves the particles and draws them into an OffscreenCanvas. Only the finished image is handed to the plotter.
  • It draws at the frame rate the plotter grants, one frame at a time, and stops, letting go of its canvases, while the layer is hidden.

Particles are kept in map coordinates with a short history of where each has been, so the flow carries on through pans, zooms and the rotation of a heading-up chart instead of starting over.

Development

npm install
npm test          # unit tests
npm run typecheck
npm run dev       # a stand-in plotter at http://localhost:3388/dev/

npm run dev serves the extension with a small stand-in plotter that talks to it over the real extension bus, and a stand-in Weather API whose wind is a depression west of Brittany. Add ?shading=1 to the URL to see the shading, or ?interval=200 for the frame rate of a plotter without overlays.animated.

To try it in a real plotter, link the package into a Signal K server (npm link here, then npm link signalk-wind-flow in ~/.signalk), restart the server and enable the plugin.

Releasing

Set the version in package.json and CHANGELOG.md, commit, then push a tag for it:

npm version 0.2.0 --no-git-tag-version   # or edit package.json
git commit -am "chore: release 0.2.0"
git tag v0.2.0 && git push && git push --tags

The Release workflow publishes that version to npm, where the Signal K App Store picks it up, and creates the GitHub Release. It needs an npm token in the repository's NPM_TOKEN secret.

License

Apache-2.0