Skip to content

ericrisco/rsc-harness / skills/ux

Use when an app or SaaS must be easy to use: designing complete user flows, screens and every state, navigation, forms, onboarding, tables, dashboards, search or AI features, or auditing usability and accessibility. Anyone finishes the job without a manual; experts go fast. NOT the visual direction (design), NOT the words (landing-copy).

FileKindSize
SKILL.mdskill md9.3 KB
THIRD_PARTY.mdmarkdown1.6 KB
evals/cases.yamlconfig2.5 KB
references/flows.mdmarkdown7.3 KB
upstream/UPSTREAM.jsonconfig4.7 KB
upstream/ux-designer/GUIDE.mdmarkdown15.2 KB
upstream/ux-designer/LICENSEother1.0 KB
upstream/ux-designer/references/01-core-principles.mdmarkdown7.9 KB
upstream/ux-designer/references/02-laws-of-ux.mdmarkdown8.3 KB
upstream/ux-designer/references/03-accessibility.mdmarkdown10.7 KB
upstream/ux-designer/references/04-visual-design.mdmarkdown8.9 KB
upstream/ux-designer/references/05-information-architecture.mdmarkdown9.1 KB
upstream/ux-designer/references/06-interaction-design.mdmarkdown11.2 KB
upstream/ux-designer/references/07-forms-and-inputs.mdmarkdown11.4 KB
upstream/ux-designer/references/08-mobile-ux.mdmarkdown10.9 KB
upstream/ux-designer/references/09-ux-writing.mdmarkdown9.0 KB
upstream/ux-designer/references/10-user-research.mdmarkdown10.6 KB
upstream/ux-designer/references/11-design-systems.mdmarkdown13.2 KB
upstream/ux-designer/references/12a-presence-awareness.mdmarkdown10.2 KB
upstream/ux-designer/references/12b-conflict-resolution-sync.mdmarkdown15.8 KB
upstream/ux-designer/references/13a-canvas-navigation.mdmarkdown9.5 KB
upstream/ux-designer/references/13b-canvas-objects-performance.mdmarkdown14.2 KB
upstream/ux-designer/references/14-ai-ux-patterns.mdmarkdown20.9 KB
upstream/ux-designer/references/15-ethical-design.mdmarkdown13.9 KB
upstream/ux-designer/references/16-onboarding.mdmarkdown16.5 KB
upstream/ux-designer/references/17-notifications.mdmarkdown17.7 KB
upstream/ux-designer/references/18-data-visualization.mdmarkdown18.8 KB
upstream/ux-designer/references/19-search-ux.mdmarkdown19.0 KB
upstream/ux-designer/references/20-emotional-design.mdmarkdown14.5 KB
upstream/ux-designer/references/21-data-tables.mdmarkdown20.5 KB
upstream/ux-designer/references/22-performance-ux.mdmarkdown17.5 KB
upstream/ux-designer/references/23-internationalization.mdmarkdown15.4 KB
upstream/ux-designer/references/24-voice-and-multimodal.mdmarkdown15.9 KB
upstream/ux-designer/references/25a-barcode-camera-scanning.mdmarkdown21.3 KB
upstream/ux-designer/references/25b-barcode-scanner-workflows.mdmarkdown25.3 KB
upstream/ux-designer/references/25c-barcode-display.mdmarkdown17.3 KB
upstream/ux-usability-foundations/GUIDE.mdmarkdown16.0 KB
upstream/ux-usability-foundations/LICENSEother1.0 KB
upstream/ux-usability-foundations/references/anti-patterns.mdmarkdown8.3 KB
upstream/ux-usability-foundations/references/checklists.mdmarkdown6.2 KB
upstream/ux-usability-foundations/references/decision-prompts.mdmarkdown10.0 KB
upstream/ux-usability-foundations/references/principle-cards.mdmarkdown15.4 KB

upstream/ux-designer/references/13a-canvas-navigation.md

