Skip to content

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

3 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Riksha FP

Local-first desktop tracker for equity compensation — RSUs and options vesting, tracked privately with no bank linking or cloud.

Status

🚧 Early development (Phase 1). Not yet packaged for distribution — run from source. Core vesting math, database schema, and a basic read-only dashboard are working; grant creation currently requires manual database seeding while the add-grant form is being built.

Why

Most personal finance trackers assume your assets live in a linked bank or brokerage account. Equity compensation often doesn't fit that model cleanly — vesting schedules, cliff dates, and current value require calculation, not just a balance to sync. Riksha FP tracks that calculation locally, with data entered and updated by hand, and never leaves your machine.

This is not a tax tool. It tracks vesting mechanics and current value only — no tax calculation, no tax advice. Consult a qualified tax professional for anything involving your actual tax liability.

Data storage

All data is stored in a local SQLite file on your machine — nothing is sent anywhere. Note that in the current phase, this file is not encrypted at rest; encryption is planned for a later phase. Keep that in mind if you're entering real financial data before then.

Roadmap

  • Phase 1 (current) — RSU tracking: grants, cliff/graded vesting calculation, vested/unvested dashboard
  • Phase 2 — Stock options: strike price, exercise economics, expiration tracking
  • Phase 3 — Multiple employers, encrypted storage, export/import, multi-currency support

Tech stack

  • Electron — desktop app shell (main/renderer/preload process split)
  • Vanilla HTML/CSS/JS for the renderer — no framework
  • better-sqlite3 — local SQLite storage
  • Chart.js — vesting and value charts
  • electron-builder — packaging

Running from source

git clone https://github.com/Gitriksha/riksha-fp.git
cd riksha-fp
npm install
npm start

Requires Node.js and, on Windows, Python 3.x plus the Visual Studio "Desktop development with C++" workload — both needed to compile the better-sqlite3 native module.

License

PolyForm Noncommercial License 1.0.0.

In plain terms: free to use, read, and modify for any noncommercial purpose. Not licensed for resale or use as or within a commercial product without separate permission.

About

Local-first desktop tracker for equity compensation — RSUs and options vesting, tracked privately with no bank linking or cloud.

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages