Investment Journey Simulator

Open-source investment planning & simulation

Investment
Journey Simulator

Decisions compound too.

Model SIPs, lump sums, contribution pauses, withdrawals, tax-aware cash flows, portfolio rebalancing, historical paths, Monte Carlo scenarios and financial goals - then understand why different investment journeys end differently.

2,488 tests passing
93% statement coverage
≈33,800 independent randomized cross-checks
MIT open-source licence

What you can model

Not just what the money becomes. What happens along the way.

Investment Journey Simulator represents a plan as a sequence of contributions and life events rather than a single monthly payment entered into a compound-interest formula.

01 - ENGINE

Built around the actual cash flows

Monthly compounding on the simulator's stated convention, FIFO lot accounting, two expense-ratio models and multi-fund portfolios. The engine tracks when money enters, what it owns and what happens to each lot over time.

02 - JOURNEY

Plans that can change when life does

SIPs, lump sums, step-ups, contribution pauses, resumes, systematic withdrawals, depletion, full exits, later restarts and portfolio rebalancing. A plan does not have to remain a straight line for thirty years.

03 - GOALS & RETURNS

Measure the outcome from more than one angle

Nominal and inflation-adjusted values, XIRR, post-tax XIRR, goal seek for contribution, return or horizon, drawdown, contribution-versus-growth views and a validation layer that exposes the assumptions behind the result.

04 - RISK & HISTORY

Replace the single smooth return line with paths

Historical replay, rolling backtests, return-path analysis, drawdowns, sequence-of-returns risk, stochastic scenarios, Monte Carlo simulation and block-bootstrap paths sourced from real historical observations.

05 - COMPARE

Explain why two journeys finish differently

Compare plans side by side, isolate timing effects and attribute a multi-decision outcome gap to its causes. Shapley-based attribution handles interacting changes so the explained parts add back to the total difference.

06 - REBALANCING

Test allocation policy instead of assuming it

Model target allocations, drift, overweight handling, proportion-based rebalancing and alternative rebalancing policies, then compare what those policies actually change in the investment path.

07 - TAX DEPTH

Regional rules where the model supports them

The global engine does not assume a country. For the supported Indian resident-individual scope, the simulator adds lot-level capital-gains treatment, short- and long-term holding periods, the annual exemption, grandfathering, loss set-off and expiry, surcharge slabs, marginal relief, exit load and STT.

08 - TIMELINE

Plan by seeing when things happen

A clickable event rail, live Gantt-style journey view, date-aware events, visible units, choose-or-type controls and one shared scenario that carries across the simulator instead of making the user re-enter the same plan on every screen.

09 - OUTPUT & AUDIT

Keep the result portable and inspectable

Accessible chart colours, scenario persistence, PDF, Excel and JSON exports, reports, source documentation and explicit validation and limitation records. The working is meant to be questioned, reproduced and checked.

Why timing matters

Two plans can invest the same total amount, take the same five-year break, and still finish far apart because the break happened at a different point in the journey.

One worked example, shown in INR: two twenty-year plans each contribute exactly ₹45,00,000 and each pause contributions for five years. Moving that pause earlier changes the ending portfolio by about ₹22.83 lakh under the same assumptions. Change the display currency and the principle is unchanged: the difference comes from time available for compounding, not additional money invested.

Trust the working, not the interface

A simulator should be inspectable.

The project documents both what has been tested and what remains a limitation. Numerical output is cross-checked independently rather than relying only on the implementation's own unit tests.

2,488 tests pass With three intentionally skipped tests and 93% statement coverage in the published validation record.
Independent simulators Approximately 29,000 untaxed and 4,800 taxed randomized plans were independently cross-checked.
Sources are documented Statutory parameters, conventions and their sources are recorded rather than hidden inside the interface.
Limitations are explicit Historical data does not become a forecast, and future returns remain user-defined assumptions.

Questions

What this tool is - and is not.

Is Investment Journey Simulator a market forecast?

No. You provide assumptions such as expected return, inflation and contributions. The simulator calculates what those assumptions imply. It does not claim to predict future market returns.

Is this only a SIP calculator?

No. SIP and systematic investment plan modelling is one capability. The simulator also handles lump sums, pauses, withdrawals, contribution changes, portfolio rebalancing, goals, historical replay, Monte Carlo scenarios, XIRR and other journey-level decisions.

Is the simulator only for Indian investors?

No. The core investment, contribution, portfolio and simulation engine is designed around general investment journeys. India-specific depth is provided where relevant, including supported resident-individual capital-gains modelling and educational investment guides.

Is this financial or tax advice?

No. Investment Journey Simulator is an educational and simulation tool. Returns are assumptions, tax rules can change, and individual circumstances may require professional advice.

Investment Journey Simulator

You define the assumptions.
It shows you their consequences.

Open source, inspectable and designed to make long-term investment decisions easier to reason about without pretending uncertainty does not exist.