{"id":30092884,"url":"https://github.com/btkcodedev/bolt.new_hackathon","last_synced_at":"2025-08-09T08:46:16.020Z","repository":{"id":302085499,"uuid":"1011181426","full_name":"btkcodedev/bolt.new_hackathon","owner":"btkcodedev","description":"PrintQuote Pro is my submission for the World's Largest Hackathon organized by bolt.new! This revolutionary 3D printing quote calculator combines cutting-edge AI insights with professional-grade cost analysis to solve real-world pricing challenges in the 3D printing industry.","archived":false,"fork":false,"pushed_at":"2025-06-30T13:13:31.000Z","size":140,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2025-06-30T14:21:53.947Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":"https://printquoter.netlify.app/","language":"TypeScript","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/btkcodedev.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-30T12:29:50.000Z","updated_at":"2025-06-30T13:13:35.000Z","dependencies_parsed_at":"2025-06-30T14:22:06.116Z","dependency_job_id":null,"html_url":"https://github.com/btkcodedev/bolt.new_hackathon","commit_stats":null,"previous_names":["btkcodedev/bolt.new_hackathon"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/btkcodedev/bolt.new_hackathon","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/btkcodedev%2Fbolt.new_hackathon","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/btkcodedev%2Fbolt.new_hackathon/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/btkcodedev%2Fbolt.new_hackathon/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/btkcodedev%2Fbolt.new_hackathon/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/btkcodedev","download_url":"https://codeload.github.com/btkcodedev/bolt.new_hackathon/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/btkcodedev%2Fbolt.new_hackathon/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":269553575,"owners_count":24437169,"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","status":"online","status_checked_at":"2025-08-09T02:00:10.424Z","response_time":111,"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":[],"created_at":"2025-08-09T08:46:15.281Z","updated_at":"2025-08-09T08:46:15.988Z","avatar_url":"https://github.com/btkcodedev.png","language":"TypeScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# 🚀 PrintQuote Pro\n\n\u003e **World's Largest Hackathon Submission by [bolt.new](https://bolt.new)**\n\n*Professional 3D printing quote calculator with AI-powered insights for accurate pricing and risk assessment*\n\n[![Hackathon Badge](https://img.shields.io/badge/Hackathon-World's%20Largest-ff6b35?style=for-the-badge\u0026logo=rocket)](https://bolt.new)\n[![Built with](https://img.shields.io/badge/Built%20with-bolt.new-4285f4?style=for-the-badge\u0026logo=google-chrome)](https://bolt.new)\n[![React](https://img.shields.io/badge/React-18.x-61dafb?style=for-the-badge\u0026logo=react)](https://reactjs.org/)\n[![TypeScript](https://img.shields.io/badge/TypeScript-5.x-3178c6?style=for-the-badge\u0026logo=typescript)](https://typescriptlang.org/)\n[![MIT License](https://img.shields.io/badge/License-MIT-green?style=for-the-badge)](LICENSE)\n\n---\n\n## 🎯 Hackathon Project Overview\n\n**PrintQuote Pro** is my submission for the **World's Largest Hackathon** organized by **bolt.new**! This revolutionary 3D printing quote calculator combines cutting-edge AI insights with professional-grade cost analysis to solve real-world pricing challenges in the 3D printing industry.\n\n### 🏆 Why This Project Stands Out\n- **🤖 AI-Powered Risk Assessment**: First-of-its-kind failure prediction system\n- **💰 Accurate Cost Modeling**: Professional-grade pricing calculations\n- **📊 Smart Analytics**: Real-time insights and recommendations\n- **🎨 Modern UI/UX**: Stunning interface with dark/light mode support\n- **📱 Mobile-First**: Responsive design that works everywhere\n- **⚡ Lightning Fast**: Built with Vite for optimal performance\n\n---\n\n## ✨ Features That Make a Difference\n\n### 🔧 Core Functionality\n- **📐 Precise Cost Calculations**: Material, power, labor, maintenance, and overhead costs\n- **🧠 AI Risk Assessment**: Intelligent print failure prediction with actionable recommendations\n- **🔄 Smart Material Suggestions**: Alternative filament recommendations with cost comparisons\n- **📄 Professional Exports**: Beautiful PDF quotes and shareable links\n- **💾 Quote Management**: Save, organize, and retrieve quotes with full history\n- **📱 Universal Access**: Fully responsive design optimized for all devices\n\n### 🎨 User Experience\n- **🌙 Theme Support**: Elegant dark/light mode toggle\n- **⚡ Real-time Updates**: Instant calculations as you type\n- **🎯 Intuitive Interface**: Clean, professional design using shadcn/ui\n- **📊 Visual Analytics**: Charts and graphs for better insights\n- **🔍 Advanced Search**: Quick quote lookup and filtering\n\n### 🚀 Technical Excellence\n- **⚡ Performance**: Optimized bundle with code splitting\n- **🔒 Type Safety**: Full TypeScript implementation\n- **📈 Analytics**: Comprehensive user behavior tracking\n- **🌐 SEO Optimized**: Full meta tags, structured data, and sitemap\n- **♿ Accessibility**: WCAG compliant with keyboard navigation\n\n---\n\n## 🛠️ Tech Stack \u0026 Architecture\n\n### Frontend Powerhouse\n```\n🔧 Framework: React 18 + TypeScript + Vite\n🎨 Styling: Tailwind CSS + shadcn/ui components\n📊 Charts: Recharts for beautiful data visualization\n🎭 Icons: Lucide React (1000+ icons)\n🎯 State: React Hooks + Context for clean state management\n```\n\n### Optional Integrations\n```\n🗄️ Database: Supabase (PostgreSQL) with real-time subscriptions\n📊 Analytics: Google Analytics 4 + Hotjar heatmaps\n📧 Email: EmailJS for quote sharing\n🔒 Auth: Supabase Auth (ready for multi-user)\n```\n\n### Development Tools\n```\n⚡ Build: Vite with HMR and optimized production builds\n🧪 Linting: ESLint + Prettier for code quality\n📦 Package Manager: npm with lock file optimization\n🔍 TypeScript: Strict mode with comprehensive type checking\n```\n\n---\n\n## 🚀 Quick Start Guide\n\n### 1. Clone \u0026 Install\n```bash\n# Clone the repository\ngit clone https://github.com/btkcodedev/printquote-pro.git\ncd printquote-pro\n\n# Install dependencies\nnpm install\n```\n\n### 2. Environment Setup\n```bash\n# Copy environment template\ncp .env.example .env.local\n```\n\n**Minimal Setup (No Database Required):**\n```env\nVITE_APP_NAME=PrintQuote Pro\nVITE_ENABLE_AI_INSIGHTS=true\nVITE_MOCK_DATA=true\nVITE_ENABLE_DATABASE=false\n```\n\n**Full Setup (Optional Database \u0026 Analytics):**\n```env\n# Core Settings\nVITE_APP_NAME=PrintQuote Pro\nVITE_ENABLE_AI_INSIGHTS=true\nVITE_MOCK_DATA=false\n\n# Database (Optional)\nVITE_ENABLE_DATABASE=true\nVITE_SUPABASE_URL=your_supabase_project_url\nVITE_SUPABASE_ANON_KEY=your_supabase_anon_key\n\n# Analytics (Optional)\nVITE_ENABLE_ANALYTICS=true\nVITE_GA_TRACKING_ID=G-XXXXXXXXXX\nVITE_HOTJAR_ID=your_hotjar_id\n```\n\n### 3. Launch Development Server\n```bash\n# Start the development server\nnpm run dev\n\n# Open http://localhost:5173 in your browser\n```\n\n### 4. Build for Production\n```bash\n# Create optimized production build\nnpm run build\n\n# Preview production build locally\nnpm run preview\n```\n\n---\n\n## 🗄️ Database Setup (Optional but Recommended)\n\n### Supabase Integration\n1. **Create Project**: Visit [supabase.com](https://supabase.com) and create a new project\n2. **Run Migrations**: Execute the SQL in `/supabase/migrations/` folder\n3. **Configure Environment**: Add your Supabase credentials to `.env.local`\n4. **Enable Features**: Set `VITE_ENABLE_DATABASE=true`\n\n### Database Schema\n```sql\n-- Quotes table for saving user quotes\nquotes (\n  id uuid primary key,\n  name text,\n  print_time integer,\n  filament_type text,\n  cost_breakdown jsonb,\n  ai_insights jsonb,\n  created_at timestamp,\n  updated_at timestamp\n)\n```\n\n**🎯 Pro Tip**: The app works perfectly without a database using intelligent mock data!\n\n---\n\n## 🌐 Deployment Options\n\n### One-Click Deployments\n\n#### Netlify\n```bash\n# Build command\nnpm run build\n\n# Publish directory\ndist\n```\n\n#### Vercel\n```bash\n# Framework preset: Vite\n# Root directory: ./\n# Build command: npm run build\n# Output directory: dist\n```\n\n#### GitHub Pages\n```bash\n# Build and deploy to gh-pages branch\nnpm run build\nnpm run deploy\n```\n\n### Manual Deployment\n1. Run `npm run build`\n2. Upload `dist/` folder to your hosting service\n3. Configure server to serve `index.html` for all routes (SPA)\n\n---\n\n## 🎨 Customization \u0026 Branding\n\n### Theme Customization\n```css\n/* Update CSS variables in src/index.css */\n:root {\n  --primary: your-brand-color;\n  --secondary: your-accent-color;\n  /* Full customization available */\n}\n```\n\n### Environment Configuration\n```typescript\n// Modify src/config/env.ts\nexport const env = {\n  APP_NAME: process.env.VITE_APP_NAME || 'Your App Name',\n  ENABLE_AI_INSIGHTS: process.env.VITE_ENABLE_AI_INSIGHTS === 'true',\n  // Add your custom features\n}\n```\n\n---\n\n## 📊 Analytics \u0026 Performance\n\n### Built-in Analytics\n- **User Interactions**: Quote calculations, filament swaps, exports\n- **Performance Metrics**: Load times, render performance\n- **Conversion Tracking**: Quote completions, PDF downloads\n- **Error Monitoring**: Comprehensive error tracking\n\n### Performance Optimizations\n- **Code Splitting**: Lazy loading for optimal bundle size\n- **Image Optimization**: WebP support with fallbacks\n- **Caching Strategy**: Aggressive caching for static assets\n- **Bundle Analysis**: Webpack bundle analyzer included\n\n---\n\n## 🤝 Contributing to the Hackathon Project\n\nI welcome contributions to make this hackathon project even better!\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### Contribution Guidelines\n- Follow the existing code style (ESLint + Prettier)\n- Add TypeScript types for all new features\n- Include tests for new functionality\n- Update documentation as needed\n- Keep commits atomic and well-described\n\n---\n\n## 📝 License \u0026 Attribution\n\n**MIT License** - Created with ❤️ by [btkcodedev](https://github.com/btkcodedev)\n\nThis project was built for the **World's Largest Hackathon** by **bolt.new**. Feel free to use, modify, and distribute according to the MIT license.\n\n---\n\n## 🎯 Hackathon Judging Criteria\n\n### Innovation \u0026 Creativity ✨\n- **AI-Powered Risk Assessment**: Revolutionary failure prediction system\n- **Smart Cost Modeling**: Industry-first comprehensive pricing calculator\n- **Real-time Insights**: Dynamic recommendations and optimizations\n\n### Technical Excellence 🛠️\n- **Modern Architecture**: React 18 + TypeScript + Vite\n- **Performance Optimized**: Lightning-fast load times and interactions\n- **Scalable Design**: Modular architecture ready for enterprise use\n\n### User Experience 🎨\n- **Intuitive Interface**: Clean, professional design\n- **Mobile-First**: Responsive across all devices\n- **Accessibility**: WCAG compliant with keyboard navigation\n\n### Real-World Impact 🌍\n- **Industry Problem**: Solves actual pricing challenges in 3D printing\n- **Professional Grade**: Ready for commercial use\n- **Cost Savings**: Helps businesses optimize their pricing strategies\n\n---\n\n## 🚀 Live Demo \u0026 Links\n\n- **🌐 Live Demo**: [Your deployment URL]\n- **📹 Demo Video**: [Your demo video]\n- **📊 Project Stats**: [GitHub insights]\n- **🐛 Issues**: [GitHub Issues](https://github.com/btkcodedev/printquote-pro/issues)\n\n---\n\n## 🏆 Hackathon Achievement\n\n**\"Built with bolt.new for the World's Largest Hackathon\"**\n\nThis project represents the culmination of modern web development practices, AI integration, and user-centered design. It's not just a tool—it's a solution that addresses real industry challenges while showcasing cutting-edge technology.\n\n**Vote for innovation. Vote for PrintQuote Pro! 🚀**\n\n---\n\n*Made with ❤️ and lots of ☕ by [btkcodedev](https://github.com/btkcodedev)*","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fbtkcodedev%2Fbolt.new_hackathon","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fbtkcodedev%2Fbolt.new_hackathon","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fbtkcodedev%2Fbolt.new_hackathon/lists"}