Diagrams

A native macOS diagramming app built with Swift/SwiftUI. Create flowcharts, architecture diagrams, and visual documentation with drag-and-drop shapes, orthogonal connectors, and an intuitive property inspector.

Features

Canvas

• Infinite pan (trackpad scroll) and zoom (pinch, Cmd+scroll, toolbar buttons)
• Auto-tiling grid with major/minor lines and grid snapping

Shapes

• 12 shape types: Rectangle, Rounded Rect, Ellipse, Diamond, Triangle, Hexagon, Parallelogram, Star, Cylinder, Cloud, Document, Block Arrow
• Drag-and-drop from the sidebar palette onto the canvas
• Click to select, Shift+click for multi-select, drag to move
• 8-handle resize, double-click to edit text inline
• 16 fill colors and 16 stroke colors with adjustable stroke width

Connectors

• Hover a shape to reveal connection ports, drag to another shape to connect
• Smart snap targeting with visual feedback on the nearest port
• Orthogonal (right-angle) routing with automatic path computation
• Drag segment handles to reshape paths while maintaining 90-degree angles
• Arrow heads on either or both ends (None, Arrow, Filled, Diamond, Circle)
• Flip direction or toggle bidirectional arrows
• Double-click to add a text label

File Management

• Create, rename, duplicate, and delete diagram files
• Organize into folders
• Auto-save with manual save option
• Persistent storage in ~/Library/Application Support/Diagrams/

Export

• Screenshot button captures the diagram to clipboard, cropped to content with 10px padding

Keyboard Shortcuts

• Cmd +/- — Zoom canvas
• Delete — Remove selected items
• Cmd Z / Cmd Shift Z — Undo / Redo

Build

Requires macOS 14+ and Swift 5.9+.

make build    # Release build, install to /Applications, launch
make run      # Debug build and run locally
make clean    # Remove build artifacts