PlantUML Gantt Chart Syntax Guide

What is a Gantt Chart?

A Gantt Chart is a staple project management timeline diagram that illustrates project schedules, task durations, start and end dates, critical path dependencies, and resource allocations. It provides a clear visual overview of project progress and task sequencing over time. With VPasCode, you can write concise PlantUML text scripts to build publication-ready Gantt Charts automatically. This eliminates manual timeline bar dragging and spreadsheet formatting while keeping project schedules versionable alongside code and documentation.

---

Core Syntax Guide: Elements and Constructs

Building a Gantt Chart in VPasCode uses task statements, duration definitions, and timeline anchors wrapped inside standard @startgantt and @endgantt block boundaries.

1. Defining Project Dates and Tasks

Set a project start date using Project starts YYYY-MM-DD. Define tasks by specifying their name and duration in days or weeks:

2. Modeling Task Dependencies

Connect tasks sequentially to show prerequisites using the starts at [Task]'s end dependency statement:

Pro Tip: You can also use shorthand arrows (e.g., [Task A] -> [Task B]) to declare sequential dependencies quickly.

3. Adding Milestones and Resource Allocations

Mark critical project checkpoints using the happens at milestone syntax, and assign team members or resources to specific tasks using on {Resource}:

4. Customizing Task Colors and Closed Days

Highlight critical path items with custom task colors and specify unworked weekend days or holidays:

---

Best Practices for Clean Layouts

• Set Explicit Project Start Dates: Always define Project starts YYYY-MM-DD to anchor timeline dates accurately.
• Group Tasks into Phases: Separate major phases using milestone checkpoints (happens at) or colored task bars.
• Define Non-Working Days: Declare closed weekends or holidays at the top of your script so durations automatically account for workdays.

---

Real-World PlantUML Gantt Chart Examples

Copy and paste these blueprints directly into your VPasCode editor panel to see them render in real time.

Example 1: Software Product Release Timeline

This blueprint models a multi-phase software development schedule from initial discovery through design, development, testing, and production release.

Syntax Breakdown: Demonstrates a clear sequential dependency chain where each project phase automatically anchors to the end date of its prerequisite task.