Skip to content

akshat-code21/PennyWise

Repository files navigation

PennyWise - Modern Expense Tracking Application

PennyWise is a sophisticated expense tracking application built with React and TypeScript and Node.js + Express.js Backend, featuring an intuitive interface and powerful visualization tools to help users manage their personal finances effectively.

✨ Key Features

  • 📊 Interactive dashboards with spending analytics
  • 💳 Detailed expense tracking and categorization
  • 📈 Visual data representation with charts and graphs
  • 💡 Smart saving tips and financial insights
  • 🎯 Budget planning and goal setting
  • 📱 Responsive design optimized for all devices

🛠️ Tech Stack

Frontend

  • React.js with TypeScript
  • Tailwind CSS for styling
  • Shadcn UI components
  • Chart.js for data visualization
  • React Query for data fetching
  • React Hook Form for form management
  • Node.js
  • Express.js
  • Environment variables (.env) for configuration

🚀 Getting Started

Prerequisites

  • Node.js (v16 or higher)
  • npm or yarn package manager

Installation

  1. Clone the repository:
git clone https://github.com/yourusername/PennyWise-Frontend-React.git
  1. Navigate to the project directory:

  2. Install dependencies:

npm install
# or
yarn install
  1. Start the development server:
npm run dev
# or
yarn dev
  1. Open your browser and visit http://localhost:5173

📁 Project Structure

src/
├── components/
│   ├── dashboard/
│   │   ├── layout/
│   │   ├── ui/
│   │   └── savingTips/
│   └── ui/
├── hooks/
├── styles/
└── types/

🎯 Usage

  1. Sign in to your account
  2. Navigate the dashboard to view your financial overview
  3. Add new expenses using the "Add Transaction" button
  4. View detailed analytics in the charts section
  5. Check saving tips for personalized financial advice
  6. Manage your expenses through the detailed expenses table

🤝 Contributing

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

  1. Fork the project
  2. Create your feature branch (git checkout -b feature/AmazingFeature)
  3. Commit your changes (git commit -m 'Add some AmazingFeature')
  4. Push to the branch (git push origin feature/AmazingFeature)
  5. Open a Pull Request

About

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published