Skip to content
/ Emitrax Public

EmiTrax is a personal finance tool designed to help users track, manage, and understand their ongoing EMIs and loan tenures effortlessly.

License

Notifications You must be signed in to change notification settings

Arzzam/Emitrax

Repository files navigation

Emitrax - EMI Tracking Application

Emitrax is a modern web application for tracking and managing EMI (Equated Monthly Installment) payments in one centralized dashboard. Built with React, TypeScript, and Vite, it provides a comprehensive solution for monitoring loan payments, remaining balances, and amortization schedules.

Features

  • EMI Dashboard: View all your active and completed EMIs at a glance
  • Detailed Statistics: Track monthly payments, total outstanding amounts, and more
  • Amortization Schedule: View detailed payment breakdowns for each EMI
  • Google Authentication: Secure login via Google OAuth
  • Responsive Design: Works seamlessly on desktop and mobile devices
  • Dark/Light Theme: Choose your preferred visual theme

Demo

  1. Log in with your Google account to access the dashboard.
  2. View all your active EMIs and track remaining balances.
  3. Add new EMIs by clicking on the "Add EMI" button and filling in the details.
  4. Click on any EMI card to view detailed information and amortization schedule.
  5. Use the filter options to sort and view EMIs by different criteria.
  6. Toggle between dark and light themes based on your preference.

The application is live and accessible at emitrax.arzzam.in

Tech Stack

  • Frontend: React 19 with TypeScript
  • State Management: Rematch/Redux with persist for local storage
  • UI Components: Custom UI components built with Radix UI and TailwindCSS
  • Database & Auth: Supabase for data storage and authentication
  • Data Fetching: TanStack Query (React Query)
  • Form Handling: React Hook Form with Zod validation
  • Routing: React Router v7
  • Build Tool: Vite

Getting Started

Prerequisites

  • Node.js (v18 or later recommended)
  • Yarn package manager
  • Supabase account for database setup

Installation

  1. Clone the repository
git clone https://github.com/yourusername/emitrax.git
cd emitrax
  1. Install dependencies
yarn install
  1. Create a .env.local file in the root directory with your Supabase credentials:
VITE_SUPABASE_URL=your_supabase_project_url
VITE_SUPABASE_KEY=your_supabase_anon_key
  1. Start the development server
yarn dev

The application will be accessible at http://localhost:5173.

Deployment

The production version of Emitrax is deployed and accessible at emitrax.arzzam.in. The application is hosted on a cloud platform and utilizes Supabase for backend services and authentication.

Project Structure

  • src/components: Reusable UI components
  • src/context: React context providers
  • src/hooks: Custom React hooks
  • src/router: Page components and routing
  • src/store: Rematch/Redux store configuration
  • src/supabase: Supabase client and type definitions
  • src/utils: Utility functions

Contributing

Contributions are welcome! Please feel free to submit a Pull Request.

Want to Contribute? Follow the steps below to get started!

Prerequisites

Before you begin, ensure you have the following installed:

  • Node.js: JavaScript runtime built on Chrome's V8 JavaScript engine.
  • Yarn: Fast, reliable, and secure dependency management.
  • Supabase: Open source Firebase alternative for database and authentication.

Getting Started

  1. Fork this repository.

  2. Clone your forked repository:

    git clone https://github.com/your-username/emitrax.git
  3. Change directory:

    cd emitrax
  4. Install dependencies:

    yarn
  5. Create a .env.local file in the root directory with your Supabase credentials:

    VITE_SUPABASE_URL=your_supabase_project_url
    VITE_SUPABASE_KEY=your_supabase_anon_key
    
  6. Start the development server:

    yarn dev

    The application will be accessible at http://localhost:5173.

  7. Make sure to add remote upstream:

    git remote add upstream https://github.com/arzzam/emitrax.git
    
    # To verify the new upstream repository you've specified for your fork
    git remote -v
  8. Create a new branch:

    git checkout -b new-branch-name
  9. Make changes and create a pull request to the main branch.

License

This project is licensed under the MIT License - see the LICENSE file for details.


Give a star ⭐ if you like this project!

About

EmiTrax is a personal finance tool designed to help users track, manage, and understand their ongoing EMIs and loan tenures effortlessly.

Resources

License

Stars

Watchers

Forks

Contributors 2

  •  
  •  

Languages