Indicative tax simulations for the Italian Partita IVA (sole proprietorship)
Italiano · English
EasyPIVA is an open-source web app for indicative tax simulations for the Italian Partita IVA (sole proprietorship). It combines flat-rate regime (regime forfettario) calculations, INPS contributions, a comparison with the ordinary regime, revenue planning, and quote generation with PDF export.
Independent project: it is not affiliated with INPS, the Agenzia delle Entrate, or other public bodies.
The results are indicative estimates and do not constitute tax, legal, or accounting advice. For professional decisions, consult a qualified advisor.
EasyPIVA requires no installation: open easypiva.vercel.app in a modern browser. No account, application backend, or server-side configuration is required.
To run a local copy of the app, see Development.
- Open EasyPIVA.
- Open the flat-rate regime calculator and enter revenue, the ATECO coefficient, and the INPS scheme.
- Read the estimated net income and compare the result with the ordinary regime.
- Fill in a quote, save it in the browser, or export it as a PDF.
- 2026 flat-rate regime (regime forfettario) calculation.
- Indicative comparison between the flat-rate regime and the ordinary regime.
- INPS contribution simulation for Gestione Separata, Artigiani, and Commercianti.
- Reverse calculation of the revenue needed to reach a target net income.
- Monthly revenue planning against the regime thresholds.
- Local quote with A4 preview, browser autosave, and PDF export.
- thresholds, rates, and coefficients are centralized in
src/lib/fiscal-data.ts; - tax logic is isolated in pure functions under
src/lib/calculations/; - the forfettario regime and IRPEF reference the 2026 TUIR (Legislative Decree 117/2026, articles 11, 13, 232-243 and Annex D), VAT references the 2026 VAT Code (Legislative Decree 10/2026), and social security values reference INPS Circulars 8/2026 and 14/2026;
- assumptions and legal sources are documented in the fiscal ADR and the public information page;
- unit, UI, and end-to-end tests protect the main regression cases;
- every fiscal change requires coordinated updates to code, tests, documentation, and public copy.
- A modern browser with JavaScript enabled, in an up-to-date version of Chrome, Edge, or Firefox.
- The published app requires no account, application backend, or environment variables.
- For development: Node.js 24 LTS and npm 11.
EasyPIVA exposes no server-side settings. The preferences saved in the browser are:
| Setting | Purpose | Default |
|---|---|---|
| Theme | Toggles the light and dark interface and keeps the choice | System theme |
| Disclaimer consent | Stores the acceptance of the disclaimer notice | Not stored |
| Quote draft | Autosaves the quote being edited in the browser | No draft |
| Quote logo | Embeds a PNG, JPEG, or WebP logo up to 1 MB | No logo |
Preferences are stored only in the browser's localStorage. The app does not send entered values to a server and does not use accounts or telemetry.
The project follows a local-first architecture: values entered in the simulators and in the quote are not sent to a server. Theme, disclaimer consent, and quote draft may be stored in the browser's localStorage; details are in Privacy and local storage.
All calculations run locally in the browser and the 2026 fiscal assumptions are centralized and tested. The repository uses CI with minimal permissions, GitHub Actions pinned to commit SHAs, and Dependency Review on pull requests that change dependencies. To report a vulnerability privately, follow SECURITY.md; do not open a public issue.
EasyPIVA produces indicative estimates based on the 2026 fiscal assumptions documented in the fiscal ADR and the public information page, with thresholds, rates, and coefficients centralized in src/lib/fiscal-data.ts. A professional can apply deductions, reliefs, or personal situations (other income, benefits, advance payments) that the simulator does not know about. If the values diverge, compare the inputs with the published assumptions and, for professional decisions, always rely on a qualified advisor.
The app simulates three schemes: Gestione Separata, Artigiani, and Commercianti, with the 2026 values (INPS Circular 8/2026 for Gestione Separata, 14/2026 for Artigiani and Commercianti). For Artigiani and Commercianti the annual ceiling depends on the contribution seniority at 1995-12-31: 93,707 EUR for those already registered, 122,295 EUR for the others. The correct scheme depends on your activity and on registration with the Chamber of Commerce or a professional register: when in doubt, verify your position with INPS or an advisor.
The export happens entirely in the browser (jsPDF with rendering through html2canvas): make sure you are using an up-to-date version of Chrome, Edge, or Firefox, that downloads are not blocked for the site, and that there is enough space for the file. If you uploaded a custom logo, try a lighter file (a small PNG or JPEG). If the problem persists, reload the page — the quote draft is autosaved in localStorage — and retry; for reproducible reports, open an issue following CONTRIBUTING.md.
Requires Node.js 24 LTS and npm 11; npm is the canonical package manager, and .nvmrc and package.json are the sources of truth for the versions.
git clone https://github.com/TheStreamCode/easypiva.git
cd easypiva
npm ci
npm run devThe app is served at http://127.0.0.1:3000.
npm run ci
npm auditnpm run ci runs formatting, typecheck, lint, Vitest tests, the production build, and Playwright tests. If Chromium is not installed yet, run npx playwright install chromium once. The available scripts are documented in package.json; the main ones are dev, dev:e2e, typecheck, lint, test, test:e2e, build, and ci.
Stack: React 19, React Router 8, TypeScript 6, and Vite 6; Tailwind CSS v4 and shadcn/ui components; Zustand, React Hook Form, and Zod; Recharts, motion, and jsPDF; Vitest with jsdom and Playwright with Chromium.
The static build produced in dist/ is published to Vercel from the main branch. vercel.json handles client-side routing and the HTTP security headers; the project uses no application backend and no runtime environment variables.
Repository documentation:
- Architecture
- Privacy and local storage
- Fiscal assumptions
- Assumption versioning
- Repository governance
- Asset provenance
- Changelog
- Reproducible reports and accessibility or privacy problems: GitHub issues using the bug report form.
- Reports about the fiscal assumptions: issues with verifiable primary sources.
- Vulnerabilities: SECURITY.md, never a public issue.
- Operational contacts: info@mikesoft.it.
- The repository does not provide tax advice, personalized assistance, or operational support.
The repository is public under the MIT license, but maintenance follows a maintainers-only workflow: read CONTRIBUTING.md and the Code of Conduct before opening a report. External pull requests are not part of the official maintenance process.
This project is distributed under the MIT License.
Maintained by Michael Gasperini (Mikesoft). If this project is useful to you, consider sponsoring its maintenance.
