← Back

Draw Custom Lines

← Back to all docs

Draw Custom Lines

Learn how to add freehand lines for annotations, boundaries, and visual emphasis in your diagrams

basicsbeginner⏱️4 min
Home/Documentation/Draw Custom Lines

Learn how to add freehand lines for annotations, boundaries, and visual emphasis in your diagrams

✏️ Draw Custom Lines

Freehand lines allow you to draw custom shapes and annotations directly on your diagram canvas. Use them to highlight areas, create boundaries, add visual emphasis, or organize complex diagrams with clear visual separators.

What You'll Learn

What freehand lines are and when to use them

How to draw and position custom shapes

Customizing line and fill colors

Best practices for visual annotations

💡 Lines vs. Edges

Unlike edges (which connect nodes), freehand lines are purely visual elements for organization and annotation. They're perfect for grouping, highlighting, and adding context to your architecture.

Understanding Freehand Lines

What Are Freehand Lines?

Freehand lines are drawn shapes that serve as visual annotations on your diagrams. They help organize, emphasize, and add context without representing actual architectural connections.

Boundaries

Draw boxes around related components to show grouping

Highlights

Circle or underline important elements to draw attention

Separators

Create visual divisions between diagram sections

Annotations

Add arrows or pointers to emphasize specific areas

Regions

Define system boundaries or deployment zones

🎨 Visual-Only Elements

Freehand lines are visual-only elements. They don't create connections or relationships between nodes - they just help organize and annotate your diagram.

Real-World Use Cases

Use Case: **Microservice Boundaries**: Draw boxes around related microservices **Critical Path**: Highlight components in the critical request path **Legacy vs. New**: Circle legacy systems in one color, new systems in another **Deployment Zones**: Outline different cloud regions or environments **Future Work**: Mark areas planned for future implementation

What's the primary purpose of freehand lines?

To connect nodes and create relationships
To add visual annotations and organization
To store configuration data
To generate automatic documentation

Working with Lines

Drawing Freehand Lines

Creating a freehand line is simple and intuitive. Here's the step-by-step process:

•

Activate Drawing Mode

Click "Add line" in the side navigation

•

Start Drawing

Your cursor becomes a drawing tool - click and drag to draw

•

Shape Your Line

Move your cursor to create the desired shape

•

Complete the Line

Release the mouse button to finish

•

Position and Style

The line appears on your canvas, ready for customization

🖊️ Drawing Tips

Smooth curves: Draw slowly for smoother lines

Sharp angles: Draw quickly for more angular shapes

Closed shapes: Return to your starting point to create filled shapes

Open lines: Create arrows or underlines without closing the shape

Positioning and Selecting Lines

Once you've drawn a line, you can select it, move it, and adjust its position:

Select a Line

Click directly on any line - selected lines show handles at their endpoints

Move Lines

Select the line, then click and drag to reposition it anywhere on the canvas

Deselect

Click on empty canvas space to deselect the line

⚠️ Shape Limitation

Freehand lines maintain their drawn shape. To resize or reshape a line, you'll need to delete it and draw a new one.

Customizing Line Appearance

Make your lines visually distinctive by customizing their colors. When a line is selected, the control panel shows color options:

Fill Color

The interior color of closed shapes - great for highlighting regions with semi-transparent colors

Stroke Color

The outline/border color of the line - use bright colors for important annotations

🎨 Color Best Practices

Subtle backgrounds: Use light grays and pastels for grouping boxes

Vibrant highlights: Use red, orange, or bright yellow for critical areas

Contrast matters: Ensure colors contrast with nodes and edges

Semi-transparency: Keep opacity moderate so underlying content stays visible

What's the best approach for coloring boundary boxes?

Use bright, opaque colors to make them stand out
Use subtle, semi-transparent colors as backgrounds
Always use the default black color
Avoid using colors entirely

Quick Reference

Best Practices

✅ Line Best Practices

Use lines to group related components visually

Keep line colors subtle to avoid overwhelming the diagram

Draw boundaries around system contexts or deployment zones

Use arrows to indicate flow or importance

Combine with text nodes for clear annotations

Layer lines behind nodes when possible

Common Use Cases

Microservice Groups

Drawing boundaries around microservice groups or domains

Critical Path

Highlighting critical path components with colored boxes

Visual Separators

Creating visual separators between diagram sections

Legacy Markers

Annotating legacy vs. new system components

Deployment Zones

Indicating deployment zones or environments

Future Work

Marking areas for future implementation

Keyboard Shortcuts

Delete Line

Press Delete key to remove selected line

Undo Drawing

Press Cmd/Ctrl + Z to undo line drawing

UI Elements

"Add Line" Button

Side navigation (left sidebar) - Enables freehand line drawing mode

Fill Color Picker

Control panel (when line selected) - Changes the interior color of closed shapes

Stroke Color Picker

Control panel (when line selected) - Changes the outline color of the line

Next Steps

🎉 Tutorial Complete!

You've completed all ArkT tutorials! 🎊

✅ Create and connect nodes

✅ Build multi-level diagrams

✅ Use templates for consistency

✅ Add text annotations

✅ Link external resources

✅ Master virtual nodes

✅ Draw custom lines

You're now an ArkT master!

Ready to build amazing diagrams? Here are some recommended next steps:

💡 Pro Tips for Real-World Use

Combine techniques - The best diagrams use multiple features together (nodes + text + lines + integrations)

Start simple - Begin with basic node diagrams, then add complexity as needed

Save templates - Create templates of your common patterns for reuse

Share knowledge - Document your architecture decisions in your diagrams

4 of 10

Related Articles

Create Your First Node

Master the basics of node creation in ArkT diagrams

basicsbeginner
5 min

Edge Connections

Learn how to connect nodes with directional edges

basicsbeginner
7 min

Infinite Levels

Master multi-level diagrams and breadcrumb navigation

basicsbeginner
6 min

On This Page

IntroductionUnderstanding Freehand LinesWorking with LinesQuick ReferenceNext Steps