View on GitHub
# Canvas Apps: Navigation & Interaction

Canvas-based interfaces provide an infinite 2D workspace where users can freely place, move, and manipulate objects. Found in design tools (Figma, Sketch), whiteboards (Miro, FigJam), maps, and diagramming apps.

---

## Contents

- Canvas Navigation
- Object Selection
- Object Manipulation
- Key Metrics
- Anti-Patterns
- Sources

---

## Canvas Navigation

### Coordinate Systems

A canvas app has two coordinate systems:

```javascript
// Screen coordinates: pixel position on display
const screenPoint = { x: 500, y: 300 };

// Canvas coordinates: position in the infinite canvas space
const canvasPoint = {
  x: (screenPoint.x - camera.x) / camera.zoom,
  y: (screenPoint.y - camera.y) / camera.zoom
};

// Camera state
const camera = {
  x: 0,      // Horizontal offset
  y: 0,      // Vertical offset
  zoom: 1    // Scale factor (1 = 100%)
};
```

### Zoom UI

Zoom should feel natural, focusing on the cursor position.

```javascript
function handleZoom(event) {
  event.preventDefault();

  const zoomFactor = event.deltaY > 0 ? 0.9 : 1.1;
  const newZoom = clamp(camera.zoom * zoomFactor, MIN_ZOOM, MAX_ZOOM);

  // Zoom toward cursor position
  const cursorX = event.clientX;
  const cursorY = event.clientY;

  // Calculate new camera position to keep cursor point fixed
  camera.x = cursorX - (cursorX - camera.x) * (newZoom / camera.zoom);
  camera.y = cursorY - (cursorY - camera.y) * (newZoom / camera.zoom);
  camera.zoom = newZoom;

  render();
}
```

#### Zoom Controls

```
┌──────────────────────────────┐
│  [−]  ━━━●━━━━━━━━━  [+]     │  Slider
│           100%               │  Current level
│  [Fit] [50%] [100%] [200%]   │  Presets
└──────────────────────────────┘
```

| Control | Action |
|---------|--------|
| Scroll wheel | Zoom in/out |
| Ctrl/Cmd + scroll | Zoom (alternative) |
| Pinch gesture | Zoom on touch devices |
| +/- keys | Step zoom |
| 0 or 1 | Reset to 100% |
| Shift + 1 | Fit all to view |
| Shift + 2 | Fit selection to view |

#### Zoom Levels

```
Typical range: 10% to 4000%+
Common presets: 25%, 50%, 75%, 100%, 150%, 200%, 400%

Semantic zooming (content changes at different levels):
- 10-25%   → Show only shapes/outlines
- 25-50%   → Show basic content, hide details
- 50-100%  → Full content visible
- 100-200% → Pixel-perfect editing
- 200%+    → Sub-pixel precision work
```

### Pan/Scroll

```javascript
// Space + drag to pan
let isPanning = false;
let lastPanPoint = { x: 0, y: 0 };

function handleKeyDown(event) {
  if (event.code === 'Space' && !isPanning) {
    isPanning = true;
    document.body.style.cursor = 'grab';
  }
}

function handleMouseMove(event) {
  if (isPanning && event.buttons === 1) {
    camera.x += event.clientX - lastPanPoint.x;
    camera.y += event.clientY - lastPanPoint.y;
    document.body.style.cursor = 'grabbing';
    render();
  }
  lastPanPoint = { x: event.clientX, y: event.clientY };
}
```

#### Pan Methods

| Method | Trigger | Notes |
|--------|---------|-------|
| Space + drag | Hold space, click and drag | Most common in design tools |
| Middle mouse | Middle click and drag | Power user shortcut |
| Two-finger drag | Trackpad gesture | Natural for laptop users |
| Scroll bars | Click and drag | Visible scroll position |
| Arrow keys | Keyboard navigation | Step-based movement |

### Minimap / Overview

Bird's-eye navigation for large canvases.

