Skip to content

jasonzop/Expense-Tracker

Repository files navigation

Expense Tracker

Overview

A full-stack expense tracking application built with React, TypeScript, and AWS services. Helps individuals track spending patterns and maintain budgets with intelligent categorization and analytics.

Problem Statement

Young professionals and students struggle to track spending patterns effectively, leading to budget overshoots and poor financial decisions. Existing solutions are either too complex or lack the features needed for modern spending habits.

Technical Architecture

  • Frontend: React 18 with TypeScript
  • Styling: Tailwind CSS for responsive design
  • Backend: Next.js API routes with AWS Lambda
  • Database: PostgreSQL with Drizzle ORM
  • Cloud: AWS (S3, Lambda, Aurora DSQL)
  • Testing: Vitest with 70% coverage target
  • Deployment: GitHub Actions CI/CD

Prerequisites

  • Node.js 18.17.0 or higher
  • npm 9.6.7 or higher
  • Git configured with your credentials
  • GitHub account with Copilot access

Installation

  1. Clone the repository:
    git clone https://github.com/[yourusername]/expense-tracker
    cd expense-tracker
  2. Install dependencies:
    npm install
  3. Set up environment variables:
    cd .env.example .env.local
    # Add your confuguration values
  4. Start development server:
    npm run dev

Contributing

Please read our Contributing Guidelines and Code of Conduct before submitting PRs.

Architecture Decision Records

See docs/ADR/ for technical decision documentation.

License

MIT License - see LICENSE for details.

About

Professional expense tracking application built with React, TypeScript, and AWS

Resources

License

Stars

Watchers

Forks

Packages

No packages published