Skip to content


Switch branches/tags

Name already in use

A tag already exists with the provided branch name. Many Git commands accept both tag and branch names, so creating this branch may cause unexpected behavior. Are you sure you want to create this branch?

Latest commit


Git stats


Failed to load latest commit information.
Latest commit message
Commit time


This library is based on the Urpflanze package for generate the scene.

It deals with creating two-dimensional shapes, repeating them, manipulating them point by point and encapsulating them.


The creation of this library comes from the need to create simple APIs for manage the repetition of primitive shapes and the possibility of applying transformations to each of them, applying transformations on the points avoiding the use of canvas transformations.

Another need - which then became one of the main features - was to be able to encapsulate the result of a generation and manage it as if it were a new shape.


I am trying to create a tool for those who want to approach the world of programming or for programmers who want to approach the world of creative coding.

I have spent a lot of time and will spend more to support this project. I also have in mind a web editor (open-source) where you can use the features of this library in the browser.

You can see a preview here


The most immediate way to include Urpflanze in your project is to use an online hosted version.


Full version

<script src=""></script>

Customizable version

<script src="[@version]/build/urpflanze[-light][.min].js"></script>


To install it just run the command:

npm i --save @urpflanze/js

At the end you can include Urpflanze in your code

import * as Urpflanze from '@urpflanze/js'

const scene = new Urpflanze.Scene()

// or

import { Scene } from '@urpflanze/js'

const scene = new Scene()

use urpflanze/dist/index-light for light version


Hello Rect!

const scene = new Urpflanze.Scene()

const rect = new Urpflanze.Rect({
	repetitions: 8,
	distance: 100,
	sideLength: 20,
scene.add(rect) // Add rect to scene

const drawer = new Urpflanze.DrawerCanvas(scene, document.body)
drawer.draw() // Draw scene on canvas


Example output

Full docs and Examples

Core · DrawerCanvas · Animation