Aritmo Budget Planner

A powerful, privacy-focused desktop application for personal finance management. Built with modern web technologies and wrapped in Electron, Aritmo runs locally on your machine, ensuring your financial data remains secure and private.

Features

• Interactive Dashboard: Visual overview of your financial health with dynamic charts.
• Transaction Management: Easily record and categorize income and expenses.
• Bill Tracking: Keep track of recurring bills, due dates, and payment status.
• Budget Planning: Set monthly limits for different categories to control your spending.
• Savings Goals: Create and track progress towards your financial goals.
• Debt Manager: Monitor and plan your debt payoffs effectively.
• Currency Converter: Real-time currency conversion tools.
• Multi-language Support: Interface available in multiple languages.
• Offline First: Works without internet connection using local JSON storage.
• Cloud Sync: Automatically synchronizes data with Supabase when online.
• Modern UI: Clean, responsive interface styled with Tailwind CSS and Lucide icons.

Screenshots

Stack

• Runtime: Electron
• Frontend: React (v19)
• Build Tool: Vite
• Language: TypeScript
• Styling: Tailwind CSS
• Database: Supabase (PostgreSQL) + Local JSON Storage
• Visualization: Recharts
• Icons: Lucide React

External APIs

The application uses the following public APIs for real-time data:

• Currency Exchange Rates: FloatRates - Provides daily exchange rates for major currencies.
• Dolar Vzla Rates: DolarAPI - Provides specific exchange rates for the database in Venezuela.

Getting Started

Prerequisites

• Node.js (v18 or higher recommended)
• npm

Installation

1. Clone the repository

   git clone https://github.com/Jean-EstevezT/Aritmo-Budget-Planner.git
   cd Aritmo-Budget-Planner

2. Install dependencies

   npm install

3. Setup Environment Variables Create a .env file in the root directory:

   SUPABASE_URL=your_supabase_url
   SUPABASE_KEY=your_supabase_anon_key

4. Setup Database Run the SQL commands from supabase_schema.sql in your Supabase SQL Editor to create the required tables with the necessary columns (including updated_at).

5. Run the application (Development)

   npm run dev:electron

   This command runs both the Vite dev server and the Electron application concurrently.

6. Build for Production

   npm run electron:dist

Developer

Jean Estevez

• GitHub: Jean-EstevezT
• Email: ctarriba9@gmail.com

---

License

This project is licensed under the GNU GPLv3 License.