Stroke styles control the outline appearance of shapes and lines. Adjust stroke width, color, dash patterns, and line endings to create clear, professional diagrams.

Basic Stroke Properties

Stroke Color

The color of the shape's outline.

To change stroke color:

  1. Select a shape
  2. Open the Inspector panel
  3. Find the Stroke section
  4. Click the stroke color well
  5. Choose a color from the picker

Like fills, strokes can use solid colors or be linked to color schemes.

Stroke Width

Controls the thickness of the outline.

To adjust stroke width:

  1. In the Inspector's Stroke section
  2. Use the Width slider or input field
  3. Range typically from 0 (no stroke) to 20+ pixels
  4. Common values:
    • 1-2px: Fine outlines, detailed diagrams
    • 3-4px: Standard outlines, most diagrams
    • 5-8px: Bold outlines, emphasis
    • 10+px: Very bold, decorative or presentation use

Stroke Widths

No Stroke

Remove the stroke entirely:

  1. In the Stroke section
  2. Set width to 0 or click No Stroke
  3. The shape outline disappears

Useful for:

  • Filled shapes without borders
  • Seamless shape arrangements
  • Minimalist diagram styles

Dash Patterns

Create dashed or dotted lines instead of solid strokes.

Predefined Patterns

Diagrammix3 includes common dash patterns:

  • Solid - Continuous line (default)
  • Dashed - Regular dashes with gaps
  • Dotted - Small dots with gaps
  • Dash-Dot - Alternating dashes and dots
  • Long Dash - Longer dashes, wider gaps

To apply a dash pattern:

  1. Select a shape or connector
  2. In the Stroke section of the Inspector
  3. Click the Dash Pattern dropdown
  4. Choose a pattern

Dash Patterns

Custom Dash Patterns

For advanced control, create custom dash patterns:

  1. Select Custom from the dash pattern menu
  2. Enter dash and gap lengths (in pixels)
  3. Pattern format: [dash, gap, dash, gap, ...]
  4. Example: [10, 5, 2, 5] creates long dash, gap, dot, gap pattern

Use Cases for Dash Patterns

  • Dashed lines: Indicate optional or future elements, temporary connections, boundaries
  • Dotted lines: Show hidden or internal relationships, guides, less important connections
  • Dash-dot: UML dependencies, architectural boundaries, alternate flows
  • Solid lines: Standard, primary connections and shapes

Line Caps

Control how line ends are rendered (primarily for open paths and connectors).

Cap Styles

Butt Cap

  • Line ends exactly at the endpoint
  • Square, abrupt termination
  • Default for most diagrams

Round Cap

  • Line ends with a semicircular cap
  • Extends slightly beyond endpoint
  • Softer, friendlier appearance

Square Cap

  • Line ends with a square cap
  • Extends slightly beyond endpoint (half the stroke width)
  • Precise, architectural look

To change line caps:

  1. Select a connector or open path
  2. In the Stroke section
  3. Click the Line Cap dropdown
  4. Choose: Butt, Round, or Square

Line Cap Styles

Line Joins

Control how corners are rendered where two path segments meet.

Join Styles

Miter Join

  • Creates sharp, pointed corners
  • Default for most shapes
  • Best for: Rectangles, polygons, angular designs

Round Join

  • Creates rounded corners where segments meet
  • Softer appearance
  • Best for: Organic shapes, friendly diagrams

Bevel Join

  • Creates flattened corners
  • Cuts off the sharp point
  • Best for: Technical diagrams, when miter would be too sharp

To change line joins:

  1. Select a shape
  2. In the Stroke section
  3. Click the Line Join dropdown
  4. Choose: Miter, Round, or Bevel

Note: Line join is most visible at sharp angles with thick strokes.

Line Join Styles

Stroke Opacity

Make strokes semi-transparent:

  1. In the Stroke section
  2. Adjust the Opacity slider (0-100%)
  3. 0% = invisible stroke
  4. 100% = fully opaque

Independent stroke opacity allows:

  • Subtle outlines on bold fills
  • Ghosted shapes in background
  • Layered diagrams with overlapping elements

Color Schemes and Strokes

Link strokes to color schemes:

  1. In the Stroke section
  2. Click the Scheme dropdown
  3. Choose a color role (Border, Accent, etc.)
  4. Stroke updates when color scheme changes

This ensures consistent stroke colors across your diagram.

Combining Stroke Properties

Professional Combinations

Technical Diagram:

  • Width: 2px
  • Color: Dark gray or black
  • Pattern: Solid
  • Cap: Butt
  • Join: Miter

Presentation Diagram:

  • Width: 4px
  • Color: Brand color
  • Pattern: Solid
  • Cap: Round
  • Join: Round

Wireframe/Sketch:

  • Width: 3px
  • Color: Medium gray
  • Pattern: Dashed or dotted
  • Cap: Round
  • Join: Round

Emphasis Element:

  • Width: 6-8px
  • Color: Bright accent
  • Pattern: Solid
  • Cap: Round
  • Join: Round

Stroke and Fill Interaction

Strokes render on top of fills, sitting half inside and half outside the shape boundary.

Important implications:

  • Wide strokes obscure fill color near the edge
  • Transparent fills with strokes create outline-only shapes
  • No stroke makes fill extend to true boundary
  • Stroke width affects overall shape size slightly

Stroke Positioning

Tips

  1. Match stroke width to scale - Thinner strokes for detailed diagrams, thicker for presentations
  2. Use consistent stroke widths - Vary only for emphasis, not randomly
  3. Contrast with fill - Ensure stroke is visible against fill color
  4. Dash patterns for meaning - Use consistently (e.g., always dashed for "future state")
  5. Round caps for friendliness - Sharp caps for technical precision
  6. Test at final size - Strokes may look different at presentation size vs. editing size

Stroke Performance

  • Solid strokes render fastest
  • Complex dash patterns are slightly slower
  • Very wide strokes (15px+) can impact performance on diagrams with 100+ shapes
  • Line joins/caps have minimal performance impact

Accessibility

When choosing stroke styles:

  1. Ensure contrast - Stroke must be visible against both fill and background
  2. Don't rely on dash patterns alone - Combine with text labels or other cues
  3. Minimum 1px width - Thinner strokes may be invisible on some displays
  4. Test in grayscale - Ensure stroke contrast works without color