PHPackages                             crmleaf/savings-calculator - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. crmleaf/savings-calculator

ActiveLibrary

crmleaf/savings-calculator
==========================

Estimate annual savings against another payroll provider, per employee.

v1.0.0(today)00[1 PRs](https://github.com/CrmLeaf/savings-calculator/pulls)MITPHPPHP ^8.2CI passing

Since Aug 14Pushed todayCompare

[ Source](https://github.com/CrmLeaf/savings-calculator)[ Packagist](https://packagist.org/packages/crmleaf/savings-calculator)[ Docs](https://www.indpayroll.com/free-tools/savings-calculator)[ RSS](/packages/crmleaf-savings-calculator/feed)WikiDiscussions main Synced today

READMEChangelogDependencies (5)Versions (3)Used By (0)

Payroll Savings Calculator
==========================

[](#payroll-savings-calculator)

Estimate annual savings against another payroll provider, per employee.

Compares what you pay now with what you would pay instead, over the contract you would actually sign, with the migration cost counted rather than waved away.

One of the [CRMLeaf payroll tools](https://github.com/crmleaf). The arithmetic and the dated statutory rate tables live in [`crmleaf/payroll-core`](https://github.com/crmleaf/payroll-core); this package is the thin skin that makes one calculator installable, mountable and embeddable on its own.

Note

A wrong figure or an out-of-date rate is almost always a [`payroll-core`](https://github.com/crmleaf/payroll-core/issues) matter, since that is where the tables live. Anything about this tool's routes, views or browser asset belongs here.

Install
-------

[](#install)

**Composer** - Laravel auto-discovers the service provider, so this is the whole setup:

```
composer require crmleaf/savings-calculator
```

**npm** - the same calculation, re-exported from `@crmleaf/payroll-js` so you can install this one tool and nothing else:

```
npm install @crmleaf/savings-calculator
```

Note

Not on npm yet. The script-tag route below needs no registry and works today. Installing this package straight from git will not resolve `@crmleaf/payroll-js`, which is not published yet either.

**A plain script tag** - no build step, no bundler, no server. Build the browser bundle once and serve the file yourself:

```

const result = CrmleafPayroll.savings({
  employeeCount: 250,
  currentPerEmployeePerMonth: 120,
  proposedPerEmployeePerMonth: 75,
  currentAnnualPlatformFee: 60000,
});
console.log(result.explain);

```

`payroll.min.js` is the single-file browser build. Get it by running `npm run build` in [`@crmleaf/payroll-js`](https://github.com/crmleaf/payroll-js) and copying `dist/payroll.min.js`into whatever your site serves as static assets.

> A hosted CDN build is coming soon, which will reduce this to a single URL. Serving the file yourself works today and keeps working afterwards - it is the only option that needs no third-party request, so plenty of projects will want to stay on it.

### See it working first

[](#see-it-working-first)

`demo/index.html` in this repository is a working copy of Payroll Savings Calculator in one file: the form, the calculation and the working, with no build step and no server. Drop `payroll.min.js` beside it and open it from disk.

```
cp /path/to/payroll-js/dist/payroll.min.js demo/
open demo/index.html
```

Nothing on that page reaches the network, which is the point: it is a calculator people paste salary figures into.

Use it
------

[](#use-it)

**Plain PHP**, no framework and no container:

```
use Crmleaf\Payroll\Calculators\SavingsCalculator;
use Crmleaf\Payroll\Money;

$result = (new SavingsCalculator())->calculate(
    employeeCount: 250,
    currentPerEmployeePerMonth: Money::fromRupees(120),
    proposedPerEmployeePerMonth: Money::fromRupees(75),
    currentAnnualPlatformFee: Money::fromRupees(60_000),
);

echo $result->explain();      // the formula with the real operands in it
echo $result->workings();     // every step, one per line, with its citation
print_r($result->toArray());  // snake_case, ready for JSON
```

**Laravel** - resolve it from the container, or type-hint it anywhere:

```
use Crmleaf\Payroll\Calculators\SavingsCalculator;

public function show(SavingsCalculator $calculator)
{
    return $calculator->calculate(
        employeeCount: 250,
        currentPerEmployeePerMonth: Money::fromRupees(120),
        proposedPerEmployeePerMonth: Money::fromRupees(75),
        currentAnnualPlatformFee: Money::fromRupees(60_000),
    )->toArray();
}
```

**Blade** - one component, no controller:

```

```

**HTTP** - off by default. Publish the config and turn the route on:

```
php artisan vendor:publish --tag=savings-calculator-config
```

```
// config/savings-calculator.php
'route' => ['enabled' => true, 'prefix' => 'tools'],
```

```
curl -X POST https://example.test/tools/savings-calculator \
  -H 'Content-Type: application/json' \
  -H 'Accept: application/json' \
  -d '{"employee_count":250,"current_per_employee_per_month":120,"proposed_per_employee_per_month":75,"current_annual_platform_fee":60000}'
```

The JSON response carries the figures, the working and the statutory citations:

```
{
  "tool": "savings-calculator",
  "data": { "…": "every figure, snake_case, with a *_formatted twin" },
  "explain": "the formula with the real operands substituted",
  "working": [{ "label": "…", "amount": 0, "formula": "…", "citation": "…" }],
  "citations": ["…"]
}
```

**JavaScript**:

```
import { savings } from '@crmleaf/savings-calculator';

const result = savings({
  employeeCount: 250,
  currentPerEmployeePerMonth: 120,
  proposedPerEmployeePerMonth: 75,
  currentAnnualPlatformFee: 60000,
});
```

No server needed
----------------

[](#no-server-needed)

The maths here is arithmetic over versioned rate tables, so it runs anywhere. The published asset binds the markup and computes in the browser:

```
php artisan vendor:publish --tag=savings-calculator-assets
```

```

   …

```

If the browser build is absent the script does nothing and the form posts to the server instead, so the page works either way.

Inputs
------

[](#inputs)

FieldTypeRequiredDefaultNotes`employee_count`integerYes`250``current_per_employee_per_month`money (₹)Yes`120``proposed_per_employee_per_month`money (₹)Yes`75``current_annual_platform_fee`money (₹)No`60000``proposed_annual_platform_fee`money (₹)No`0``migration_cost`money (₹)No`50000``contract_months`integerNo`12`Optional fields you leave out are omitted from the call entirely, so the calculator's own documented defaults apply.

What the model assumes
----------------------

[](#what-the-model-assumes)

Not a statutory calculation. It compares two per-employee-per-month prices over a contract term, including platform fees and the one-off cost of migrating, so the answer is a total cost of ownership rather than a headline rate.

Rates are data, not code: they live in dated tables with a cited source in `crmleaf/payroll-core`, so a rate change is a new dated entry rather than an edit to a constant.

Important

This package implements our reading of the applicable statutes and is provided without warranty. It is a calculation library, not tax advice. Verify against your own compliance obligations before relying on the output for statutory filing.

Publishing
----------

[](#publishing)

TagPublishes`savings-calculator-config``config/savings-calculator.php``savings-calculator-views``resources/views/vendor/savings-calculator``savings-calculator-assets``public/vendor/savings-calculator`Licence
-------

[](#licence)

[MIT](LICENSE) © CRMLeaf. Use it commercially, embed it, fork it.

###  Health Score

40

—

FairBetter than 86% of packages

Maintenance100

Actively maintained with recent releases

Popularity0

Limited adoption so far

Community6

Small or concentrated contributor base

Maturity47

Maturing project, gaining track record

 Bus Factor1

Top contributor holds 100% of commits — single point of failure

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

###  Release Activity

Cadence

Unknown

Total

1

Last Release

0d ago

### Community

Maintainers

![](https://avatars.githubusercontent.com/u/315788704?v=4)[crmleaf](/maintainers/crmleaf)[@CrmLeaf](https://github.com/CrmLeaf)

---

Top Contributors

[![andolasoftuser196](https://avatars.githubusercontent.com/u/145565449?v=4)](https://github.com/andolasoftuser196 "andolasoftuser196 (8 commits)")

---

Tags

payrollpricingsavingstcopricingpayrollsavingstco

###  Code Quality

TestsPHPUnit

Static AnalysisPHPStan

Code StylePHP CS Fixer

Type Coverage Yes

### Embed Badge

![Health badge](/badges/crmleaf-savings-calculator/health.svg)

```
[![Health](https://phpackages.com/badges/crmleaf-savings-calculator/health.svg)](https://phpackages.com/packages/crmleaf-savings-calculator)
```

###  Alternatives

[magepsycho/magento2-storepricing

Magento 2 Store View Pricing

2625.5k](/packages/magepsycho-magento2-storepricing)[serendipity_hq/bundle-features

Manage features and plans in your Symfony app.

1189.3k](/packages/serendipity-hq-bundle-features)[opengento/module-saleable

This extension allows to set if a product is saleable and can show its price by scope and customer group.

127.2k](/packages/opengento-module-saleable)[whitecube/laravel-prices

Manage acquisition, selling & renting prices for products and services in your Laravel Application

133.8k](/packages/whitecube-laravel-prices)[andychukse/laravel-pricing-plans

A package provide pricing plans for Laravel.

112.8k](/packages/andychukse-laravel-pricing-plans)[justbetter/magento2-customer-pricing

Customer specific pricing module for Magento 2

102.7k](/packages/justbetter-magento2-customer-pricing)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)