{"id":29113832,"url":"https://github.com/mk-2206/finwise-app","last_synced_at":"2026-04-16T04:31:10.521Z","repository":{"id":299494230,"uuid":"1003165470","full_name":"MK-2206/FINWISE-APP","owner":"MK-2206","description":"The ultimate financial companion for content creators, influencers, and digital entrepreneurs.","archived":false,"fork":false,"pushed_at":"2025-06-16T21:00:21.000Z","size":4589,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2025-06-29T11:05:52.587Z","etag":null,"topics":["app","banking","chart","finance","gamified","h2database","heroku","java","maven","spring-boot"],"latest_commit_sha":null,"homepage":"https://finwise-springboot-app-665d5dc86747.herokuapp.com/","language":"HTML","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/MK-2206.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null}},"created_at":"2025-06-16T18:15:36.000Z","updated_at":"2025-06-16T21:05:26.000Z","dependencies_parsed_at":"2025-06-16T21:39:06.248Z","dependency_job_id":null,"html_url":"https://github.com/MK-2206/FINWISE-APP","commit_stats":null,"previous_names":["mk-2206/finwise-app"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/MK-2206/FINWISE-APP","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/MK-2206%2FFINWISE-APP","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/MK-2206%2FFINWISE-APP/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/MK-2206%2FFINWISE-APP/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/MK-2206%2FFINWISE-APP/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/MK-2206","download_url":"https://codeload.github.com/MK-2206/FINWISE-APP/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/MK-2206%2FFINWISE-APP/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":262581387,"owners_count":23331913,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["app","banking","chart","finance","gamified","h2database","heroku","java","maven","spring-boot"],"created_at":"2025-06-29T11:05:51.883Z","updated_at":"2026-04-16T04:31:10.467Z","avatar_url":"https://github.com/MK-2206.png","language":"HTML","funding_links":[],"categories":[],"sub_categories":[],"readme":"# 💸 FinWise - Creator Banking Application\n\n\u003e **A Spring Boot-based financial management platform with gamified UI, designed specifically for content creators, freelancers, and digital entrepreneurs.**\n\n[![Live Demo](https://img.shields.io/badge/🚀_Live_Demo-Available-brightgreen)](https://finwise-springboot-app-665d5dc86747.herokuapp.com)\n[![GitHub Stars](https://img.shields.io/github/stars/MK-2206/FINWISE-APP)](https://github.com/MK-2206/FINWISE-APP/stargazers)\n[![Spring Boot](https://img.shields.io/badge/Spring_Boot-6DB33F?style=flat\u0026logo=spring\u0026logoColor=white)](https://spring.io/projects/spring-boot)\n[![Java](https://img.shields.io/badge/Java-17-ED8B00?style=flat\u0026logo=openjdk\u0026logoColor=white)](https://openjdk.org/)\n[![License](https://img.shields.io/badge/License-MIT-blue.svg)](LICENSE)\n\n\u003cdiv align=\"center\"\u003e\n  \u003cimg src=\"https://raw.githubusercontent.com/MK-2206/FINWISE-APP/main/screenshots/1.png\" alt=\"FinWise Dashboard Preview\" width=\"800\"\u003e\n    \u003cimg src=\"https://raw.githubusercontent.com/MK-2206/FINWISE-APP/main/screenshots/3.png\" alt=\"FinWise Dashboard Preview\" width=\"800\"\u003e\n  \u003cimg src=\"https://raw.githubusercontent.com/MK-2206/FINWISE-APP/main/screenshots/4.png\" alt=\"FinWise Dashboard Preview\" width=\"800\"\u003e\n  \u003cimg src=\"https://raw.githubusercontent.com/MK-2206/FINWISE-APP/main/screenshots/5.png\" alt=\"FinWise Dashboard Preview\" width=\"800\"\u003e\n  \u003cimg src=\"https://raw.githubusercontent.com/MK-2206/FINWISE-APP/main/screenshots/6.png\" alt=\"FinWise Dashboard Preview\" width=\"800\"\u003e\n    \u003cimg src=\"https://raw.githubusercontent.com/MK-2206/FINWISE-APP/main/screenshots/7.png\" alt=\"FinWise Dashboard Preview\" width=\"800\"\u003e\n\n\n  **Visit the [live demo](https://finwise-springboot-app-665d5dc86747.herokuapp.com) to see the full interface!**\n\u003c/div\u003e\n\n---\n\n## 🎯 What is FinWise?\n\nFinWise is a full-stack banking application that transforms chaotic creator finances into an organized, gamified experience. Built with Spring Boot backend and modern frontend technologies, it's designed for content creators who juggle multiple income streams and irregular earnings.\n\n### ✨ **Why FinWise?**\n- 💳 **Professional Banking Features** - Account management with real database persistence\n- 📊 **Creator-Focused Analytics** - Track income streams, expenses, and financial goals\n- 🎮 **Gamified Experience** - Level up system and achievement unlocks\n- 💡 **Smart Financial Tools** - Tax calculators, investment analyzers, brand deal evaluators\n- 🚀 **Real-time Updates** - Live financial summaries and progress tracking\n\n---\n\n## 🌟 Features\n\n### 💰 **Core Banking Operations**\n- **Account Management** - Create accounts with initial balances\n- **Deposit \u0026 Withdraw** - Real-time balance updates via REST API\n- **Transaction History** - Complete audit trail of all financial activities\n- **Multi-Account Support** - Separate business and personal accounts\n\n### 📊 **Creator Analytics Dashboard**\n- **Income Tracking** - Multiple revenue streams (sponsorships, ad revenue, merchandise)\n- **Expense Categorization** - Creator-specific expense categories\n- **Financial Summary Cards** - Real-time profit/loss calculations\n- **Chart.js Visualizations** - Beautiful charts for income trends\n\n### 🎯 **Creator-Specific Tools**\n- **Investment Calculator** - ROI analysis for equipment, courses, trips\n- **Tax Estimator** - Quarterly tax calculations for freelancers\n- **Brand Deal Calculator** - Evaluate sponsorship opportunities\n- **Creator Goals** - Visual progress tracking with animated bars\n\n### 🎮 **Gamification System**\n- **XP \u0026 Leveling** - Earn experience points for financial activities\n- **Creator Ranks** - Progress from \"Rising Creator\" to \"Creator Master\"\n- **Achievement Badges** - Unlock milestones as you grow\n- **Progress Celebrations** - Confetti animations and motivational messages\n\n---\n\n## 🚀 Tech Stack\n\n\u003cdiv align=\"center\"\u003e\n\n| Backend | Database | Frontend | Build Tool | Deployment |\n|---------|----------|----------|------------|------------|\n| ![Spring Boot](https://img.shields.io/badge/Spring_Boot-6DB33F?style=for-the-badge\u0026logo=spring\u0026logoColor=white) | ![H2](https://img.shields.io/badge/H2-316192?style=for-the-badge\u0026logo=h2\u0026logoColor=white) | ![HTML5](https://img.shields.io/badge/HTML5-E34F26?style=for-the-badge\u0026logo=html5\u0026logoColor=white) | ![Maven](https://img.shields.io/badge/Maven-C71A36?style=for-the-badge\u0026logo=apache-maven\u0026logoColor=white) | ![Heroku](https://img.shields.io/badge/Heroku-430098?style=for-the-badge\u0026logo=heroku\u0026logoColor=white) |\n| ![Java](https://img.shields.io/badge/Java-17-ED8B00?style=for-the-badge\u0026logo=openjdk\u0026logoColor=white) | ![JPA](https://img.shields.io/badge/JPA-59666C?style=for-the-badge\u0026logo=hibernate\u0026logoColor=white) | ![JavaScript](https://img.shields.io/badge/JavaScript-F7DF1E?style=for-the-badge\u0026logo=javascript\u0026logoColor=black) | ![Spring Boot](https://img.shields.io/badge/Spring_Boot_Maven-6DB33F?style=for-the-badge\u0026logo=spring\u0026logoColor=white) | ![PostgreSQL](https://img.shields.io/badge/PostgreSQL-316192?style=for-the-badge\u0026logo=postgresql\u0026logoColor=white) |\n\n\u003c/div\u003e\n\n### Architecture Overview\n- **Backend**: Spring Boot REST API with Java 17\n- **Database**: H2 in-memory (development) / PostgreSQL (production)\n- **ORM**: Spring Data JPA with Hibernate\n- **Frontend**: Vanilla JavaScript with Chart.js for analytics\n- **Styling**: Custom CSS with glassmorphism design patterns\n- **Build**: Maven for dependency management\n- **Deployment**: Heroku with PostgreSQL add-on\n\n---\n\n## 🧪 Quick Start\n\n### Prerequisites\n- **Java 17+** (for Spring Boot backend)\n- **Maven 3.6+** (for dependency management)\n\n\n### Local Setup Instructions\n\n1. **Clone the repository**\n   ```bash\n   git clone https://github.com/MK-2206/FINWISE-APP.git\n   cd FINWISE-APP\n   ```\n\n2. **Run using Maven**\n   ```bash\n   # Using Maven wrapper (recommended)\n   ./mvnw spring-boot:run\n   \n   # Or using installed Maven\n   mvn spring-boot:run\n   ```\n\n3. **Access the application**\n   ```\n   🌐 http://localhost:8080\n   ```\n\n4. **Or visit live demo**\n   ```\n   🚀 https://finwise-springboot-app-665d5dc86747.herokuapp.com\n   ```\n\n### First Time Setup\n1. 🏦 Create your first account with initial balance\n2. 💰 Make some deposits to see the system in action\n3. 📊 Explore the creator dashboard and analytics\n4. 🎯 Set up financial goals and watch progress bars\n5. 🎉 Level up by completing financial activities!\n\n---\n\n## 📂 Project Structure\n\n```\nFINWISE-APP/\n├── src/\n│   ├── main/\n│   │   ├── java/com/marcoslombog/mybank/\n│   │   │   ├── App.java                        # Main Spring Boot Application\n│   │   │   ├── controller/\n│   │   │   │   └── AccountController.java      # REST API endpoints\n│   │   │   ├── model/\n│   │   │   │   └── Account.java               # JPA Entity\n│   │   │   ├── repository/\n│   │   │   │   └── AccountRepository.java     # Data Access Layer\n│   │   │   └── exception/\n│   │   │       └── ResourceNotFoundException.java\n│   │   └── resources/\n│   │       ├── application.properties         # Spring Boot configuration\n│   │       ├── data.sql                      # Initial database setup\n│   │       └── static/\n│   │           └── index.html                # Frontend application\n│   └── test/\n│       └── java/                             # Unit tests\n├── target/                                   # Compiled classes\n├── pom.xml                                  # Maven dependencies\n└── README.md\n```\n\n---\n\n## 🧑‍💻 API Documentation\n\n### REST Endpoints\n\n| Method | Endpoint | Description | Request Body |\n|--------|----------|-------------|--------------|\n| `GET` | `/accounts/all` | List all accounts | - |\n| `GET` | `/accounts/{id}` | Get account by ID | - |\n| `POST` | `/accounts/new` | Create new account | `{\"name\": \"John Doe\", \"balance\": 1000.0}` |\n| `PUT` | `/accounts/{id}` | Deposit/withdraw money | `amount` (double) |\n\n### Example API Calls\n\n```bash\n# Get all accounts\ncurl -X GET http://localhost:8080/accounts/all\n\n# Create new account\ncurl -X POST http://localhost:8080/accounts/new \\\n  -H \"Content-Type: application/json\" \\\n  -d '{\"name\": \"Creator Account\", \"balance\": 5000.0}'\n\n# Deposit money\ncurl -X PUT http://localhost:8080/accounts/1?amount=500.0\n```\n\n---\n\n## 📊 Frontend Features\n\n### 🎨 **Modern UI Components**\n- **Glassmorphism Design** - Frosted glass aesthetic with backdrop blur\n- **Responsive Layout** - Works perfectly on desktop, tablet, and mobile\n- **Dark Theme** - Easy on the eyes for late-night financial planning\n- **Smooth Animations** - CSS transitions and JavaScript-powered effects\n\n### 📈 **Financial Analytics**\n- **Chart.js Integration** - Beautiful income and expense visualizations\n- **Real-time Updates** - Data refreshes automatically via AJAX calls\n- **Creator Metrics** - Specialized charts for creator economy insights\n- **Goal Progress Bars** - Animated progress indicators\n\n### 🎮 **Gamification Elements**\n```javascript\n// XP system that rewards financial activities\nfunction updateXP(points) {\n    currentXP += points;\n    checkLevelUp();\n    updateProgressBar();\n    if (points \u003e 50) createConfetti();\n}\n\n// Smart investment break-even analysis\nfunction calculateBreakEven(cost, monthlyBoost) {\n    const months = cost / monthlyBoost;\n    const roi = (monthlyBoost * 12 / cost) * 100;\n    return { months, roi };\n}\n```\n\n---\n\n## ☁️ Deployment\n\n### Heroku Deployment\nThe application is deployed on Heroku with the following configuration:\n\n- **Web Application**: https://finwise-springboot-app-665d5dc86747.herokuapp.com\n- **Database**: PostgreSQL add-on for production persistence\n- **Build**: Automatic deployment from GitHub main branch\n- **Environment**: Production profile with optimized settings\n\n### Deployment Commands\n```bash\n# Deploy to Heroku\ngit push heroku main\n\n# View logs\nheroku logs --tail\n\n# Check application status\nheroku ps\n```\n\n---\n\n## 🤝 Contributing\n\nWe welcome contributions! Here's how to get started:\n\n### 🚀 **Quick Contribution Guide**\n1. **Fork** the repository\n2. **Create** a feature branch: `git checkout -b feature/amazing-feature`\n3. **Commit** your changes: `git commit -m 'Add amazing feature'`\n4. **Push** to the branch: `git push origin feature/amazing-feature`\n5. **Open** a Pull Request\n\n\n## 🏆 Achievements \u0026 Milestones\n\n\u003cdiv align=\"center\"\u003e\n\n| Achievement | Description | Unlock Condition |\n|-------------|-------------|------------------|\n| 🏦 **Account Creator** | Create your first bank account | Create 1 account |\n| 💰 **First Deposit** | Make your first deposit | Add funds to account |\n| 📊 **Analytics Explorer** | View financial dashboard | Access analytics page |\n| 🎯 **Goal Setter** | Set your first financial goal | Create 1 goal |\n| 🚀 **Creator Level 5** | Reach Creator Master rank | Earn 2000+ XP |\n| ⚖️ **Smart Investor** | Use investment calculator | Calculate 1 ROI |\n\n\u003c/div\u003e\n\n---\n\n## 📄 License\n\nThis project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.\n\n```\nMIT License - Feel free to use, modify, and distribute!\nPerfect for learning, portfolio projects, and commercial use.\n```\n\n---\n\n## 🙏 Acknowledgments\n\n### 💫 **Built With Love By**\n- **[MK-2206](https://github.com/MK-2206)** - Full-stack development, Spring Boot architecture, UI/UX design\n\n---\n\n\n\n  \n### 💎 **Professional Creator Banking**\n\n*\"Transforming creator finances from chaos to success, one transaction at a time.\"*\n\n**[✨ Try FinWise Now](https://finwise-springboot-app-665d5dc86747.herokuapp.com)** | **[🔧 Contribute](https://github.com/MK-2206/FINWISE-APP/blob/main/CONTRIBUTING.md)** | **[📖 API Docs](https://github.com/MK-2206/FINWISE-APP/wiki)**\n\n---\n\n**FinWise Banking © 2025** - Built with 💜 for the creator economy\n\n\u003c/div\u003e\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmk-2206%2Ffinwise-app","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fmk-2206%2Ffinwise-app","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmk-2206%2Ffinwise-app/lists"}