```html
<div class="minimap">
  <canvas id="minimap-canvas"></canvas>
  <div class="minimap__viewport"></div>
</div>
```

```css
.minimap {
  position: fixed;
  bottom: 16px;
  right: 16px;
  width: 200px;
  height: 150px;
  background: #f3f4f6;
  border: 1px solid #d1d5db;
  border-radius: 8px;
  overflow: hidden;
}

.minimap__viewport {
  position: absolute;
  border: 2px solid #3b82f6;
  background: rgba(59, 130, 246, 0.1);
  cursor: move;
}
```

**Minimap Guidelines:**
- Show at 5-10% of actual canvas scale
- Highlight current viewport area
- Allow click-to-navigate
- Allow drag viewport rectangle
- Consider hiding when zoomed to fit all

---

## Object Selection

### Selection Modes

```javascript
// Click selection
function handleClick(event) {
  const hitObject = hitTest(event.x, event.y);

  if (event.shiftKey) {
    // Add to / remove from selection
    toggleSelection(hitObject);
  } else {
    // Replace selection
    clearSelection();
    if (hitObject) select(hitObject);
  }
}

// Marquee selection
function handleMarquee(startPoint, endPoint) {
  const rect = {
    x: Math.min(startPoint.x, endPoint.x),
    y: Math.min(startPoint.y, endPoint.y),
    width: Math.abs(endPoint.x - startPoint.x),
    height: Math.abs(endPoint.y - startPoint.y)
  };

  const contained = objects.filter(obj =>
    isContainedIn(obj.bounds, rect)
  );

  if (event.shiftKey) {
    addToSelection(contained);
  } else {
    setSelection(contained);
  }
}
```

### Selection Visuals

```css
/* Selected object */
.object--selected {
  outline: 2px solid #3b82f6;
  outline-offset: 2px;
}

/* Selection marquee */
.selection-marquee {
  position: absolute;
  border: 1px solid #3b82f6;
  background: rgba(59, 130, 246, 0.1);
  pointer-events: none;
}

/* Multi-selection bounding box */
.selection-bounds {
  position: absolute;
  border: 1px dashed #3b82f6;
}
```

### Selection Keyboard Shortcuts

| Shortcut | Action |
|----------|--------|
| Click | Select single object |
| Shift + Click | Add/remove from selection |
| Cmd/Ctrl + A | Select all |
| Escape | Deselect all |
| Tab | Select next object |
| Shift + Tab | Select previous object |
| Cmd/Ctrl + Click | Deep select (nested elements) |

---

## Object Manipulation

### Transform Controls

```
        ┌─────────────────────────────────┐
    ◯───┤                                 ├───◯  ← Rotation handle
        │                                 │
    ◻───┤         Selected Object         ├───◻  ← Resize handles
        │                                 │
    ◯───┤                                 ├───◯
        └─────────────────────────────────┘
              ◻                     ◻
```

```css
/* Resize handles */
.resize-handle {
  position: absolute;
  width: 8px;
  height: 8px;
  background: white;
  border: 1px solid #3b82f6;
  border-radius: 2px;
}

/* Corner handles - resize */
.resize-handle--nw { cursor: nwse-resize; top: -4px; left: -4px; }
.resize-handle--ne { cursor: nesw-resize; top: -4px; right: -4px; }
.resize-handle--sw { cursor: nesw-resize; bottom: -4px; left: -4px; }
.resize-handle--se { cursor: nwse-resize; bottom: -4px; right: -4px; }

/* Edge handles */
.resize-handle--n { cursor: ns-resize; top: -4px; left: 50%; }
.resize-handle--s { cursor: ns-resize; bottom: -4px; left: 50%; }
.resize-handle--e { cursor: ew-resize; right: -4px; top: 50%; }
.resize-handle--w { cursor: ew-resize; left: -4px; top: 50%; }

/* Rotation handle */
.rotate-handle {
  position: absolute;
  top: -30px;
  left: 50%;
  width: 10px;
  height: 10px;
  background: white;
  border: 1px solid #3b82f6;
  border-radius: 50%;
  cursor: grab;
}
```

