Plan on paper. Track digitally.
Penpath is a hybrid productivity system that bridges analog and digital planning. You write your weekly tasks by hand on a printable flowboard, scan the paper with the app, and everything syncs automatically — complete with progress tracking, statistics, and a gamified badge system.
Most planners force a choice: the tactile focus of pen and paper, or the power of digital tracking. Penpath eliminates that tradeoff. Planning stays analog. Data and analytics live digitally.
- Print your weekly flowboard — a clean A4 landscape layout designed for handwriting.
- Plan your week on paper, the way humans think best.
- Scan the completed sheet with the Penpath app.
- Track completion rates, productivity trends, and earn progression badges — no manual re-entry.
The flowboard is a single A4 landscape page (design/flowboard.tex). Print it, fill it in by hand, scan it at the end of the week.
Header
- Focus of the Week
- Date range
- Prize of the Week — a small reward you set for yourself upfront
Core Tasks — 7 rows
| Column | Purpose |
|---|---|
| Main Goal | The task or goal for the week |
| Why? | Your reason — keeps motivation visible |
| Est. Time | How long you expect it to take |
| Tracker [Free Yourself] | A row of circles to fill in as you make progress |
| Notes | Observations, blockers, or context |
Side Quests — 5 rows
Same structure as Core Tasks, for side activities and lower-priority work. First column is labelled Side Activity.
Rates
Three metrics calculated by hand at the end of the week:
- Core Rate — completed core circles / total core circles × 100
- Side Rate — completed side circles / total side circles × 100
- Weekly Score —
0.7 × Core Rate + 0.3 × Side Rate
FLAME + Fulfillment Review
A 6-question self-rating section, each scored 1–5, completed at the end of the week:
| Dimension | Question | |
|---|---|---|
| F | Focus | How present and focused were you while working? |
| L | Leverage | Did you spend time on the highest-impact things? |
| A | Alignment | Did your actions align with who you want to become? |
| M | Momentum | How much did you stay ahead and keep moving forward? |
| E | Energy | How energized and physically sustainable did you feel? |
| + | Fulfillment | How fulfilled and satisfied did you feel about yourself? |
Reflection
Free-form lines to write what happened, what to carry forward, and what to change next week.
A gamified progression system built on three dimensions: Momentum (weekly streak), Mastery (monthly cycles), and Resilience (recovery after failure).
A week is a win when Weekly Score ≥ 80%. Only winning weeks advance the streak.
Four consecutive wins unlock four crystal badges in order:
| Badge | Name | Color | Symbolism |
|---|---|---|---|
 |
The Seed of Beginning | Turquoise-blue | New beginnings, initiation of discipline |
 |
The Flame of Focus | Golden-orange | Growing intensity and momentum |
 |
The Garden of Growth | Emerald-green | Structured development, flourishing habits |
 |
The Gem of Balance | Lavender-purple | Harmony and sustainable discipline |
| Badge | Name | Awarded when |
|---|---|---|
 |
The Crown of Consistency | 4 consecutive winning weeks completed |
After earning the Crown the cycle restarts at a higher tier — Seed I → Crown I, then Seed II → Crown II, and so on — enabling infinite long-term progression.
| Badge | Name | Awarded when |
|---|---|---|
 |
The Phoenix of Return | A failed week is immediately followed by a winning week |
The Phoenix is recorded permanently but does not restore the broken streak or count toward progression.
| Event | Effect |
|---|---|
| Weekly Score ≥ 80% | Win — advances streak (Week 1 → 2 → 3 → 4) |
| 4 consecutive wins | Crown awarded; cycle restarts at next tier |
| Weekly Score < 80% | Streak resets to zero; cycle restarts from Week 1 |
| Failure → Win | Phoenix of Return awarded; streak begins fresh from Week 1 |
| Any earned badge | Permanently unlocked — failures never remove past badges |
| Layer | Technology |
|---|---|
| Frontend | Vue.js + Capacitor (PWA as starting point) |
| Backend | Django + Django REST Framework |
| OCR | Google Cloud Vision API |
| Async queue | Celery + Redis |
| Database | PostgreSQL |
| DevOps | Docker + Docker Compose |
┌─────────────┐ ┌─────────────┐ ┌─────────────┐ ┌─────────────┐
│ Print │ -→ │ Scan │ -→ │ Data │ -→ │ Analytics │
│ Layer │ │ Layer │ │ Layer │ │ Layer │
│ (PDF) │ │ (OCR/ML) │ │ (Storage) │ │ (Dashboard)│
└─────────────┘ └─────────────┘ └─────────────┘ └─────────────┘
cp .env.example .env
docker compose up -d- Backend API: http://localhost:8000
- Frontend: http://localhost:5173
To generate the flowboard PDF, open design/flowboard.tex in Overleaf and compile.
- Project structure & Docker setup
- Printable weekly flowboard (LaTeX)
- Badge system design (Momentum · Mastery · Resilience)
- Scan & OCR pipeline
- Digital planner sync
- Analytics dashboard
MIT