Skip to content

[FIX] Replace TlDraw with ExcaliDraw#8

Merged
nazarli-shabnam merged 1 commit intomainfrom
7-replace-tldraw-with-excalidraw
Mar 14, 2026
Merged

[FIX] Replace TlDraw with ExcaliDraw#8
nazarli-shabnam merged 1 commit intomainfrom
7-replace-tldraw-with-excalidraw

Conversation

@martian56
Copy link
Copy Markdown
Member

This pull request migrates the collaborative whiteboard feature from tldraw to Excalidraw, updating both the frontend and backend to support Excalidraw's scene format, cursor overlays, and real-time collaboration. It includes changes to dependencies, data models, API handling, and UI integration, ensuring a seamless transition for users and developers.

Migration to Excalidraw:

  • Swapped out tldraw for Excalidraw in the frontend, updating all relevant code, dependencies (package.json), and documentation (README.md). The frontend now uses the @excalidraw/excalidraw package, and references to tldraw have been replaced throughout. [1] [2] [3] [4]

  • Updated backend and data model to use excalidraw_snapshot instead of tldraw_snapshot, including the element type validation and the Alembic migration file for database consistency. [1] [2] [3] [4]

Frontend integration and state management:

  • Refactored the board page to use Excalidraw's API, including scene loading, state normalization, real-time updates, and UI options. Added logic to handle Excalidraw's expected scene and appState formats, and ensured proper saving and loading of board content. [1] [2] [3] F6bdf550L1, [4] [5] [6] [7] [8]

  • Updated the cursor overlay to use Excalidraw's viewport and coordinate system, ensuring remote cursors are positioned correctly for all collaborators.

Real-time collaboration and WebSocket handling:

  • Adapted the WebSocket hooks to handle Excalidraw scene updates (elements and appState), replacing tldraw document handling. [1] [2]

These changes collectively ensure the whiteboard experience is now powered by Excalidraw, with full support for real-time collaboration, persistence, and a modernized frontend stack.

Closes #7

@martian56 martian56 added this to the Deadline milestone Mar 14, 2026
@martian56 martian56 self-assigned this Mar 14, 2026
@martian56 martian56 added documentation Improvements or additions to documentation enhancement New feature or request labels Mar 14, 2026
@nazarli-shabnam nazarli-shabnam merged commit dc69743 into main Mar 14, 2026
2 checks passed
@devlaner-coolify-app
Copy link
Copy Markdown

The preview deployment for Loomy UI failed. 🔴

Open Build Logs | Open Application Logs

Last updated at: 2026-03-14 15:11:43 CET

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

documentation Improvements or additions to documentation enhancement New feature or request

Projects

None yet

Development

Successfully merging this pull request may close these issues.

Replace TlDraw with ExcaliDraw

2 participants