💰 GEDF – Personal Finance Manager

A modern and accessible web app that helps users manage their finances, track spending, and make smarter money decisions — with a clean and intuitive interface.

---

📖 Table of Contents

• 🚩 The Problem
• 💡 The Solution (GEDF)
• 🌟 Key Features
• 🛠 Tech Stack
• 📚 What I Learned
• 🚀 Live Demo
• ⚙️ Getting Started
• 🤝 Contributions
• 🛣️ Roadmap
• 📄 License
• 👨‍💻 Author

---

🚩 The Problem

Managing personal finances shouldn't require mastering spreadsheets or switching between disconnected apps.

Yet many people — especially freelancers, students, and young professionals — struggle to:

• Understand where their money is really going
• Set and stick to financial goals
• Access intuitive tools that are fast, responsive, and enjoyable to use

Most tools on the market are overcomplicated, outdated, or ignore essential things like usability and accessibility. I built GEDF to change that.

---

💡 The Solution (GEDF)

GEDF is a Personal Finance Manager that:

1. Automatically imports your expenses (via CSV or API).
2. Shows real-time dashboards to track income, expenses, and more.
3. Offers goals and alerts: set your savings target and get notifications.
4. Works 100% in the browser with responsive and accessible design.
5. It's free

---

🎯 Main Features

• Transaction Registration: Create income and expense entries with customizable categories.
• Custom Dashboard: Interactive line, pie, and bar charts for instant analysis.
• Financial Goals: Set monthly targets and track your progress in real time.
• Report Exporting: Download reports in PDF/CSV for accounting or external review.
• Secure Authentication: JWT login + protection against XSS/CSRF.
• Dark Mode: Switch between light and dark themes with one click.

---

---

🛠 Tech Stack

• Frontend: Next.js + React.js + TypeScript + Tailwind CSS
• Bundler: Webpack (custom config for optimization)
• Styling: Modular SCSS + BEM methodology
• Testing: Jest & React Testing Library (TDD)
• Accessibility: ARIA, semantic HTML, visible focus
• API: RESTful (Node.js/Express or Firebase)
• Deployment: AWS S3 + CloudFront (or Vercel)

---

📚 What I Learned

• ⭐ Clean Architecture: Layer separation (UI, domain, data).
• ⚡ Web Performance: Code-splitting, lazy loading, image optimization.
• 🔐 SPA Security: XSS mitigation, CSP, JWT best practices.
• 🧪 TDD in Practice: Test coverage from components to services.
• ♿ Real a11y: Making interfaces truly usable by everyone.

---

🚀 Demo

Check out GEDF in action:
🌐 https://gedf-demo.vercel.app

Demo user: demo@gedf.com / Password: 123456

---

👟 Getting Started

1. Clone the repository

   git clone https://github.com/jose-leandro/Gerenciador-Financeiro-Gedf.git
   cd Gerenciador-Financeiro-Gedf
   

2. Install dependencies

3.Environment Variables Create a .env.local file with your API keys, database info, etc.

🛠️ Technologies Used

This project is a symphony of modern technologies:

⚙️ How It Works

🌱 Inspiration

🚀 Getting Started

Clone the Repository

git clone https://github.com/jose-leandro/Stellar.git

Install Dependencies

npm install

Run the Application

npm run dev

• The server will start on 'http://localhost:3000'

🤝 Contributions

Contributions are always welcome! If you’re interested in improving this project, follow these steps:

1. Fork the Project
2. Set Up Locally
3. Make Changes: Feel free to explore, fix issues, and add features.
4. Submit a Pull Request: Describe your changes and their impact.
5. Review & Merge: Your contribution will be reviewed, and if everything looks good, it will be merged.

Thank you for helping to make Stellar even more amazing!

🛣️ Roadmap

📄 License

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

🙏 Acknowledgments

OpenAI & ChatGPT: For assisting in exploring new features, fixing issues, and improving the project. React & Next.js: For providing the foundation of Stellar.

👨‍💻 Author

Developed by José Leandro.

Feel free to connect with me and follow my journey: