The latest articles on DEV Community by Olga Dimitrova (@olgadimitrova). https://dev.to/olgadimitrova https://media2.dev.to/dynamic/image/width=90,height=90,fit=cover,gravity=auto,format=auto/https:%2F%2Fdev-to-uploads.s3.us-east-2.amazonaws.com%2Fuploads%2Fuser%2Fprofile_image%2F4147933%2Fb51b277d-ee9a-4636-94aa-921038a31c08.png https://dev.to/olgadimitrova en Olga Dimitrova Wed, 30 Sep 2026 03:47:06 +0000 https://dev.to/olgadimitrova/why-a-pay-gap-cost-calculator-should-make-zero-network-calls-2n38 https://dev.to/olgadimitrova/why-a-pay-gap-cost-calculator-should-make-zero-network-calls-2n38 <p>I maintain a small open-source calculator that prices what it costs to close an unexplained gender pay gap under the EU Pay Transparency Directive (2023/970). You give it a CSV of employees (salary, gender, grade, tenure, category), and it prices two options: minimum compliance and full equalisation. It ships as a static HTML page and, separately, as an Excel workbook with the same calculation in live formulas.</p> <p>The page makes no network requests at all. It doesn't promise to skip logging or to encrypt your data on a server, because there is no server. Open the browser's Network tab while you use it and it stays empty. Most of the design follows from that.</p> <h2> The input is some of the most sensitive data a company holds </h2> <p>A pay-gap calculation needs individual salaries by gender, category, grade and tenure. Most HR and reward teams would rather not let that leave the company, even briefly, even to a vendor with a data processing agreement and a SOC 2 report. A web app that uploads the CSV to a server asks every user to trust a company they have probably never audited, for a calculation their laptop does in milliseconds.</p> <p>So <code>index.html</code> is the whole application. HTML, CSS and JavaScript sit in one file. There is no build step to run it and no backend to operate or patch, and nobody's salary file ends up on a server.</p> <h2> What "no network calls" requires in practice </h2> <p>"Runs in your browser" is easy to say. Keeping it true means giving up a few conveniences:</p> <ul> <li>No CDN for fonts or libraries. A dependency is either vendored into the file or not used. The chart is plain SVG, not a charting library.</li> <li>No analytics, error reporting or telemetry, including the "just to see if people use it" kind. Each of those is a network call.</li> <li>The CSV comes in through an <code>&lt;input type="file"&gt;</code> and is read into memory with the FileReader API. The page computes the result, and the data is gone on refresh. Nothing is written anywhere unless the user downloads a result.</li> </ul> <p>The repo has two checks for this. <code>check-render.js</code> scans the built page and fails (exit 1) if it references any external script, stylesheet or image. <code>check-meta.js</code> opens the page in headless Chrome, records every network request made while it loads, and fails (exit 1) if there is even one. Without a test that can fail, "no network calls" only means "no network calls that we noticed."</p> <h2> Why the Excel workbook exists </h2> <p>If you can't read JavaScript, the web page is hard to verify. Without developer tools, how do you see what it does with your data? So the same calculation also exists as an Excel workbook, all in live formulas: medians by rank, and the OLS regression written out with explicit sums and Cramer's rule instead of an array formula or a macro. Click a cell, read the formula, change an input and watch every downstream number move. There is no VBA and nothing hidden behind a button.</p> <p>I cross-checked the web version, the workbook and a third, independent Python port on the demo dataset, and they agree to 1e-9. The port is in the repo at <code>pay-gap-calculator/build/excel/reference_calc.py</code>. It follows <code>pay-gap-calculator/build/calc.js</code> step by step in a different language and prints every category, so you can rerun the comparison yourself instead of taking the README's word for it.</p> <h2> What this doesn't solve </h2> <p>Open source and zero network calls answer "can I trust this with my data." They don't answer "is this the right method." The calculator prices the unexplained residual after controlling for grade and tenure (OLS) and remediates only that residual. It doesn't decide whether a gap is lawful, and it doesn't group work of equal value into categories for you. Categories too small to be statistically reliable get flagged rather than hidden. Those are choices, and someone else building the same tool could reasonably make different ones. Whether your salary data should touch a server to find out is a separate question, and I think it has one answer.</p> <p>Repo, workbook, sample CSV and the checks: <a href="https://github.com/OlgaDimitrovaGit/comp-budget-lab/tree/main/pay-gap-calculator" rel="noopener noreferrer">https://github.com/OlgaDimitrovaGit/comp-budget-lab/tree/main/pay-gap-calculator</a></p> opensource javascript hr privacy