Skip to main content

Board

The Board is the main canvas where you visualize and interact with your software landscape.

Canvas Navigation & Interaction​

  • Infinite/zoomable canvas with a PixiJS-based rendering engine
  • Viewport controls:
    • Zoom in/out
    • Fit to frame
    • Center the view
    • Persist/restore viewport (server-backed)
  • Search: Open a search overlay from the sidebar to find items on the board

Collaboration & Realtime Presence​

Comper uses WebSocket for real-time collaboration:

  • Realtime updates for board changes over WebSocket
  • Presence & collaboration helpers:
    • Show connected users
    • Share cursor position updates
    • "Hosting session" / follow-mode (invite others to follow your screen)
    • WebSocket connection status indicator
  • Role/permission-aware UI: Board functionality gates based on server-sent role/permissions

Board Content​

Repository Nodes and Layout​

  • Repos are shown as first-class entities on the board
  • Auto-layout of visible content (permission-gated)
  • Save positions (including a detached/unsaved-changes mode)

Board Objects​

Create, move, update, and delete board objects (synchronized in realtime):

  • Text
  • Sticky notes
  • Rectangles
  • Database objects
  • Magnets (attraction modes for organizing)
  • Actors (people/roles as visual objects)
  • Arrows/anchors between items
  • Context menu + tooltips

Code Exploration​

  • Treemap-style code visualization (with caching on the client side)
  • Load/view repository files via server raw-file endpoint (text and common binary types)
  • "Zoom to code" behavior (toggleable)
  • Time-travel mode (UI toggle; used for navigating different points in time)

Insights Panels​

Lightweight panels that summarize aspects of the visible/selected data:

  • Code statistics:
    • General code stats panels
    • Authors and ownership views (contributors/owners)
    • Code age
    • Bus factor
    • Code security scoring/status visualization
  • System status panel:
    • Queue depth/tasks processing
    • CPU usage and disk info (when available)

Discussions & Annotations​

  • Discussion board UI with threads and comments
  • Threads can be attached to targets (including repo paths)
  • Comments support:
    • Nested replies (comment tree)
    • Editing and soft-delete
    • Comment revision/history viewing
    • Mention input
    • Thread state (open/closed) and comment type (Security / TechDebt / Question / FeatureRequest / Info / Other)
    • Per-repo "active comment paths" and urgency scoring (used to prioritize attention)

Guides​

Create narrated walkthroughs:

  • Create/update/delete guides
  • Guides consist of ordered steps/slides with:
    • Title + optional content
    • Optional waypoint to a repo + path (for navigation)
    • Optional durations (time per step)
    • Optional attached media (video)
  • Reorder steps
  • Guide updates are synchronized via WebSocket ("full guides updated")

Reports & Export​

  • Export contribution/time-spent report as CSV:
    • Select year
    • Select granularity (daily/weekly/monthly)
    • Select repository set (visible/selected, all excluding archived, all including archived)