Getting Started

Prerequisites

  • Deno 2.4+ (stable)

  • Optional for docs: Python 3.9+ with pip to build Sphinx documentation

Run locally

  1. Install Deno: https://deno.com/runtime

  2. Start the dev server:

    deno task dev

  3. Open the app at http://localhost:8000

Using the app

  • The left panel shows the palette.

  • Drag items from the palette onto the canvas to create nodes.

  • Move nodes by dragging their bodies.

  • Create a connection by clicking a source handle (right side), then a sink handle (left side).

  • Save or Save As using the toolbar buttons. On local dev, projects are written to ./projects.

  • Use Open to load a previously saved project.

Testing

Run the test suite:

deno task test

This runs integration tests against the server and unit tests for geometry helpers.

Project layout

  • main.ts — Deno.serve-based server for static content and JSON APIs

  • public/ — frontend SPA (no framework)

  • obj/ — object definition files (palette entries point here)

  • projects/ — saved project JSON files (local dev)

  • lib/ — server-side helpers (graph validation, storage adapters, geometry)

Next steps