Mavusi.Financials 1.0.0

Mavusi.Financials

Mavusi.Financials is a .NET class library that provides practical fintech and financial-planning calculators. It is designed for application teams that need reusable financial logic with descriptive result messages suitable for UI output.

What is included

• Loan repayment calculator
• Amortization schedules
• Extra payment simulations
• APR/EAR calculations
• Compound interest
• Investment growth projections
• NPV/IRR/XIRR
• Debt payoff optimization (Avalanche and Snowball)
• Retirement projections
• Affordability calculations
• Tax estimations
• Business-day/date handling
• Currency and rounding utilities
• Inflation adjustment
• Scenario simulations

Supported target frameworks

• .NET 8.0
• .NET 9.0
• .NET 10.0

Installation

From NuGet

After publishing:

• dotnet add package Mavusi.Financials

Local package source

1. Build and pack this project.
2. Add the local package source in NuGet configuration.
3. Install with dotnet add package.

Quick usage

using Mavusi.Financials;

var loan = LoanRepaymentCalculator.CalculateMonthlyRepayment( principal: 500_000m, annualInterestRatePercent: 14m, months: 60);

Console.WriteLine(loan.Message); // Example: You will be paying back R697,630.80 over 60 months at 14.00% interest.

var schedule = AmortizationScheduleCalculator.BuildSchedule( principal: 500_000m, annualInterestRatePercent: 14m, termMonths: 60, extraMonthlyPayment: 500m);

Console.WriteLine(schedule.Message);

var projection = InvestmentGrowthProjector.Project( startingBalance: 100_000m, annualReturnPercent: 9m, annualContribution: 24_000m, years: 15, annualContributionGrowthPercent: 5m);

Console.WriteLine(projection.Message);

var xirr = NpvIrrXirrCalculator.CalculateXirr(new[] { new CashFlowPoint(new DateOnly(2024, 1, 1), -120_000m), new CashFlowPoint(new DateOnly(2024, 7, 1), 20_000m), new CashFlowPoint(new DateOnly(2025, 7, 1), 30_000m), new CashFlowPoint(new DateOnly(2026, 7, 1), 95_000m) });

Console.WriteLine(xirr.Message);

API shape

Most calculators return strongly typed result records that include:

• Numeric outputs
• Structured breakdown rows where applicable
• A Message field for direct user-facing explanation

Packaging for upload

Run the following from the repository root:

• export PATH=$HOME/.dotnet:$PATH
• dotnet pack Mavusi.Financials/Mavusi.Financials.csproj -c Release

Packages are output to:

• artifacts/packages

License

MIT