Merge pull request #2238 from PolicyEngine/PavelMakarchuk/issue2236

GiveCalc blog post

src/posts/articles/givecalc.md

@@ -0,0 +1,77 @@
+This Giving Tuesday, we’re launching [**GiveCalc**](https://policyengine.org/us/givecalc), a free tool that calculates how charitable giving affects your US taxes and net income[^eagx] When you make a tax-deductible donation, you reduce your tax liability — but quantifying that reduction requires modeling complex interactions across federal and state tax systems.
+
+[^eagx]: The concept originated at a hackathon at EAGxBerkeley in December 2022. Rather than rush to release, we prioritized accuracy and comprehensiveness, developing and validating our model of income taxes at the federal level and across all 50 states, DC, and NYC. We are grateful to the collaborators from that session, who regrettably remain unnamed as we lost track of them.
+
+## What GiveCalc does
+
+![](https://cdn-images-1.medium.com/max/2000/0*OdmKfI9wWmTydOwB)
+
+GiveCalc starts by collecting your household information. Take a California family earning $200,000, with two children and $15,000 in mortgage interest and property taxes. Without donations, they take home $153,895 after paying $46,105 in federal and state taxes.
+
+The tool then computes three key metrics about charitable giving:
+
+A $20,000 donation reduces their taxes by $3,136, costing them $16,864 in net income. The tax savings come from itemizing deductions on both their federal and California returns — without the mortgage interest and property tax deductions, they would save less since they’d take the standard deduction.
+
+![](https://cdn-images-1.medium.com/max/2000/0*spyC-yuaxbTT6SKA)
+
+This net cost calculation reflects interactions between:
+
+- Federal and state itemized deductions
+
+- State-specific charitable credits and deductions
+
+- Marginal tax rates that vary with income
+
+- Phase-outs and other provisions that depend on adjusted gross income
+
+## The marginal giving discount
+
+![](https://cdn-images-1.medium.com/max/2000/0*8GUprxTadvMn1xt0)
+
+GiveCalc introduces the “marginal giving discount” — the tax reduction from your next dollar of giving. Our example family saves 31 cents in taxes on their next donated dollar, reflecting their federal and California marginal tax rates.
+
+This rate changes as donations affect tax bracket thresholds and deduction eligibility. GiveCalc visualizes these nonlinearities to help donors optimize their giving.
+
+## Finding your target donation
+
+![](https://cdn-images-1.medium.com/max/2000/0*kreBCnVz6vAPbnJq)
+
+Beyond computing the tax impact of a specific donation, GiveCalc can work backward: enter your desired reduction in net income, and it calculates the donation required to achieve that target.
+
+For example, if our family wants to reduce their net income by 10% (from $153,895 to $138,506), they need to donate $17,854.
+
+## Technical Implementation
+
+GiveCalc extends PolicyEngine’s US tax-benefit model with several key features:
+
+1. **Integrated federal and state modeling:** Computes taxes at federal, state, and local (NYC) levels, showing how each affects the giving cost.
+
+1. **Interactive visualization:** Using Plotly, GiveCalc creates dynamic charts showing how taxes change with donation amounts.
+
+1. **Streamlit interface:** The web app runs on Streamlit’s Community Cloud platform, providing a responsive interface without requiring user accounts.
+
+1. **Optimization algorithm:** To find target donation amounts, GiveCalc computes outcomes across many scenarios using PolicyEngine’s validated microsimulation model.
+
+## Next steps
+
+We’ve [open sourced GiveCalc on GitHub](https://github.com/PolicyEngine/givecalc) and welcome contributions. Key areas for expansion include:
+
+- Adding more income sources (most of which we already model, and only need to expose in the interface)
+
+- Expanding to other countries (PolicyEngine operates in the US and UK)
+
+- Supporting additional tax scenarios
+
+- Enhancing visualization options
+
+## Try it yourself
+
+Visit [policyengine.org/us/givecalc](https://policyengine.org/us/givecalc) to calculate your own giving impacts. You can also:
+
+- [View the source code](https://github.com/PolicyEngine/givecalc)
+
+- [Report issues or contribute](https://github.com/PolicyEngine/givecalc/issues)
+
+- [Support PolicyEngine](https://policyengine.org/us/donate) with a tax-deductible donation — and use GiveCalc to estimate its impact
+
+Share your feedback and feature requests in the comments below or [open an issue](https://github.com/PolicyEngine/givecalc/issues) on GitHub.

src/posts/posts.json

@@ -959,5 +959,14 @@
     "authors": ["david-trimmer"],
     "filename": "federal-tax-inflation-adjustments-2025.md",
     "image": "fed_tax_inflation_adjustments.webp"
+  },
+  {
+    "title": "Introducing GiveCalc",
+    "description": "Calculate the true cost of charitable giving.",
+    "date": "2024-12-03 09:30:00",
+    "tags": ["us", "featured", "giving"],
+    "authors": ["max-ghenis", "pavel-makarchuk"],
+    "filename": "givecalc.md",
+    "image": "givecalc.png"
   }
 ]