{"id":30060791,"url":"https://github.com/itaxbox/code-forge","last_synced_at":"2026-04-20T03:32:45.153Z","repository":{"id":304322528,"uuid":"842535089","full_name":"ITAXBOX/Code-Forge","owner":"ITAXBOX","description":"Code Forge: AI-Powered Full-Stack App Generator","archived":false,"fork":false,"pushed_at":"2025-07-12T09:49:39.000Z","size":8339,"stargazers_count":1,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-08-08T01:47:10.045Z","etag":null,"topics":["automation","deepseek","java","problem-solving","regex","spring-boot","typescript"],"latest_commit_sha":null,"homepage":"","language":"Java","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/ITAXBOX.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":"2024-08-14T14:47:56.000Z","updated_at":"2025-07-12T09:49:42.000Z","dependencies_parsed_at":"2025-07-12T11:58:01.505Z","dependency_job_id":null,"html_url":"https://github.com/ITAXBOX/Code-Forge","commit_stats":null,"previous_names":["itaxbox/code-forge"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/ITAXBOX/Code-Forge","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ITAXBOX%2FCode-Forge","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ITAXBOX%2FCode-Forge/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ITAXBOX%2FCode-Forge/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ITAXBOX%2FCode-Forge/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/ITAXBOX","download_url":"https://codeload.github.com/ITAXBOX/Code-Forge/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ITAXBOX%2FCode-Forge/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":32031570,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-04-20T00:18:06.643Z","status":"online","status_checked_at":"2026-04-20T02:00:06.527Z","response_time":94,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"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":["automation","deepseek","java","problem-solving","regex","spring-boot","typescript"],"created_at":"2025-08-08T01:47:10.361Z","updated_at":"2026-04-20T03:32:45.109Z","avatar_url":"https://github.com/ITAXBOX.png","language":"Java","funding_links":[],"categories":[],"sub_categories":[],"readme":"# 🏆Code Forge: AI-Powered Full-Stack App Generator\n\n\u003cdiv align=\"center\"\u003e\n\n![Code Forge Homepage](docs/images/HOME%20PAGE.gif)\n\n**🥇 Best AI Graduation Project Award – Spring 2025**  \n***Al Maaref University***\n\n[![Java](https://img.shields.io/badge/Java-22-orange?style=for-the-badge\u0026logo=java)](https://www.oracle.com/java/)\n[![Spring Boot](https://img.shields.io/badge/Spring%20Boot-3.3.2-brightgreen?style=for-the-badge\u0026logo=springboot)](https://spring.io/projects/spring-boot)\n[![Next.js](https://img.shields.io/badge/Next.js-14-black?style=for-the-badge\u0026logo=next.js)](https://nextjs.org/)\n[![AI](https://img.shields.io/badge/AI%20Powered-DeepSeek-blue?style=for-the-badge\u0026logo=openai)](https://www.deepseek.com/)\n[![TypeScript](https://img.shields.io/badge/TypeScript-5.0-blue?style=for-the-badge\u0026logo=typescript)](https://www.typescriptlang.org/)\n[![Award](https://img.shields.io/badge/🏆%20Best%20AI%20Project-2025-gold?style=for-the-badge)](https://www.maaref.edu.lb/)\n\n\u003c/div\u003e\n\n---\n\n## 🚀 Introduction\n\n\u003e **\"Precision at the speed of thought. That's how Code Forge works.\"**\n\nCode Forge is a **revolutionary AI-powered full-stack application generator** that transforms your ideas into production-ready applications in **just one minute**! This award-winning graduation project represents the pinnacle of modern software engineering, leveraging cutting-edge artificial intelligence to completely automate the development process, from sophisticated backend APIs to responsive, interactive frontend interfaces.\n\n**🎯 The Power of Code Forge:**\n- ⚡ **Full-Stack Generation in 60 seconds**\n- 🤖 **AI-Driven Architecture Design**\n- 🏗️ **Production-Ready Code Output**\n- 🔗 **Intelligent Entity Relationships**\n- 🎨 **Beautiful, Modern UI Components**\n\n---\n\n## 🎯 The Critical Problem We Solved\n\n### 💔 The Development Crisis\nWe believe that building full-stack applications shouldn't be a barrier to innovation. However, traditional development faces **critical bottlenecks** that stifle creativity and progress:\n\n❌ **Time-Consuming Development** – Developers waste **days or weeks** writing repetitive boilerplate code before they can even start building real business features\n\n❌ **Error-Prone Manual Setup** – Manual project configuration leads to bugs, inconsistent architecture, and endless debugging sessions\n\n❌ **Innovation Bottleneck** – Countless brilliant ideas never see the light of day because of overwhelming technical overhead and setup complexity\n\n❌ **Knowledge Barriers** – Junior developers struggle with complex configurations while senior developers get bogged down in repetitive tasks\n\n### ✅ Our Revolutionary Solution\n\n**Code Forge eliminates these pain points by automating the heavy lifting, empowering developers to focus on what matters most: Innovation and Business Logic.**\n\n🚀 **Instant Generation** – Complete, tested full-stack applications generated in under 60 seconds  \n🎯 **AI-Driven Precision** – Intelligent entity relationships, optimized database schemas, and clean architecture  \n🏆 **Production-Ready Output** – Scalable, maintainable code that follows industry best practices  \n🔧 **Zero Configuration** – No setup required, just describe your idea and watch it come to life  \n\n---\n\n## 🏆 Project Achievements \u0026 Milestones\n\nOur development journey was a testament to perseverance, innovation, and technical excellence. Each milestone represents months of intensive research, development, and refinement:\n\n### 🏗️ Part 1: Foundation Architecture \u0026 Core Generation Engine\n![Milestone 1](docs/images/Milestone1.png)\n\n**What We Achieved:**\n- ✅ **Advanced Spring Boot Project Structure Generation** - Automated creation of enterprise-grade project architectures with proper package organization\n- ✅ **Intuitive Entity Creation Interface** - User-friendly web interface for defining complex business entities with real-time validation\n- ✅ **Dynamic Attribute Definition System** - Flexible attribute system supporting multiple data types, validations, and constraints\n- ✅ **Intelligent CRUD Operations Generation** - Automated creation of Create, Read, Update, Delete operations with proper error handling and validation\n\n**Technical Impact:** This milestone laid the foundation for scalable code generation, establishing the core architecture that would support advanced AI integration.\n\n### 🔐 Part 2: AI Revolution \u0026 Security Integration\n![Milestone 2](docs/images/Milestone2.png)\n\n**What We Achieved:**\n- ✅ **Enterprise-Grade Authentication \u0026 Authorization** - Complete JWT-based security system with role-based access control\n- ✅ **Advanced JSON Parsing Engine** - Robust parsing system capable of handling complex, nested entity definitions from AI responses\n- ✅ **Sophisticated Prompt Engineering** - Meticulously crafted AI prompts that consistently generate high-quality, production-ready code\n- ✅ **DeepSeek AI Integration** - Seamless integration with state-of-the-art AI models for intelligent code generation and entity relationship inference\n\n**Technical Impact:** This milestone transformed Code Forge from a simple generator into an intelligent AI-powered development assistant.\n\n### 🎨 Part 3: Advanced Features \u0026 Complete Integration\n![Milestone 3](docs/images/Milestone3.png)\n\n**What We Achieved:**\n- ✅ **Advanced Behavioral Services Implementation** - Generated services with complex business logic, transaction management, and error handling\n- ✅ **Professional Dashboard Template Creation** - Modern, responsive dashboard templates with advanced UI components\n- ✅ **Seamless Frontend-Backend Integration** - Complete integration between generated APIs and frontend interfaces with real-time data binding\n- ✅ **Interactive Project Leaderboard System** - Gamification features to track and showcase development achievements\n\n**Technical Impact:** This milestone completed the vision of a truly comprehensive full-stack generator capable of producing enterprise-level applications.\n\n![Project Leaderboard](docs/images/THE%20LEADERBOARD.gif)\n\n---\n\n## 💪 Technical Challenges Overcome - The Real Engineering Pain\n\n![Technical Challenges](docs/images/challenges.png)\n\nThe development of Code Forge required overcoming some of the most complex technical challenges in modern software engineering. These weren't just coding problems, they were fundamental computer science challenges that pushed the boundaries of what's possible:\n\n### 🔗 **Entity Relationships Handling from AI**\n**The Pain:** AI models don't naturally understand complex database relationships. Getting DeepSeek to generate proper foreign keys, join tables, and cascade operations was like teaching a brilliant mathematician to become a database architect.\n\n**Our Solution:** We developed a sophisticated relationship inference engine that:\n- Parses natural language descriptions into formal relationship definitions\n- Automatically generates proper foreign key constraints\n- Creates intelligent cascade operations based on business logic\n- Validates relationship integrity across complex entity hierarchies\n\n### 📊 **Advanced JSON Parsing**\n**The Pain:** AI responses are unpredictable. Sometimes DeepSeek returns perfect JSON, sometimes malformed structures, sometimes valid JSON with unexpected nesting. Traditional parsing fails catastrophically.\n\n**Our Solution:** We built a resilient parsing system that:\n- Handles malformed JSON with intelligent error correction\n- Adapts to varying response structures dynamically\n- Maintains data integrity even with partial failures\n- Provides meaningful fallbacks for corrupted responses\n\n### 🔍 **Complex Regular Expressions**\n**The Pain:** Code generation requires parsing and manipulating thousands of lines of generated code with surgical precision. One wrong regex pattern could corrupt entire projects.\n\n**Our Solution:** We engineered battle-tested regex patterns that:\n- Handle edge cases in generated code structures\n- Support multiple programming languages and frameworks\n- Maintain code formatting and style consistency\n- Enable safe code injection without breaking existing functionality\n\n### 🎯 **Prompt Engineering Excellence**\n**The Pain:** Getting consistent, high-quality responses from AI models is an art form. Poor prompts lead to inconsistent code, missing features, or complete generation failures.\n\n**Our Solution:** We developed a comprehensive prompt engineering framework:\n- Context-aware prompts that adapt to project complexity\n- Multi-stage prompt chains for complex generation tasks\n- Validation loops that ensure output quality\n- Fallback strategies for edge cases\n\n### 🌐 **Generic Frontend Integration**\n**The Pain:** Creating frontend components that work seamlessly with ANY generated backend API is like building a universal translator for programming languages.\n\n**Our Solution:** We architected a universal frontend system:\n- Dynamic component generation based on API schemas\n- Automatic form validation based on backend constraints\n- Responsive layouts that adapt to any data structure\n- Real-time API integration with intelligent error handling\n\n### 📁 **High-Performance File I/O Operations**\n**The Pain:** Generating entire projects requires creating hundreds of files, directories, and configurations simultaneously while maintaining consistency and avoiding conflicts.\n\n**Our Solution:** We implemented an enterprise-grade file management system:\n- Atomic file operations to prevent corruption\n- Intelligent conflict resolution for existing projects\n- Optimized I/O operations for large project generation\n- Comprehensive backup and rollback mechanisms\n\n---\n\n## 📊 System Architecture \u0026 Use Cases\n\n### 🏗️ Complete System Architecture\n![General Use Case](docs/use%20case%20diagram/general_use_case.png)\n\nOur architecture follows enterprise-grade patterns with clear separation of concerns, ensuring scalability and maintainability.\n\n### 🔄 Detailed Generation Workflow\n![Detailed Generation Method](docs/use%20case%20diagram/detailed_generation_method.png)\n\nThe generation process involves sophisticated AI orchestration, ensuring every component is perfectly integrated.\n\n### 🎯 Extended Use Case Scenarios\n![General Use Case 2](docs/use%20case%20diagram/general_use_case_2.png)\n\nCode Forge handles complex scenarios from simple CRUD applications to enterprise-level systems with multiple integrations.\n\n---\n\n## 🗄️ Intelligent Database Integration\n\nCode Forge automatically generates optimized database schemas with proper relationships, constraints, and performance considerations.\nHere's an example of a gym website database generated by Code Forge:\n![Database Example](docs/database/output_database_example.png)\n\n**What Code Forge Creates:**\n- **Normalized Database Structure** - Eliminates redundancy and ensures data integrity\n- **Intelligent Relationships** - Proper foreign keys, indexes, and constraints\n- **Performance Optimization** - Strategic indexing and query optimization\n- **Scalable Schema Design** - Built to handle growth and evolution\n\n---\n\n## 🎬 Live Demo: Building a Samsung Website\n\nWatch Code Forge in action as it generates a complete Samsung website:\n\n### Step 1: Entity Definition\n![Demo 1](docs/demo/demo_1_entity_name_entry_page.gif)\n*Intuitive interface for defining business entities with real-time validation*\n\n### Step 2: Generation Configuration\n![Demo 2](docs/demo/demo_2_generation_choice_selection.gif)\n*Flexible options for customizing the generated application*\n\n### Step 3: AI-Powered Generation\n![Demo 3](docs/demo/demo_3_loading.gif)\n*Watch as AI generates thousands of lines of production-ready code*\n\n### Step 4: Generated Backend API\n![Demo 4](docs/demo/demo_4_backend_output.png)\n\n*Complete Spring Boot backend with RESTful APIs, security, and documentation*\n\n### Step 5: Dynamic Frontend Creation\n![Demo 5](docs/demo/demo_5_frontend_output.gif)\n*Modern, responsive React frontend with complete CRUD operations*\n\n### Step 6: Entity Management Dashboard\n![Demo 6](docs/demo/demo_6_entites_dashboard.png)\n*Professional dashboard for managing all generated entities and relationships*\n\n---\n\n## 🛠️ Technology Stack\n\n### Backend Powerhouse\n- **Java 22** - Latest LTS with performance optimizations\n- **Spring Boot 3.3.2** - Enterprise-grade framework with security\n- **Spring Security** - JWT authentication and authorization\n- **JPA/Hibernate** - Advanced ORM with relationship management\n- **Maven** - Dependency management and build automation\n\n### Frontend Excellence\n- **Next.js 14** - React framework with SSR and optimal performance\n- **TypeScript** - Type-safe development with enhanced developer experience\n- **Tailwind CSS** - Utility-first CSS for rapid UI development\n- **React Hook Form** - Performant forms with validation\n- **Recharts** - Beautiful, responsive data visualizations\n\n### AI Integration\n- **DeepSeek API** - State-of-the-art language model for code generation\n- **Custom Prompt Engineering** - Optimized prompts for consistent output\n- **JSON Schema Validation** - Robust parsing and validation system\n\n---\n\n## 🚀 Getting Started\n\n### Prerequisites\n- **Java 22+** \n- **Node.js 18+**\n- **Maven 3.9+**\n- **Git**\n\n### Quick Start\n```bash\n# Clone the repository\ngit clone https://github.com/yourusername/code-forge.git\ncd code-forge\n\n# Start the backend\n./mvnw spring-boot:run\n\n# Start the frontend dashboard\ncd \"Code Forge Dashboard\"\nnpm install\nnpm run dev\n```\n\n### Access the Application\n- **Main Application:** `http://localhost:8080`\n- **Dashboard:** `http://localhost:3000`\n---\n\n## 🎓 Academic Recognition \u0026 Certification\n\n\u003cdiv align=\"center\"\u003e\n\n![Code Forge Certificate](docs/certificate/codeforge_certificate.jpg)\n\n**🏆 Best AI Graduation Project Award – Spring 2025**  \n***Al Maaref University***\n\n*This certificate recognizes the exceptional innovation, technical excellence, and practical impact of Code Forge in advancing the field of AI-powered software development. The project demonstrates mastery of cutting-edge technologies, sophisticated problem-solving abilities, and the potential to transform how developers approach full-stack application development.*\n\n---\n\n**Project Supervisor:** Dr. Muhamad Mubarak  \n**Academic Year:** 2024-2025  \n**Graduation Date:** Spring 2025  \n**Award Category:** Best AI Innovation Project\n\n\u003c/div\u003e\n\n---\n\n## 🤝 Contributing\n\nWe welcome contributions from the community! Code Forge represents the future of development tools, and we're excited to collaborate with fellow innovators.\n\n### How to Contribute\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\n## 📄 License\n\nThis project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.\n\n---\n\n## 🙏 Acknowledgments\n\n- **Al Maaref University** for providing the academic environment that fostered innovation\n- **Dr. Muhamad Mubarak** for invaluable guidance and mentorship\n- **DeepSeek** for providing cutting-edge AI capabilities\n- **The Open Source Community** for the tools and frameworks that made this possible\n\n---\n\n\u003cdiv align=\"center\"\u003e\n\n**Code Forge - Where Ideas Become Reality in 60 Seconds** ⚡\n\n*Built with ❤️ by a passionate computer science graduate*\n\n[🌟 Star this repository](https://github.com/ITAXBOX/Code-Forge)\n\n\u003c/div\u003e\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fitaxbox%2Fcode-forge","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fitaxbox%2Fcode-forge","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fitaxbox%2Fcode-forge/lists"}