https://github.com/guibranco/payment-schedule-simulator
💸📅 UI tool to simulate payment schedules: create, amend, upload, parse, and export (CSV/JSON). Built with Vite/React. API endpoint is runtime-configurable and stored in localStorage.
https://github.com/guibranco/payment-schedule-simulator
billing calculator collection installments payment payment-schedule schedule simulator
Last synced: 2 days ago
JSON representation
💸📅 UI tool to simulate payment schedules: create, amend, upload, parse, and export (CSV/JSON). Built with Vite/React. API endpoint is runtime-configurable and stored in localStorage.
- Host: GitHub
- URL: https://github.com/guibranco/payment-schedule-simulator
- Owner: guibranco
- Created: 2025-05-15T23:27:51.000Z (about 1 year ago)
- Default Branch: main
- Last Pushed: 2026-06-27T22:49:39.000Z (3 days ago)
- Last Synced: 2026-06-28T00:14:20.304Z (3 days ago)
- Topics: billing, calculator, collection, installments, payment, payment-schedule, schedule, simulator
- Language: TypeScript
- Homepage: https://guilherme.stracini.com.br/payment-schedule-simulator/
- Size: 1 MB
- Stars: 1
- Watchers: 0
- Forks: 0
- Open Issues: 1
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# 💸📅 Payment Schedule Simulator
A simple and interactive UI built with **Vite + React** to simulate and manage payment schedules. You can create new schedules, apply amendments, upload existing ones for parsing, and export them in CSV or JSON format. The app communicates with a backend API that is runtime-configurable and persists its endpoint in `localStorage`.
---
## ✨ Features
- **Create (Inception):** Start a new payment schedule from scratch.
- **Amend:** Modify an existing schedule by applying changes.
- **Upload:** Import an existing schedule file and parse it.
- **Export:** Download generated schedules as **CSV** or **JSON**.
- **API Config:** Set the backend API endpoint dynamically at runtime.
- **Persistent Settings:** Stores API config in `localStorage`.
---
## 🧱 Tech Stack
- [Vite](https://vitejs.dev/) – Fast frontend build tool
- [React](https://reactjs.org/) – UI library
- [Tailwind CSS](https://tailwindcss.com/) – Utility-first CSS
---
## 🚀 Getting Started
### Prerequisites
- [Node.js](https://nodejs.org/) >= 18
### Installation
```bash
git clone https://github.com/guibranco/payment-schedule-simulator.git
cd payment-schedule-simulator
npm install
````
### Run locally
```bash
npm run dev
```
Open [http://localhost:5173](http://localhost:5173) to use the app in your browser.
---
## 📦 Build for Production
```bash
npm run build
```
The static site will be available in the `dist/` folder.
---
## 📂 Folder Structure
```
payment-schedule-simulator/
├── public/
├── src/
│ ├── components/
│ ├── hooks/
│ ├── utils/
│ ├── App.tsx
│ └── main.tsx
├── index.html
├── tailwind.config.js
└── vite.config.ts
```
---
## 📄 License
MIT License © Guilherme Branco Stracini
---
## 🙌 Contributions
Feel free to open issues or submit pull requests! Suggestions and improvements are always welcome.