CashStash - Gen Z Cash Stuffing Budget App

A modern, animated budgeting app that makes financial management fun through a digital "cash stuffing" approach.

What is Cash Stuffing?

Cash stuffing is a budgeting method where you allocate your income into different categories (envelopes) to control spending. CashStash brings this concept to digital life with animations and game-like elements.

Features

  • šŸ’ø CSV Bank Import: Upload your bank statements to automatically import transactions
  • šŸŽ® Game-like Interface: Drag and drop money into different envelopes
  • ✨ Animated Feedback: Visual rewards when you save money or stick to your budget
  • šŸ“Š Budget Tracking: See where your money is going with intuitive visualizations
  • šŸ† Achievement System: Earn badges and rewards for good financial habits

Tech Stack

  • Frontend: React with animations
  • Backend: TypeScript with SQLite storage
  • Data: CSV parsing for bank statements

Project Structure

ā”œā”€ā”€ backend/
│   ā”œā”€ā”€ database/       # SQLite database setup and queries
│   ā”œā”€ā”€ parsers/        # CSV parsing logic
│   └── index.ts        # Main API entry point
ā”œā”€ā”€ frontend/
│   ā”œā”€ā”€ components/     # React components
│   ā”œā”€ā”€ animations/     # Animation utilities
│   ā”œā”€ā”€ index.html      # Main HTML template
│   └── index.tsx       # Frontend entry point
└── shared/
    └── types.ts        # Shared TypeScript types

Getting Started

  1. Upload a CSV bank statement
  2. Create your budget envelopes
  3. Start stuffing cash into your envelopes
  4. Track your spending and saving progress