# Release milestone timeline

Build a release timeline with phase bars and milestone diamonds, then export a PowerPoint report and editable Excel data.

Project · C# walkthrough

Present the route from pilot preparation to service handover, with visible decision milestones and editable supporting data for the people reviewing the plan.

[Build this report](#example-code)[Download Project XML](/downloads/showcase/workflows/project-milestone-timeline/example.xml) [Try this file in your browser](/browser/hidden-characters/)

Opens the generated download in a local browser tool. The C# example below creates the document.

**Start with**

Release phases and decision milestones

**Generate**

XML + PNG + SVG + PDF + PPTX + XLSX

[!\[Release milestone timeline generated from the linked C# example\](/downloads/showcase/workflows/project-milestone-timeline/preview.webp)](/downloads/showcase/workflows/project-milestone-timeline/preview.png)

Calculated report · Generated by the example below

## How it works

1. ### Model phases and milestones
  
  Create three working phases and three zero-duration milestones, connected in delivery order.
2. ### Create the timeline snapshot
  
  Calculate dates against an explicit working-week calendar and select the Timeline view with daily time buckets.
3. ### Share charts and editable data
  
  Export PNG, SVG, and PDF, then create a PowerPoint report with a chart and data slides and an Excel workbook with typed report values.

## The C# source

The example below shows the document API and layout used for this report. Follow the Project guide for package setup in your own project.

```csharp
using OfficeIMO.Drawing;
using OfficeIMO.Project;
using OfficeIMO.Workflows;

namespace OfficeIMO.Examples.Showcase.Workflows;

/// <summary>Creates a release timeline and a PowerPoint report with charts and editable data.</summary>
internal static class ProjectMilestoneTimeline {
    internal static void Create(string folder) {
        using var project = ProjectDocument.Create();
        project.Name = "Autumn release / milestone timeline";
        project.Calendar = project.Calendars.AddStandardWorkingWeek();
        project.Settings.StartDate = new DateTime(2026, 10, 5, 8, 0, 0);
        string[] names = { "Prepare the pilot", "Pilot ready", "Run the pilot", "Pilot accepted", "Roll out the service", "Service handover" };
        var tasks = names.Select((name, index) => {
            var task = project.Tasks.Add(name);
            task.Duration = ProjectDuration.WorkingDays(index % 2 == 1 ? 0 : 3);
            return task;
        }).ToArray();
        for (int index = 1; index < tasks.Length; index++)
            project.Dependencies.Add(tasks[index - 1], tasks[index]);

        var schedule = project.CalculateSchedule();
        schedule.Report.ThrowIfErrors();
        var view = project.CreateView(schedule, new ProjectViewOptions {
            Kind = ProjectViewKind.Timeline, Timescale = ProjectViewTimescale.Day,
            PageWidth = 1200, PageHeight = 675,
            Columns = new[] { ProjectViewColumn.Name }
        });
        project.ApplySchedule(schedule);
        project.Save(Path.Combine(folder, "example.xml"));

        string fonts = Path.Combine(AppContext.BaseDirectory, "Assets", "Fonts");
        var faces = new OfficeFontFaceCollection()
            .Add("Arial", File.ReadAllBytes(Path.Combine(fonts, "Carlito-Regular.ttf")))
            .Add("Arial", File.ReadAllBytes(Path.Combine(fonts, "Carlito-Bold.ttf")), OfficeFontStyle.Bold);
        var typography = new OfficeRenderingProfile("timeline-report", faces, OfficeManagedTextShapingProvider.Instance);
        var images = new ProjectImageExportOptions().UseRenderingProfile(typography).UseQuality(OfficeImageExportQuality.Print);
        File.WriteAllBytes(Path.Combine(folder, "preview.png"), ProjectReportWorkflow.ToImages(view, options: images).Single().Bytes);
        File.WriteAllText(Path.Combine(folder, "preview.svg"), ProjectReportWorkflow.ToSvg(view, typography).Single());
        File.WriteAllBytes(Path.Combine(folder, "preview.pdf"), ProjectReportWorkflow.ToPdf(view, typography: typography));
        using var slides = ProjectReportWorkflow.CreatePowerPoint(view, new ProjectOfficeReportOptions { Images = images });
        slides.Save(Path.Combine(folder, "report.pptx"));
        using var workbook = ProjectReportWorkflow.CreateExcel(view);
        workbook.Save(Path.Combine(folder, "report.xlsx"));
    }
}
```

[Open the C# source file](/downloads/showcase/workflows/project-milestone-timeline/ProjectMilestoneTimeline.cs.txt)

## API used in this example

- [`ProjectReportWorkflow`](/api/workflows/officeimo-workflows-projectreportworkflow/)
- [`OfficeFontFaceCollection`](/api/core/officeimo-drawing-officefontfacecollection/)
- [`OfficeFontStyle`](/api/core/officeimo-drawing-officefontstyle/)
- [`OfficeImageExportQuality`](/api/core/officeimo-drawing-officeimageexportquality/)
- [`OfficeManagedTextShapingProvider`](/api/core/officeimo-drawing-officemanagedtextshapingprovider/)
- [`OfficeRenderingProfile`](/api/core/officeimo-drawing-officerenderingprofile/)
- [`ProjectDocument`](/api/project/officeimo-project-projectdocument/)
- [`ProjectDuration`](/api/project/officeimo-project-projectduration/)
- [`ProjectImageExportOptions`](/api/workflows/officeimo-workflows-projectimageexportoptions/)
- [`ProjectOfficeReportOptions`](/api/workflows/officeimo-workflows-projectofficereportoptions/)
- [`ProjectViewColumn`](/api/project/officeimo-project-projectviewcolumn/)
- [`ProjectViewKind`](/api/project/officeimo-project-projectviewkind/)
- [`ProjectViewOptions`](/api/project/officeimo-project-projectviewoptions/)
- [`ProjectViewTimescale`](/api/project/officeimo-project-projectviewtimescale/)

## Use this in your project

Change the working durations and decision labels, or select a weekly timescale for a longer release. Timeline images remain snapshots; update the underlying project and render again when plans change.

The [Project guide](/docs/project/) explains package setup and related document APIs.

## Documents and scope

### What the preview shows

The complete C# example generates these exports. The runner reopens and validates the Project XML and any Office documents, and verifies the PDF page count. The preview is the actual 300-DPI PNG export.

### What to keep in mind

Calculated report views do not reconstruct saved native Project view styles. Charts in Word and PowerPoint are images; accompanying data tables remain editable. PNG has a fixed pixel resolution; use SVG for vector zoom.

[Project API reference](/docs/project/#api-entry-points) · [Artifact hashes and provenance](/downloads/showcase/manifest.json)

## Continue with another example

- [Project**Delivery Gantt with progress**](/showcase/project-delivery-gantt/)
- [Project**Parallel dependency network**](/showcase/project-dependency-network/)

<!-- PowerForge markdown artifact sha256:4390B61332D129FA24BBE7F214EF949733AB68567E6064447146ABBAED809779 -->
