draws cute animated canvas constellations
Last updated 3 years ago by walaura .
ISC · Repository · Bugs · Original npm · Tarball · package.json
$ cnpm install constellation-canvas 
SYNC missed versions from official npm registry.


Draws cute animated canvas constellations.

See it in action here!

Usage (webpack+babel)

Grab the code from here or npm

npm install constellation-canvas --save


git checkout
npm install

Then just import it and feed it some parameters. There's a full list below.

import Constellation from 'constellation-canvas';

const ellation = new Constellation({
    canvas: document.querySelector('canvas'),
    starCount: 30,
    lineCount: 60,
    style: {
        starSize: 4,
        starPadding: 5
        lineSize: 2


Usage (browser)

Grab the latest release and drop it in as a script tag. window.constellation will appear


All of them are optional but you might want to change some

Name Type Description
size array [x,y] Pixel size for the canvas
padding array [x,y] Space between the canvas edges and the stars, it can be negative to make a full background
canvas DOM element The canvas element to draw in. Will be created if it doesn't exist
starCount number Total number of stars to draw
lineCount number Total number of lines drawn between stars

speed object Speed options number Speed when the mouse is moving the stars
speed.passive number Speed when the stars are jiggling by themselves

style object Style options
style.starSize number Size of the stars
style.starColor string Color of the stars
style.starPadding number Space between stars and lines
style.lineColor string Color of the lines
style.lineSize number Size (line weight) of the lines

Drawing things yourself

For further customization you can also pass an onDraw parameter with a number of callbacks. These will allow you to take over the drawing process of the canvas.

let constellation = Constellation({
    canvas: document.querySelector('canvas'),
    onDraw: {
        afterStar: (ctx,style,star) => {
            ctx.fillStyle = 'rgba(0,0,0,0)';
                    node.pos[0], node.pos[1], style.starSize,0, 2 * Math.PI
                ctx.globalCompositeOperation = 'destination-over';
                ctx.shadowColor = '#999';
                ctx.shadowBlur = 20;
                ctx.shadowOffsetX = 0;
                ctx.shadowOffsetY = 15;
            ctx.fillStyle = style.starColor;

You can see how these plug in at src/class/Canvas.js for yourself to better understand what's happening but here's a quick reference.

Callback Description
star(ctx,style,star) overrides star drawing. star contains the coordinates for the star to be drawn
afterStar(ctx,style,star) takes place after the default star drawing. star contains the coordinates for the star that was drawn
line(ctx,style,line) overrides line drawing. line contains the coordinates for the line to be drawn
afterLine(ctx,style,line) takes place after the default line drawing. line contains the coordinates for the line that was drawn
afterFrame(ctx,style,objects) takes place after drawing a full frame. objects contains all coordinates for stars & lines

For afterStar & afterLine you have to reset all fillStyles and whatnot or otherwise they'll carry over into the built-in drawing code. Good news is that for performance reasons you'll probably want to avoid afterStar & afterLine anyway and instead provide a full drawing solution or plug into afterFrame.


There are some extra advanced properties too! fuzziness for controlling how reactive to the mouse stars are and scale, for drawing the canvas at a different resolution (it's @2x by default). Check out the code (i mean it's like 5? files total) to see how they work.

ALSO!! should you ever need it, Constellation will return a promise containing $constellation, the canvas DOM object after everything there has been done.

const constellation = Constellation({


Current Tags

  • 1.5.6                                ...           latest (3 years ago)

10 Versions

  • 1.5.6                                ...           3 years ago
  • 1.5.5                                ...           3 years ago
  • 1.5.4                                ...           3 years ago
  • 1.5.3                                ...           3 years ago
  • 1.5.2                                ...           3 years ago
  • 1.5.1                                ...           3 years ago
  • 1.5.0                                ...           3 years ago
  • 1.4.3                                ...           3 years ago
  • 1.4.2                                ...           3 years ago
  • 1.4.1                                ...           3 years ago
Maintainers (2)
Today 0
This Week 1
This Month 3
Last Day 0
Last Week 2
Last Month 2
Dev Dependencies (5)
Dependents (0)

Copyright 2014 - 2016 © |