Skip to content

MrGuato/futurecalc

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

94 Commits
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

FutureCalc — Smart & Secure Calculator

A modern, open-source calculator for building wealth safely - security‑first, transparent, and client‑only.

Made With Love Page Deployment Lint Status CodeQL Analysis Known Vulnerabilities Dependabot Scorecard supply-chain security GitHub Repo stars Last Commit

Live Demo: FutureCalc.io Report Card: Open SSF Report Card


What is FutureCalc?

FutureCalc is a lightweight, privacy‑respecting tool that helps you:

  • Split each paycheck between savings and investing
  • Build a 6‑month emergency fund
  • Understand compounding with clear visuals
  • Explore debt payoff, mortgages, and DCA for crypto

Everything runs locally in your browser. No tracking. No backend. Open source.


Features

Core

  • Paycheck planner with percentage sliders and direct input
  • Emergency fund target and progress bar (6× monthly expenses by default)
  • Growth projection with Investing vs Savings chart
  • Contributions vs growth breakdown and time‑based milestones
  • Dark mode, responsive UI, accessible colors and keyboard navigation

Calculators

  • Debt payoff
    • Avalanche and Snowball strategies
    • Amortization with extra payments
    • Time to payoff, interest saved
    • Balance‑over‑time chart and CSV export
  • Mortgage
    • Payment calculation and full amortization
    • Extra payments and time‑to‑payoff
    • 80% LTV milestone estimate (PMI proxy)
    • Balance‑over‑time chart and CSV export
  • Crypto (DCA)
    • Periodic buys with fee input
    • Average cost, ending value, max drawdown
    • Portfolio value vs contributions chart and CSV export

Privacy & Performance

  • 100% client‑side, no data collection
  • LocalStorage for convenience
  • No frameworks required, fast load over a CDN

Why FutureCalc?

Most online calculators are either black boxes or trade convenience for privacy. FutureCalc is:

  • Open‑source and auditable
  • Explicit about formulas and assumptions
  • Built with secure engineering practices from the start

Educational tool only — not financial advice. Returns are hypothetical.


Security Engineering Focus

Showcasing secure‑by‑default front‑end practices:

  • Client‑only architecture
    • No cookies, no sessions, no tracking
    • Inputs persist only in LocalStorage
  • Secure coding standards
    • No unsafe eval
    • Scoped functions and listeners
    • Defensive parsing and bounds checking on user inputs
  • Supply chain hygiene
    • Dependabot for updates
    • CodeQL for static analysis
    • Linting and formatting in CI
    • OpenSSF Report Card
  • Repo hygiene
    • MIT License
    • SECURITY.md for vulnerability reporting
    • Minimal, auditable third‑party usage (Chart.js via CDN)

Architecture

  • Single‑page app: index.html with vanilla HTML/CSS/JS
  • ES‑module style organization within one script
  • Charts via Chart.js
  • No build step; GitHub Pages ready

Getting Started

Local

  • Clone the repo
  • Open index.html in a modern browser

GitHub Pages (https://mrguato.github.io/futurecalc/)

  • Open Browser for Browser Based Calculator

Methods and Assumptions (Finance)

  • Compound growth: future value with periodic contributions
  • Savings APY and investment return applied per‑period
  • Debt payoff:
    • Monthly interest accrual, minimums first
    • Extra payment allocated per chosen strategy
  • Mortgage:
    • Standard amortization M = P·i·(1+i)^n / ((1+i)^n − 1)
    • Extra payments reduce principal, shortening term
    • 80% LTV milestone as a PMI proxy (informational only)
  • Crypto DCA:
    • Units from contribution net of fee
    • Average cost, ending value, max drawdown
    • Optional simulated path for illustration

Roadmap

  • Add UI Changes for Dark & Light Modes
  • Add Debt Calculator
  • Add Crypto Calculator
  • Add Mortgage Calculator
  • Add Graphs
  • Scenario comparison (e.g., 10% vs 15% investing)
  • Real vs nominal returns (inflation toggle)
  • FAQ and “Methods” page with citations
  • Printable reports for projections and schedules

Security Policy

See SECURITY.md for how to report a vulnerability.


License

MIT License © 2025 Jonathan DeLeon


Contributing

Contributions are welcome. Please open an issue or submit a pull request with clear scope and validation steps.

About

A clean, modern tool to help professionals and millennials plan their paycheck, build an emergency fund, and understand the power of compounding.

Topics

Resources

License

Security policy

Stars

Watchers

Forks

Contributors

Languages