gem-hunter

A collaborative virtual whiteboard tool for sketching diagrams.

• Selection of tools - rectangle, ellipse, arrow, free-draw, text.
• Customizable shape style - color, size, fill, opacity, line style, animation.
• Shapes library.
• Live collaboration.
• Zoom and panning.
• History undo / redo.
• Export to PNG / JSON.
• Offline support.
• Dark Mode.

• Node.js: >=18.17.0
• pnpm: >=8.6.12

Clone the repository to your local machine.

Install dependencies:

pnpm install

The docker-compose file sets up a posgresql database and the backend for you.
Alternatively you can also set up your own postgresql database, you will need to set environment variables for it to work.

• docker-engine >=24 and buildkit.
• docker-compose v2.

docker compose build
docker compose up
docker compose down

Make sure to build packages before starting the development mode:

pnpm packages:build

Run client in development mode:

pnpm dev:client

Run server in development mode (if you don't use docker-compose):

pnpm dev:server

├── apps
│   ├── client (react codebase)
│   └── server (express api)
└── packages
    ├── eslint-config-bases (eslint configs)
    └── shared              (utils, types, schemas, themes)

Some handy scripts that can be run from any directory.

Awesome open-source packages used in this project:

• React Konva
• Radix UI
• Stitches
• zod
• node-postgres
• qr-code