HPPM — High Priority Project Manager
Your work stays in plain markdown on your machine. HPPM is the desk you spread it on — drag cards on a board, stretch dates on a timeline, and notice what’s asking for you today.
Most project tools ask you to upload your life to someone else’s server, pay monthly to access your own notes, and sit through upsells while you try to finish a simple task. People end up juggling Jira, Asana, Notion, and half a dozen tabs — distracted, subscribed, and never quite in control of their data.
HPPM is not that.
It is a local-first project manager for people who want clarity without the noise. Your work lives in plain markdown files on your disk — readable, portable, yours. HPPM adds the views: kanban, timeline, analytics, audit trail, and a priority picker that helps you decide what actually matters today.
What it is not: a cloud service, a social network, an ad surface, or a subscription trap. No accounts, no telemetry, no “upgrade to Pro” pressure. Nothing leaves your machine unless you put it there.
Why we built it: project management should feel like a calm workspace, not a landlord. You should own your files, your history, and your focus — with tools that are deep enough to run real work, but honest enough to stay out of the way.
Who it is for: builders, operators, privacy-minded professionals, and anyone exhausted by SaaS sprawl — people who want one serious desk for their priorities, offline, auditable, and free of rent.
If the internet disappears tomorrow, your trackers are still on your drive. That is the whole idea.
HPPM reads numbered markdown tracker files (e.g. 01-area.md) on your disk. Metadata, audit history, and settings live under .hppm/ in each project folder. No account, no sync server, no vendor lock-in.
The Windows app ships as a single installer; you can also run from source for development. v0.26 adds a desktop launch splash, tracker moves from the task drawer, and more reliable priority/complete actions on all trackers.
- Download HPPM_v026.exe from the v0.26 release.
- Run the installer (default:
C:\Program Files\HPPM). - On first launch, pick a workspace folder or create a project from a template.
Installer is not code-signed yet — Windows SmartScreen may warn until a certificate is added.
npm install
npm run devOpens http://localhost:5173.
npm run build # production build → dist/
npm run preview # preview the buildDesktop packaging lives in the sibling hppm-desktop folder (npm run dist → HPPM_v026.exe).
Full user guide: docs/README.md
| Section | Topics |
|---|---|
| Getting started | Install · Splash & projects |
| Projects & data | Data model · .hppm folder · Preferences · Templates |
| UI chrome | Header · Filters · Search · Footer |
| Views | Overview · Table · Kanban · Timeline · Neural · Fruits |
| Tasks | Task drawer · Priorities, trackers & tags |
| Tools | Analytics · Audit trail |
| Reference | Themes · Languages · Tips |
See also CHANGELOG.md for version history.
Six top-level views, each with sub-modes where noted.
| View | Sub-modes | What it does |
|---|---|---|
| Overview | — | Open / done / overdue stats, priority & tracker bars, 7-day activity snapshot, link to analytics |
| Table | Sheet · List | Spreadsheet grid (default) or grouped list; sticky header on scroll; column visibility via gear; eye menu switches sub-view |
| Kanban | Priority · Trackers | Drag cards between columns; writes priority / tracker back to markdown |
| Timeline | Priority · Trackers · Calendar | Gantt lanes or month calendar; drag bars for start/due; week / month zoom |
| Neural | Tracker · Priority · Tags · Links · Free | Force-directed graph of tasks, links, and clusters; layout persists per project |
| Fruits | — | Ranked “what next” view by priority, impact, effort, and due dates; signature themes add a short intro animation |
Signature themes (Chrome, Militech, Void, Umbra, Majestic) add themed splash overlays and a staged intro animation on Fruits.
- Analytics modal — time-series of creates, completes, reopens, and moves; tracker breakdown; hover mini-tooltip per bucket (localized in all seven languages)
- Audit trail — period selector, action / tracker / priority / tag filters, search, export (JSON / CSV / TXT)
- Global filters — trackers, priorities, tags, impact, effort, text search; funnel badge counts active filters; persist across views; Kanban/Timeline hide unfiltered columns/lanes when tracker or priority filters are active
- Task drawer — inline edit title and description (markdown sync); colored tracker pill dropdown to move tasks; notes with save confirmation; start/due, links, impact/effort, tags; delete task; keyboard shortcuts when open; resizable panel
- Create & manage — new tasks, trackers, tags; recolor / rename tags; fixed priority levels with theme-aware colors
- Drag-and-drop — kanban columns, timeline bars, table reorder where supported
- Show completed — top-bar toggle for list views (Overview always shows both open and done)
- Keyboard shortcuts —
/focus search,1–6switch views,nnew task,?full cheat sheet (seven languages); Table/Fruits row browse with drawer open — see Keyboard & interaction
Blank plus 36 persona seeds — resort, warehouse, real estate, financial audit, construction, clinic, content studio, city services, fundraising, software sprint, legal, events, teacher, yacht charter, plumber, restaurant, photographer, graduate student, wedding planner, retail shop, nonprofit field, fitness coach, vet clinic, landlord, keynote speaker, streamer squad, influencer, shift worker, indie founder, account executive, family caregiver, film crew, musician, e-commerce solo, electrician, relocation. Task dates are relative to the project creation day.
Fourteen themes in the footer palette picker — city-inspired palettes plus five signature themes:
| Theme | Character |
|---|---|
| Default | Soft lavender light — the classic HPPM look |
| Default Dark | Same pastel accents on charcoal |
| Athens | Cream marble, Santorini sea blue |
| Moscow | Warm beige, burgundy, autumn wood |
| Shenzhen | Cool glass tech, crisp blue on steel |
| Tokyo | Night violet, cyber glow |
| Geneva | Clean white, alpine red |
| Paris | Cold steel night, wine accent |
| Abu Dhabi | Desert cream, oasis green & gold |
| Chrome | Mirror-finish light — blush, peach, pale gold |
| Militech | Tactical green terminal, amber readouts |
| Void | Pitch black — color as a soft ghost |
| Umbra | Moonlit dark — lavender and purple pastels |
| Majestic | Medieval light — gold, bronze, marble warmth |
UI chrome in English, Greek, Russian, Chinese, Japanese, French, and Arabic (RTL layout). Your task titles, tracker names, and tags stay exactly as you typed them.
Contextual tips in the footer marquee (toggleable per project). Short hints for filters, views, keyboard flows, and theme-specific behavior. Press ? for the full shortcut list.
| Layer | Location | Contents |
|---|---|---|
| Trackers | *.md in project root |
Priority sections, checkboxes, tags, dates, links — source of truth |
| Project store | <project>/.hppm/ |
Metadata, fingerprints, audit log, preferences (not committed) |
| Machine registry | .hppm-projects.json |
Local project paths (gitignored). Splash gear sets workspace; subfolders with .hppm auto-list |
Preferences in .hppm/preferences.json: theme, language, includeDone, tips marquee, active view, neural layout, kanban/timeline modes, filter bags.
This repository is the UI codebase only. Personal trackers, local project paths, and runtime stores are gitignored and stay on your machine.
HPPM is released under the Apache License 2.0. You may use, modify, and distribute the software in compliance with that license. Contributions are welcome — see CONTRIBUTING.md and CODE_OF_CONDUCT.md.
The HPPM name and branding remain trademarks of ARPA Hellenic Logical Systems; the Apache license does not grant trademark rights.
We welcome bug reports, documentation improvements, translations, and focused fixes — from humans and NHUIs (Non-Humanoid Intelligence Units) working under appropriate oversight.
- Read CONTRIBUTING.md
- Follow the Code of Conduct
- Open an issue or pull request on GitHub
Apache License 2.0 — © 2024–2026 ARPA Hellenic Logical Systems. See LICENSE for full terms.
hppm-ui/
├── docs/ User guide (start at docs/README.md)
├── src/ React app, themes, i18n, components
├── server/ Node API — read/write markdown, audit, analytics
├── shared/ Template catalog shared with server
├── src/assets/ Logos, theme splash SVGs, installer art, README screenshots
├── CONTRIBUTING.md How to report bugs and submit PRs
├── CODE_OF_CONDUCT.md Community standards
└── dist/ Production build output (npm run build)
Built & Maintained by ARPA Hellenic Logical Systems