Tutorials

How GraviDraw works

GraviDraw is a drawing editor where shapes, text, brush marks, springs, pins, and gravity can all work together. You build a scene visually, then let the physics engine bring it to life.

Quick start

Choose a tool

Use the left toolbar to draw shapes, text, freehand brush strokes, springs, pins, cloth, rope, and other physics objects.

Draw on the canvas

Click and drag to place shapes. Click once with the text tool to add one text box, then double-click text to edit it.

Edit the object

Select an item to move it, resize it with the circular handles, rotate it with the rotation handle, and adjust properties in the right panel.

Save or export

Use the menu to save your project, export PNG or SVG files, or return to the dashboard to organize your work.

Drawing shapes

The shape tool creates rectangles, circles, triangles, and gears. Drag on the canvas to set the starting size, then use the selection handles to refine the object.

  • Rectangles use four corner handles for scaling and one handle for rotation.
  • Circles use four radius handles for scaling and one handle for rotation.
  • Triangles use three corner handles for scaling and one handle for rotation.

Selecting and editing

The select tool works for shapes and text boxes. Click one object to edit it, hold Shift to add more objects to the selection, or drag a selection area across the canvas.

  • Move selected objects by dragging them.
  • Use the right properties panel for size, rotation, color, stroke, texture, and typography controls.
  • Use texture uploads to fill shapes; circle and triangle textures stay masked inside the shape.

Working with text

The draw-text tool adds a single text box when you click the canvas. Double-click the text to edit the words, then use the typography panel to change the style.

  • Change font family, size, color, style, weight, alignment, and letter spacing.
  • The default text color is white so it stays visible on the black canvas.
  • Text boxes can be selected, moved, resized, and edited with the select tool.

Adding physics

Gravity and Matter.js physics make drawings feel alive. Turn gravity on to let objects fall, bounce, collide, and react to other objects in the scene.

  • The gravity center starts at the center bottom of the canvas so objects fall straight down.
  • Use pins to anchor objects and springs to connect objects together.
  • Make objects static when you want them to act like platforms or fixed parts of a mechanism.

Brush performance

The brush can create many small physics bodies, especially when brush gravity is enabled. Shorter strokes keep the editor smoother and reduce browser load.

  • Use smaller brush density when sketching large areas.
  • Pause between heavy strokes if the scene contains many physics objects.
  • Save your project before experimenting with complex brush physics.

Projects and account

The dashboard keeps your projects organized. Create a new project, rename or duplicate it, and reopen it in the editor when you want to keep working.

  • Use the Account page to update your username, profile picture, name, email, password, and notification settings.
  • The dashboard and editor show your uploaded profile image when one is available.
  • Use the menu in the editor to start a new named project before creating it.

Exporting work

When the drawing is ready, use the editor menu to save the canvas state or export artwork for sharing and presentation.

  • PNG export is best for images and social posts.
  • SVG export is useful for scalable vector-style output.
  • Video export lets you capture movement from physics-based compositions.