Clarity, from plan to progress.
Visual identity · Brand preview
An offline desktop project planner with spreadsheet-style task editing, linked Gantt charts, resources, baselines, multiple timelines, PDF export, local recovery and optional AI/MCP connections.
Status: version 0.3.12: Windows and macOS (Apple Silicon) preview; every release now ships both platforms. macOS is not yet qualified; see macOS qualification. Android and iOS apps are planned after the macOS app is completed and validated. The delivery order is Windows → macOS → Android and iOS; mobile development has not started. This is not full Microsoft Project feature or file-format parity. Versions 0.3.0, 0.3.1 and 0.3.3 passed automated and native Windows stress checks on this machine. The public MPP regression corpus passes all 88 stages since 0.3.11; full compatibility is not qualified.
0.3.12 lets Claude Code work on the open project with your Claude subscription, with every change approved in Planora, and is the first release built for Windows and macOS together. Download for Windows and macOS · Release notes.
0.3.11 is the first macOS preview: Planora.app with the macOS menu bar, Finder document opening, Keychain-stored secrets and the system font, plus fixes for all ten documented public MPP corpus failures (also on Windows). Download the macOS preview · Release notes.
0.3.10 adds one-click Hide timelines / Show timelines above the Gantt and table. Download the Windows preview · Release notes.
0.3.9 adds the Microsoft Project Entry column preset, colored command icons and coordinated dropdown styling. Release notes.
0.3.8 introduces the modern Planora identity and Apple/Office hybrid ribbon and Gantt styling. Release notes.
0.3.7 modernizes timeline controls and adds Fit panel to reclaim Gantt space without changing chart dates. Release notes.
0.3.6 redesigns the ribbon into clear command groups and adds a Planning tab for Gantt, timeline, scheduling and presentation controls. Click Show ribbon to use it. Release notes.
0.3.5 keeps inspector dates and Apply/Cancel visible while fields scroll, and adds adjacent validation errors for typed task values. Release notes.
0.3.4 fixes unnecessary whole-project refresh after Resource Sheet edits. See bugfix notes for the tested scope and remaining investigation.
Compact workspace navigation, an editable task inspector, saved workspace views and a searchable library of ten original schedule starters. Release history and changes. Version 0.3.3 adds an Apple-inspired Gantt-first workspace, row density, planning focus and a resizable grouped inspector. The broader selection/editing acceptance criteria remain open. Next: UI-first release plan and interactive design concept. The concept is not the released desktop UI.
Install the .NET 10 SDK. From the repository root:
dotnet build project-app/ProjectDesk/ProjectDesk.csproj -c Release -p:TargetFrameworks=net10.0 -p:TargetFramework=net10.0 --configfile NuGet.Config
dotnet project-app/ProjectDesk/bin/Release/net10.0/Planora.dllWindows self-contained build (PowerShell):
./scripts/build.ps1 -Runtime win-x64On a Mac, pwsh ./scripts/build.ps1 -Runtime osx-arm64 produces a self-contained Planora.app (icon, .planora/.mpp document types, notices in Contents/Resources). It is unsigned; build it on macOS so the executable bit is kept. See macOS qualification for what has been verified. Python is not required.
./scripts/validate.ps1The default checks use generated local data: durable history, core authoring/save/reopen and automatic scheduling. -IncludeUi adds the headless release-gate UI checks (recovery, close flow, workspace, templates, resource sheet, timelines, icons). -IncludeExtended adds the AI, MCP connector and Claude Code control checks (local fixtures, no live provider calls) and the PDF, multi-timeline, theme, formatting, auto-date, visual-review and spreadsheet smoke checks against a generated project. -IncludePerformance pastes 500/2,000/5,000-task plans and reports paste, window, edit, reschedule, undo, save and reopen timings in perf-test/results.json; it has no timing budgets yet. Logs go to a fresh artifacts/validation/ directory. No paid AI requests or Microsoft Project automation are needed.
Check the public MPP corpus against the documented baseline:
./scripts/verify-mpp-regressions.ps1 -Assembly project-app/ProjectDesk/bin/Release/net10.0/Planora.dll -Output artifacts/validation/public-mppGitHub CI runs the model checks and the MPP gate on Windows, macOS and Linux, and the UI and extended checks on Windows and macOS.
On macOS, install the .NET 10 SDK and PowerShell 7, then run the same scripts with pwsh, for example pwsh ./scripts/validate.ps1 -IncludeUi -IncludeExtended.
- Start Planora and choose File → New; set the project name/start date.
- Type
Designin the blank task row and enter2din Duration. - Add
Build, set automatic scheduling and duration3d, then enter1FSin Predecessors. - Add a resource through Resource, assign it, and review the calculated dates.
- Use File → Save a Copy with a new
.planorafilename to retain timelines/formatting, or.mppfor interchange. - Use File → Export PDF for task table + Gantt, Gantt only, or timelines.
Read the full user guide for editing, columns, resources, dates, themes, recovery, AI/MCP and troubleshooting.
Type a task name in the blank row; Enter/Tab commits and Esc cancels. Use predecessor expressions such as 1FS+2d. Add/hide columns through View. Timelines have independent date limits, zoom and colors. Save a new .mpp copy for interchange or a .planora copy for project history, formatting and timelines. Existing destinations and original files are protected.
Recovery checks every 15 seconds during normal use. File → Recovery opens retained checkpoints; the last few seconds before a crash may not have been saved. Keep saving project copies normally. Recovery guide.
AI/MCP are optional. To work with Claude on the open project using your Claude subscription, choose Connectors → Claude Code…: Claude Code reads the project and proposes changes, and Planora applies each one only after you approve it. Credentials belong in platform credential storage, never in the repository or project packages. Provider fixture tests do not qualify real sign-in/inference, and subscriptions do not automatically include API usage.
See examples/ for 14 public MPP fixtures, 4 producer XML references, provenance/license/checksums and official Microsoft gallery links. No private projects are included. The complete Microsoft File → New gallery is not bundled.
Verify with ./scripts/verify-public-examples.ps1 before using checked-in fixtures.
project-app/ProjectDesk/: app source; legacy folder/namespace retained to preserve build and test paths.project-app/vendor/OfficeIMO/: required library source subset, including licenses and embedded resources.scripts/: build and validation entry points.docs/: architecture, roadmap, platform guidance and source inventory..github/: CI and contribution templates.
flowchart LR
UI[Avalonia desktop UI] --> Session[ProjectSession and commands]
Session --> Model[OfficeIMO project model and scheduling]
UI --> Persistence[Portable files and recovery]
UI --> Adapters[AI / MCP / platform credentials and processes]
The current UI/application/platform boundaries are not fully separated. Architecture distinguishes current design from the planned refactor.
Windows is the current focus. Complete and validate macOS next, then develop Android and iOS apps. Mobile requires a touch-friendly phone/tablet UI and platform-specific qualification; desktop binaries are not mobile apps. See the mobile development plan. No mobile release date or framework has been selected.
Read CONTRIBUTING, AGENTS, open tasks, and security guidance. Do not submit private project files or credentials.
Planora code is MIT licensed. Vendored code retains its own notices and terms; see third-party notices. Planora is not affiliated with Microsoft, Apple, monday.com, OpenAI or Anthropic.
Functionality and GUI improvement backlog · Release preparation and validation limits · Changelog
Upload this folder's contents as the repository root. Prefer Git or GitHub Desktop for the full source tree. Uploading the ZIP as a single GitHub file does not unpack it into a repository.
With Git installed, from this folder:
git init -b main
git add .
git commit -m "Initial Planora source"Then create an empty repository in your GitHub account and follow its instructions to add the remote and push. No remote URL or account is preconfigured. Do not include build outputs or private projects. See release preparation before enabling public access.