### Drag and Drop

```javascript
function handleDrag(object, event) {
  // Show ghost/preview at cursor
  showDragPreview(object, event.x, event.y);

  // Check drop targets
  const dropTarget = findDropTarget(event.x, event.y);
  if (dropTarget) {
    highlightDropTarget(dropTarget);
  }
}

function handleDrop(object, event) {
  const dropTarget = findDropTarget(event.x, event.y);

  // Animate to final position
  animateTo(object, {
    x: snapToGrid(event.x),
    y: snapToGrid(event.y)
  }, { duration: 100 });

  hideDragPreview();
}
```

**Drag and Drop Guidelines:**
- Show visual feedback during drag (elevation, shadow)
- Animate other elements moving out of the way
- Use 100ms animation for drop
- Provide clear drop zone indicators
- Support keyboard alternatives (WCAG 2.5.7)

### Keyboard Movement

```javascript
const MOVE_STEP = 1;       // Arrow key
const MOVE_STEP_LARGE = 10; // Shift + Arrow

function handleArrowKey(key, shiftKey) {
  const step = shiftKey ? MOVE_STEP_LARGE : MOVE_STEP;

  selectedObjects.forEach(obj => {
    switch(key) {
      case 'ArrowUp':    obj.y -= step; break;
      case 'ArrowDown':  obj.y += step; break;
      case 'ArrowLeft':  obj.x -= step; break;
      case 'ArrowRight': obj.x += step; break;
    }
  });
}
```

---

## Key Metrics

| Metric | Value | Context |
|--------|-------|---------|
| Zoom range | 10% - 4000% | Typical design tools |
| Pan speed | 1:1 cursor ratio | Natural feeling |
| Touch target | 44×44px | Minimum for handles |
| Render target | 60fps | During pan/zoom |

---

## Anti-Patterns

1. **Fixed canvas size** - Limiting creativity with artificial boundaries
2. **Zoom at screen center** - Disorienting; zoom at cursor instead
3. **Sluggish pan/zoom** - Must feel instant and smooth
4. **Inconsistent shortcuts** - Differs from industry standard
5. **Poor touch support** - Gestures should match platform conventions

---

## Sources

- [Steve Ruiz - Creating a Zoom UI](https://www.steveruiz.me/posts/zoom-ui)
- [NN/g - Drag and Drop](https://www.nngroup.com/articles/drag-drop/)
- [Pencil & Paper - Drag & Drop UX Patterns](https://www.pencilandpaper.io/articles/ux-pattern-drag-and-drop)
- [Salesforce - 4 Patterns for Accessible Drag and Drop](https://medium.com/salesforce-ux/4-major-patterns-for-accessible-drag-and-drop-1d43f64ebf09)
rea-analysis-optimizationmorluto/reaOptimize REA providers and shared analysis workflows for agent context, latency, CPU, and memory while preserving correctness and Evidence. Use for analysis bottlenecks and cache or query design; CI/test-suite optimization belongs to rea-ci-tests-audit.Stars: 472kUpdated Claude CodeCodexVerifiedInstall
rea-ci-tests-auditmorluto/reaAudit REA CI and test suites for correctness, fixture drift, false passes, and measured performance; use for suite or workflow investigations and efficiency changes, rather than ordinary feature testing or a single test failure.Stars: 472kUpdated Claude CodeCodexVerifiedInstall
rea-tool-designmorluto/reaAudit, investigate, design, or change REA investigation tools, CLI/MCP contracts, provider capabilities, and Evidence semantics.Stars: 472kUpdated Claude CodeCodexVerifiedInstall
ponytail-auditDietrichGebert/ponytailQuality audit of the whole repo: bugs, security, real load, missing tests, speed, and what to delete. Most important first.Stars: 194kUpdated Claude CodeCodexVerifiedInstall