How unamic0/miro-clone works
Boardy is a collaborative whiteboard: users sign in, find or create a board, then draw and manipulate shapes on its canvas while sharing the board with collaborators. The dashboard supports board listing and management; the workspace combines canvas tools and selection with Liveblocks presence. Convex provides the application backend, while Clerk supplies authentication. The sampled source shows the canvas composition and Liveblocks authorization route; dashboard-to-backend behavior and persistence details are only partly visible, so those links are documented or marked unverified rather than inferred as source calls.
Main entry points: index.tsx Interactive canvas · route.ts Room authorization · CanvasContext.tsx Canvas state · BoardList.tsx Board list
Components 23
Identity and access
- Clerk
- Sign-in pages
app/sign-in/page.tsx - Authenticated client
providers/convex-client-provider.tsx
Board discovery
- Dashboard
app/(dashboard)/page.tsx - Board list
app/(dashboard)/_components/BoardList.tsx - Board actions
components/Actions/index.tsx - Rename board
components/Actions/RenameModal.tsx
Canvas workspace
- Board workspace page
app/board/[boardId]/page.tsx - Interactive canvas
app/board/[boardId]/canvas/index.tsx - Canvas state
app/board/[boardId]/CanvasContext.tsx - Drawing toolbar
app/board/[boardId]/_components/Toolbar/index.tsx - Shape layers
app/board/[boardId]/_components/CanvasLayer.tsx - Shape selection
app/board/[boardId]/_components/OwnSelected/index.tsx - Canvas model
types/canvas.ts
Live collaboration
- Liveblocks
- Cursors and presence
app/board/[boardId]/_components/CursorsPresence.tsx - Room authorization
app/api/liveblocks-auth/route.ts
Backend and state
- Convex functions
convex/board.ts - Board functions
convex/boards.ts - Data schema
convex/schema.ts - Convex database
- Mutation hook
hooks/useApiMutation.ts
Other components
- Board user
Connections 31
- Board user → Sign-in pages: signs in
- Sign-in pages → Clerk: authenticates with
- Board user → Dashboard: opens boards
- Dashboard → Board list: renders
app/(dashboard)/page.tsx - Board list → Board functions: loads boards
- Board list → Board actions: offers actions
- Board actions → Mutation hook: deletes board
components/Actions/index.tsx - Board actions → Rename board: opens rename
components/Actions/index.tsx - Rename board → Mutation hook: submits rename
components/Actions/RenameModal.tsx - Mutation hook → Convex functions: calls mutations
- Board user → Board workspace page: opens board
- Board workspace page → Interactive canvas: shows canvas
- Interactive canvas → Shape layers: renders layers
app/board/[boardId]/canvas/index.tsx - Interactive canvas → Cursors and presence: renders cursors
app/board/[boardId]/canvas/index.tsx - Interactive canvas → Canvas state: reads state
app/board/[boardId]/canvas/index.tsx - Interactive canvas → Shape selection: renders selection
app/board/[boardId]/canvas/index.tsx - Interactive canvas → Drawing toolbar: uses tools
- Drawing toolbar → Canvas state: updates state
app/board/[boardId]/_components/Toolbar/index.tsx - Shape layers → Canvas model: uses layer model
app/board/[boardId]/_components/CanvasLayer.tsx - Canvas state → Canvas model: uses canvas state
app/board/[boardId]/CanvasContext.tsx - Shape selection → Canvas state: reads state
app/board/[boardId]/_components/OwnSelected/index.tsx - Shape selection → Canvas model: uses layer model
app/board/[boardId]/_components/OwnSelected/index.tsx - Cursors and presence → Liveblocks: syncs presence
- Board user → Room authorization: requests room access
- Room authorization → Clerk: checks identity
app/api/liveblocks-auth/route.ts - Room authorization → Convex functions: checks board access
app/api/liveblocks-auth/route.ts - Room authorization → Liveblocks: authorizes room
app/api/liveblocks-auth/route.ts - Convex functions → Convex database: reads and writes
- Board functions → Convex database: reads and writes
- Data schema → Convex database: defines data
- Authenticated client → Clerk: uses authentication
providers/convex-client-provider.tsx