Skip to content

CodeWithCJ/SparkyBudget

Repository files navigation

SparkyBudget

Logo

SparkyBudge is a personal finance management app that helps users track accounts like Checking, Credit Card, and Loan, manage budgets, and analyze spending trends. Its dark-themed interface offers tools for monitoring net cash, setting recurring budgets, and viewing historical financial data. Ideal for anyone seeking to organize their finances with ease.

image

🛠 How to Install?

  1. Create a new directory:
mkdir sparkybudget
cd sparkybudget
  1. Download Docker Compose and .env-example.
wget https://raw.githubusercontent.com/CodeWithCJ/SparkyBudget/refs/heads/main/docker-compose.yaml  
wget https://raw.githubusercontent.com/CodeWithCJ/SparkyBudget/refs/heads/main/.env-example  
  1. Rename and update DB & the environment file:
mv .env-example .env
nano .env
  1. Pull and start the Docker containers:
docker compose pull && docker compose up -d

🌍 How to Access?

📍 Open your browser and go to:
👉 http://localhost:5050

📂 Demo Files

📌 Pass below env variable to "Yes" to auto generate demo accounts & transactions. Backup your DB file if you are existing user.
This will generate dummy accounts & transactions in the DB file.

SPARKY_DEMO=Yes  

🔄 How to Reset the Token?

If you need to reset your SimpleFin Token, delete the access_url.txt.
Follow these steps:

docker exec -it sparkybudget sh  
rm /SparkyBudget/access_url.txt  
docker-compose down && docker-compose up  

⚠️ Important:

The token can only be used once. You will need to generate a new token from SimpleFin and update it in .env before retrying.

💬 Need Help?

Refer detailed instrusctions and documentation in Wiki.

Join our Discord Community for installation support, configuration help, and contributions:
👉 https://discord.gg/vGjn4b6CVB