lhumina_code/hero_whiteboard
24
0
Fork 0
Code Issues 1 Pull requests Projects Releases Packages Wiki Activity Actions
No description
55 commits 5 branches 0 tags 2.2 MiB
  • JavaScript 53.4%
  • Rust 17.4%
  • Shell 11.7%
  • HTML 10%
  • CSS 6.8%
  • Other 0.7%
Find a file
Exact
despiegk cf73cc04d3
Some checks failed
CI / build (push) Failing after 1s
Details
Update Rust edition to 2024 and refresh cargo lockfile 
Bumped workspace edition from 2021 to 2024 per Hero toolchain conventions.
Ran cargo update to pick up latest hero_proc_sdk (0.5.0) and hero_rpc crates.

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
2026-04-08 12:34:18 +02:00
.forgejo/workflows Add base-path proxy support, HTTP health/discovery endpoints, kill_other sockets, and CI workflow 2026-03-25 15:50:58 +01:00
crates fix: update socket paths to per-service directory layout 2026-04-07 19:57:44 +02:00
schemas Enhance whiteboard UI, dashboard, and service architecture 2026-03-17 21:09:25 +01:00
scripts validate: scripts cleanup and service registration pattern check 2026-04-05 05:47:43 +02:00
.gitignore Initial project setup with specifications and technical instructions 2026-03-17 11:00:29 +01:00
buildenv.sh Add VERSION and PATCHLEVEL to buildenv.sh 2026-04-05 06:51:33 +02:00
Cargo.lock Update Rust edition to 2024 and refresh cargo lockfile 2026-04-08 12:34:18 +02:00
Cargo.toml Update Rust edition to 2024 and refresh cargo lockfile 2026-04-08 12:34:18 +02:00
INSTRUCTIONS_TECH.md Rename project from hero_miro to hero_whiteboard 2026-03-17 21:27:19 +01:00
Makefile fix: migrate sockets to hero_sockets per-service directory layout 2026-04-06 09:34:12 +02:00
README.md Add base-path proxy support, HTTP health/discovery endpoints, kill_other sockets, and CI workflow 2026-03-25 15:50:58 +01:00
SPECIFICATIONS.md Rename project from hero_miro to hero_whiteboard 2026-03-17 21:27:19 +01:00

README.md

Hero Whiteboard

A collaborative visual whiteboard — brainstorm, diagram, plan, present, and document decisions on an infinite canvas with real-time and async collaboration.

Architecture

Hero Whiteboard follows the Hero three-crate model:

Crate Purpose
hero_whiteboard_server Business logic, SQLite storage, OpenRPC API (Unix socket)
hero_whiteboard_sdk JSON-RPC client for the server over Unix socket
hero_whiteboard_ui End-user whiteboard UI + admin dashboard (Axum + Konva.js)
hero_whiteboard_examples SDK usage examples and integration tests
hero_whiteboard CLI for registering and managing services via hero_proc

Sockets

Service Path
Server ~/hero/var/sockets/hero_whiteboard_server.sock
UI ~/hero/var/sockets/hero_whiteboard_ui.sock

Quick Start

make build          # Build all crates
make install        # Install binaries to ~/hero/bin/
make run            # Start server + UI
make status         # Check service status
make logs           # View server logs
make logs-ui        # View UI logs
make stop           # Stop all services
make restart        # Restart all services

API

The server exposes a full JSON-RPC 2.0 API over the Unix socket. See the OpenRPC spec for all 45+ methods across these domains:

  • workspace.* — multi-tenant workspace management
  • board.* — board CRUD
  • object.* — whiteboard objects (sticky notes, shapes, text, etc.)
  • connector.* — arrows and connectors between objects
  • comment.* — threaded comments
  • share.* — share links and tokens
  • group.* — groups and permissions
  • user.* — user management
  • rpc.health, rpc.discover — health and OpenRPC discovery

Documentation