https://github.com/ryannjohnson/financial-simulator
A single-page web app for rapidly prototyping financial scenarios.
https://github.com/ryannjohnson/financial-simulator
finance-calculator single-page-app
Last synced: 2 months ago
JSON representation
A single-page web app for rapidly prototyping financial scenarios.
- Host: GitHub
- URL: https://github.com/ryannjohnson/financial-simulator
- Owner: ryannjohnson
- License: mit
- Created: 2020-04-12T01:08:58.000Z (over 5 years ago)
- Default Branch: master
- Last Pushed: 2023-01-07T17:13:13.000Z (almost 3 years ago)
- Last Synced: 2025-07-31T10:47:20.747Z (2 months ago)
- Topics: finance-calculator, single-page-app
- Language: TypeScript
- Homepage: https://ryannjohnson.github.io/financial-simulator/
- Size: 2.87 MB
- Stars: 24
- Watchers: 2
- Forks: 5
- Open Issues: 19
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# Financial simulator
This is a single-page web app for rapidly prototyping financial scenarios. Works
best on desktop browsers.
Use it at .
Watch a 6-minute demo at .
## Motivation
This project helped me achieve "play" with my finances. Before I made this, I
was accustomed to creating Excel spreadsheets to simulate my personal financial
scenarios. Working with timelines and graphs feels more intuitive to me, and
doing so helps me focus on the scenarios I want to run.
_DISCLAIMER: This project was lightly-researched! Do not try to glean any
financial advice from it, because I'm not qualified to give any!_
## How it works
This video demonstrates the web app's core features:
.
- **Accounts are places you keep your money in real life.** You might have a
cash account, a savings account, a 401k, money invested in bonds, stocks,
mutual funds, etc. Each of these places should be their own "account" in the
simulator.
- **Effects are the ways that accounts affect your money over time.** Add
effects to simulate inflation and returns on investments.
- **Events move money into, out of, and between your accounts.** Use them to
represent your recurring income and expenses, investments in financial
products (represented by your other accounts), one-time transfers, or whatever
you move money for. Events are also how you should manually represent complex
transactions like taxes.
The application stays in your browser and requires no server-side component to
run.
## Development
Install the main project dependencies:
```bash
$ npm install
```
Install the example dependencies and run the development server locally:
```bash
$ cd example
$ npm install
$ npm run start
```