@vineus/payslip-overview
v0.3.1
Published
Upload payslip PDFs and get salary analytics dashboard
Readme
payslip-overview
Personal salary analytics dashboard — upload French payslip PDFs and get interactive charts and stats.
Quick Start
npx @vineus/payslip-overviewThis starts a local web server and opens the dashboard in your browser. Upload your payslip PDFs and explore your salary data.
Supported Formats
- Payfit — detected by "BULLETIN DE PAIE" header
- Silae / Deel — detected by "BULLETIN DE SALAIRE" header
Features
- Upload multiple payslip PDFs at once
- Automatic format detection (Payfit vs Silae)
- Salary evolution chart over time
- Monthly breakdown (gross, net, employer cost)
- Salary composition breakdown
- Leave/vacation tracking
- Local-only — all data stays on your machine (
~/.payslip-overview/data.db) - Re-uploading the same month replaces the existing data
Development
git clone https://github.com/vineus/payslip_overview.git
cd payslip_overview
npm install
npm run devOpen http://localhost:3000.
Commands
| Command | Description |
|---------|-------------|
| npm run dev | Start dev server (port 3000) |
| npm run build | Production build |
| npm run start | Run via CLI (opens browser) |
| npm run lint | ESLint |
| npm run test:parse | Test PDF parsing |
Tech Stack
- Next.js 16 (App Router, React 19)
- sql.js (SQLite in WASM, no external DB)
- Recharts for charts
- Tailwind CSS v4
- pdf-parse for PDF text extraction
License
MIT
