lhumina_code/hero_whiteboard
24
0
Fork 0
Code Issues 1 Pull requests Projects Releases Packages Wiki Activity Actions
No description
53 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 f7c4dac403
Some checks failed
CI / build (push) Failing after 2s
Details
fix: update socket paths to per-service directory layout 
- Update hero_proc_sdk dependency
- Update hero_rpc_derive and hero_rpc_openrpc dependencies
- Migrate socket paths from /tmp/hero_proc.sock to /tmp/hero_proc/rpc.sock

Co-Authored-By: Claude Haiku 4.5 <noreply@anthropic.com>
2026-04-07 19:57:44 +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 fix: update socket paths to per-service directory layout 2026-04-07 19:57:44 +02:00
Cargo.toml Fix hero_proc_sdk git reference and simplify selfstart CLI 2026-04-05 15:21:44 +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