antonber/freero

A free, open-source (MIT) real-time collaborative whiteboard: an infinite canvas for teams and their
AI agents to brainstorm, plan, diagram and run workshops together. Claude, ChatGPT and other MCP
clients read boards and propose changes that people accept.
Use it free at freero.app, or self-host it from one Docker image
(deployment). Key facts: freero.app/facts.
## What's in it
Canvas — infinite pan/zoom, dot grid, minimap, snapping and alignment guides, multi-select,
resize/rotate, groups, lock, undo/redo, copy/paste across boards, drag-and-drop import.
Content — sticky notes, 21 shapes, rich text, connectors (straight/elbow/curved, attached,
labelled), pen + highlighter + eraser, images, emoji and stamps, frames, task cards, mind maps, tags,
PDFs, video and audio that play on the board, and file cards for any other file.
Collaboration — live sync, cursors and selections, avatars, follow a collaborator,
"bring everyone to me", emoji reactions, comment threads, owner/editor/commenter/viewer roles,
share by invite or link.
Facilitation — voting sessions, a shared timer, presentation mode over frames.
Templates & export — 586 original templates (retrospectives, planning, workshops, diagrams, strategy and more); export PNG/JPG/SVG, frames to PDF, copy as image.
Dashboard — boards grid/list, search, filters, stars, live thumbnails, duplicate, sharing.
## Run it
Requires Node 22+.
bash
npm install
npm run dev # server on :4000 + web on :5173
Open http://localhost:5173 and log in with the seeded demo account
demo@freero.app / freero123 (development only), or sign up.
http://localhost:5173/board/local is an offline sandbox board that needs no server.
Production:
bash
npm run build && npm start # serves the built web app and the marketing site (apps/site) on :4000
docker compose up --build -d # or the full stack: proxy, 2 app replicas, Postgres, Redis, MinIO, Mailpit on :8080
Deploying for real: docs/deployment.md · every setting:
docs/configuration.md · backups, monitoring, incidents:
docs/operations.md.
Configuration: PORT (default 4000), FREERO_DATA_DIR (default ./data — the built-in PGlite
database in data/pg + uploads), DATABASE_URL (use a real Postgres instead), DATABASE_POOL_MAX
(default 10). Had boards from before the move to Postgres? Stop the dev server and run
npm run db:import-sqlite once.
## Develop
| Command | What it does |
| npm run check | Architecture boundaries + typecheck + unit tests |
| npm run verify | Real-session end-to-end check: real server, real Yjs WebSocket clients, roles, persistence |