search

gupta-ritik / ExpenseTracker

ExpenseTracker is a simple, intuitive web application designed to help you manage your finances effectively. With ExpenseTracker, you can easily record, categorize, and monitor your daily, weekly, and monthly expenses in one convenient place.
https://walletwatcx.netlify.app
MIT License
6 stars 26 forks source link
css girlscriptsummerofcode gssoc-ext hacktoberfest hacktoberfest-accepted nodejs tailwindcss typescript

readme

GSSoc'24 Extended

🌟 ExpenseTracker – Your Personal Finance Companion 💵

License GitHub Issues GitHub Pull Requests Stars

📋 Table of Contents

⚙️ Tech Stack

Frontend: Next.js, TypeScript, React Hook Form, Zod, TailwindCSS, Chart.js, ShadCN

NextJs TypeScript React TailwindCSS ChartJS ShadCN

Backend:Appwrite, Plaid, Dwolla

Appwrite

🛠️ Highlighted Features

• 🔐 Authentication: Ultra-secure SSR authentication with validations and authorization.
• 🔗 Connect Banks: Integrates with Plaid for linking multiple bank accounts.
• 📊 Home Page: Overview of user accounts with total balance, recent transactions, and spending categories.
• 🏦 My Banks: List of connected banks with respective balances and account details.
• 📝 Transaction History: Pagination and filtering options for viewing transactions across different banks.
• ⏱️ Real-time Updates: Immediate reflection of changes across all pages when connecting new bank accounts.
• 💸 Funds Transfer: Transfer funds using Dwolla to other accounts with necessary fields and recipient bank ID.
• 📱 Responsiveness: Seamless adaptation to various screen sizes, ensuring a consistent user experience across devices.

🤸 Quick Start

Follow these steps to set up the project locally on your machine.

Prerequisites

Make sure you have the following installed on your machine:

Cloning the Repository

git clone https://github.com/gupta-ritik/ExpenseTracker.git
cd ExpenseTracker

Installation

Install the project dependencies using npm:

npm install

Running the Project

npm run dev

Open http://localhost:3000 in your browser to view the project.

👨‍💻 Contributing

We welcome all contributions! If you'd like to contribute, follow these steps:

Steps to Contribute:

  1. Fork this repository by clicking the "Fork" button at the top right of the repository page.
  2. Clone your forked repository to your local machine: 
    git clone https://github.com/your-username/ExpenseTracker.git
  3. Create a new feature branch to work on your changes: 
    git checkout -b feature-branch-name
  4. Make your changes in the codebase.
  5. Commit your changes with a meaningful commit message: 
    git add .
git commit -m "Added feature or fix description"
  6. Push your changes to your forked repository: 
    git push origin feature-branch-name
  7. Create a pull request to the original repository:
    • Go to your forked repository on GitHub.
    • Click the "Compare & pull request" button.
    • Add a description and submit your pull request.

For major changes, please open an issue first to discuss your proposed changes.

Please make sure to follow the code of conduct.

Our Valuable Contributors ❤️✨

Contributors

💬 Feedback & Support

We appreciate your feedback! If you have any questions or issues, feel free to reach out or open a GitHub Issue.

For support, you can also reach out.