feat: sync image files

[martian56]

This pull request implements robust support for collaborative image/file synchronization in the board editor, ensuring that image blobs (files) are reliably shared and loaded across all peers. It introduces new logic for managing files in the Yjs-based collaboration layer, updates the frontend to handle file state alongside elements, and adds comprehensive tests to prevent regression bugs related to file and element syncing.

Collaboration and Synchronization Enhancements:

• Added support for synchronizing files (images/blobs) via Yjs: introduced FileJson type, applyFilesToYMap, and readFilesFromYMap functions, and updated the collaboration hook (useBoardCollab) to handle file syncing, observation, and callbacks. [1] [2] [3] [4] [5]
• Updated the board page to register files with Excalidraw whenever new files are received or loaded, ensuring that image elements always have their corresponding blobs and avoiding blank images or disabled interactions. [1] [2] [3] [4] [5] [6] [7]

API and Data Model Updates:

• Extended the board snapshot and shared board page data models to include a files field, ensuring that image data is preserved and loaded even for legacy boards. [1] [2] [3]

Testing and Regression Prevention:

• Added comprehensive tests for file synchronization and for suppressing "echo" updates when element changes are only superficial (e.g., only versionNonce, version, or updated fields change), preventing mid-drag snap-back bugs and unnecessary updates. [1] [2]

Internal Refactoring:

• Refactored the change handling logic in the board page to use a combined syncLocalChanges function, ensuring atomic updates of elements and files and preventing race conditions where an image element might reference a file not yet present. [1] [2] [3]

These changes collectively ensure a smoother, more reliable collaborative editing experience, especially when working with images and other file-based elements.

[nazarli-shabnam]

Nice work

[Copilot]

Pull request overview

This PR extends the board editor’s Yjs collaboration layer to synchronize Excalidraw file blobs (images) alongside elements, and wires the frontend to register incoming files so image elements load reliably for all peers (including from legacy snapshots).

Changes:

• Added Yjs bridge support for files (FileJson, applyFilesToYMap, readFilesFromYMap) and improved element “echo” suppression to avoid mid-drag snap-back.
• Updated board pages and collab hook to sync, observe, and seed files into Excalidraw via addFiles, plus a combined syncLocalChanges writer.
• Added/expanded Vitest coverage for file syncing and the echo-suppression regression cases.

Reviewed changes

Copilot reviewed 7 out of 8 changed files in this pull request and generated 4 comments.

Show a summary per file

File	Description
apps/frontend/src/pages/board/BoardPage.tsx	Registers remote/seeded files with Excalidraw and persists files into the saved snapshot while syncing files+elements together.
apps/frontend/src/pages/board/SharedBoardPage.tsx	Extends shared-board initial data to include files so shared view can render images.
apps/frontend/src/lib/collab/yjs-bridge.ts	Introduces file Y.Map helpers and changes element equality to suppress drift-only echoes.
apps/frontend/src/lib/collab/yjs-bridge.test.ts	Adds regression tests for echo suppression and file map syncing behavior.
apps/frontend/src/hooks/useBoardContent.ts	Extends persisted snapshot type to include files.
apps/frontend/src/hooks/useBoardCollab.ts	Adds file observation/callbacks, file sync helpers, and combined local sync transaction.
apps/frontend/package.json	Bumps frontend version to 0.4.0.
apps/frontend/package-lock.json	Updates lockfile version fields to match package.json version bump.

Files not reviewed (1)

• apps/frontend/package-lock.json: Language not supported

---

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

[devlaner-coolify-app]

The preview deployment for Loomy UI failed. 🔴

Open Build Logs | Open Application Logs

Last updated at: 2026-05-01 04:55:14 CET