{"id":29928798,"url":"https://github.com/tanishpoddar/freelancehub","last_synced_at":"2025-08-02T14:11:23.468Z","repository":{"id":304603191,"uuid":"1019298483","full_name":"tanishpoddar/FreelanceHub","owner":"tanishpoddar","description":"A modern, responsive portfolio showcase platform built with Flask that helps freelancers create stunning portfolios, connect with clients, and grow their freelance business.","archived":false,"fork":false,"pushed_at":"2025-07-14T05:51:31.000Z","size":109,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2025-07-14T07:48:48.088Z","etag":null,"topics":["backend","flask","python"],"latest_commit_sha":null,"homepage":"","language":"HTML","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"gpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/tanishpoddar.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE","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-07-14T05:50:04.000Z","updated_at":"2025-07-14T05:51:34.000Z","dependencies_parsed_at":"2025-07-14T07:48:53.513Z","dependency_job_id":"d27980ee-e055-496d-946c-e492c7b4f6f9","html_url":"https://github.com/tanishpoddar/FreelanceHub","commit_stats":null,"previous_names":["tanishpoddar/freelancehub"],"tags_count":null,"template":false,"template_full_name":null,"purl":"pkg:github/tanishpoddar/FreelanceHub","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/tanishpoddar%2FFreelanceHub","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/tanishpoddar%2FFreelanceHub/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/tanishpoddar%2FFreelanceHub/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/tanishpoddar%2FFreelanceHub/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/tanishpoddar","download_url":"https://codeload.github.com/tanishpoddar/FreelanceHub/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/tanishpoddar%2FFreelanceHub/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":268401594,"owners_count":24244464,"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-02T02:00:12.353Z","response_time":74,"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":["backend","flask","python"],"created_at":"2025-08-02T14:11:16.372Z","updated_at":"2025-08-02T14:11:23.444Z","avatar_url":"https://github.com/tanishpoddar.png","language":"HTML","funding_links":[],"categories":[],"sub_categories":[],"readme":"# FreelanceHub 🚀\n\n**Your Gateway to Freelance Success**\n\n\u003e **License:** This project is licensed under the GNU General Public License v3.0 (GPLv3). See the [LICENSE](LICENSE) file for details.\n\nA modern, responsive portfolio showcase platform built with Flask that helps freelancers create stunning portfolios, connect with clients, and grow their freelance business.\n\n![FreelanceHub](https://img.shields.io/badge/FreelanceHub-Your%20Gateway%20to%20Freelance%20Success-blue?style=for-the-badge\u0026logo=freelance)\n\n## ✨ Features\n\n### 🎨 **Professional Portfolio Creation**\n- Drag-and-drop portfolio editor\n- Customizable themes and layouts\n- Professional project showcase\n- Skills and testimonials management\n- Real-time preview and editing\n\n### 🔍 **Advanced Search \u0026 Discovery**\n- Smart search functionality\n- Category-based filtering\n- Sort by popularity, date, or name\n- Responsive grid layouts\n- SEO-optimized portfolio pages\n\n### 📊 **Analytics \u0026 Insights**\n- Portfolio view tracking\n- Visitor analytics\n- Performance insights\n- Engagement metrics\n- Real-time statistics\n\n### 💬 **Client Communication**\n- Integrated contact forms\n- Email notifications\n- Inquiry management\n- Professional messaging system\n\n### 🎯 **SEO \u0026 Marketing**\n- SEO-optimized pages\n- Open Graph meta tags\n- Twitter Card support\n- Google Analytics integration\n- Social media sharing\n\n### 📱 **Responsive Design**\n- Mobile-first approach\n- Cross-device compatibility\n- Touch-friendly interface\n- Progressive Web App features\n\n### 🔐 **Security \u0026 Authentication**\n- Secure user authentication\n- CSRF protection\n- Password reset functionality\n- Admin panel with moderation tools\n\n## 🛠️ Tech Stack\n\n### Backend\n- **Flask** - Python web framework\n- **SQLAlchemy** - ORM for database management\n- **SQLite** - Lightweight database (production-ready alternatives supported)\n- **Flask-Login** - User session management\n- **Flask-WTF** - Form handling and CSRF protection\n- **Flask-Mail** - Email functionality\n\n### Frontend\n- **HTML5** - Semantic markup\n- **CSS3** - Modern styling with custom properties\n- **JavaScript (ES6+)** - Interactive functionality\n- **Tailwind CSS** - Utility-first CSS framework\n- **Inter Font** - Modern typography\n\n### Features\n- **Custom Scrollbar** - Beautiful gradient scrollbar\n- **Animations** - Smooth transitions and micro-interactions\n- **Glass Morphism** - Modern UI effects\n- **Dark Mode Support** - System preference detection\n- **Accessibility** - WCAG compliant design\n\n## 🚀 Quick Start\n\n### Prerequisites\n- Python 3.8+\n- pip (Python package installer)\n\n### Installation\n\n1. **Clone the repository**\n   ```bash\n   git clone https://github.com/yourusername/freelancehub.git\n   cd freelancehub\n   ```\n\n2. **Create a virtual environment**\n   ```bash\n   python -m venv venv\n   \n   # On Windows\n   venv\\Scripts\\activate\n   \n   # On macOS/Linux\n   source venv/bin/activate\n   ```\n\n3. **Install dependencies**\n   ```bash\n   pip install -r requirements.txt\n   ```\n\n4. **Set up environment variables**\n   ```bash\n   # Create a .env file\n   cp .env.example .env\n   \n   # Edit .env with your configuration\n   SECRET_KEY=your-secret-key-here\n   FLASK_ENV=development\n   ```\n\n5. **Initialize the database**\n   ```bash\n   flask init-db\n   ```\n\n6. **Create admin user**\n   ```bash\n   flask create-admin\n   ```\n\n7. **Run the application**\n   ```bash\n   python app/app.py\n   ```\n\n8. **Access the application**\n   - Open your browser and go to `http://127.0.0.1:5000`\n   - Admin panel: `http://127.0.0.1:5000/admin`\n   - Default admin credentials: `admin@freelancehub.com` / `admin123`\n\n## 📁 Project Structure\n\n```\nfreelance-portfolio/\n├── app/\n│   ├── app.py              # Flask application factory\n│   ├── config.py           # Configuration settings\n│   ├── models.py           # Database models\n│   ├── forms.py            # Form definitions\n│   ├── routes/             # Route blueprints\n│   │   ├── main.py         # Main routes (home, browse)\n│   │   ├── auth.py         # Authentication routes\n│   │   ├── portfolio.py    # Portfolio management\n│   │   ├── admin.py        # Admin panel\n│   │   └── api.py          # API endpoints\n│   └── services/           # Business logic\n│       └── email_service.py\n├── static/\n│   ├── css/\n│   │   ├── custom.css      # Custom styles\n│   │   └── portfolio-editor.css\n│   ├── js/\n│   │   └── main.js         # Main JavaScript\n│   └── uploads/            # File uploads\n├── templates/\n│   ├── base.html           # Base template\n│   ├── index.html          # Homepage\n│   ├── auth/               # Authentication templates\n│   ├── portfolio/          # Portfolio templates\n│   └── admin/              # Admin templates\n├── migrations/             # Database migrations\n├── requirements.txt        # Python dependencies\n└── README.md              # This file\n```\n\n## 🎨 Customization\n\n### Styling\nThe application uses a comprehensive CSS system with:\n- CSS Custom Properties for theming\n- Tailwind CSS for utility classes\n- Custom animations and transitions\n- Responsive design patterns\n\n### Branding\nUpdate the branding in `app/config.py`:\n```python\nSITE_NAME = 'Your Brand Name'\nSITE_DESCRIPTION = 'Your site description'\nSITE_KEYWORDS = 'your, keywords, here'\n```\n\n### Colors\nModify the color scheme in `static/css/custom.css`:\n```css\n:root {\n    --primary-500: #your-color;\n    --primary-600: #your-color;\n    /* ... more colors */\n}\n```\n\n## 🔧 Configuration\n\n### Environment Variables\n- `SECRET_KEY` - Flask secret key\n- `FLASK_ENV` - Environment (development/production)\n- `DATABASE_URL` - Database connection string\n- `MAIL_SERVER` - SMTP server settings\n- `GOOGLE_ANALYTICS_ID` - Google Analytics tracking ID\n\n### Database\nThe application supports multiple database backends:\n- **SQLite** (default) - Great for development\n- **PostgreSQL** - Recommended for production\n- **MySQL** - Alternative production option\n\n## 📊 Analytics\n\nFreelanceHub includes comprehensive analytics:\n- Portfolio view tracking\n- User engagement metrics\n- Search analytics\n- Performance monitoring\n\n## 🔒 Security Features\n\n- CSRF protection on all forms\n- Secure password hashing\n- Input validation and sanitization\n- SQL injection prevention\n- XSS protection\n\n## 🌐 Deployment\n\n### Production Deployment\n1. Set `FLASK_ENV=production`\n2. Use a production database (PostgreSQL recommended)\n3. Configure a production WSGI server (Gunicorn)\n4. Set up reverse proxy (Nginx)\n5. Configure SSL certificates\n6. Set up monitoring and logging\n\n### Docker Deployment\n```bash\n# Build the image\ndocker build -t freelancehub .\n\n# Run the container\ndocker run -p 5000:5000 freelancehub\n```\n\n## 🤝 Contributing\n\nWe welcome contributions! Please see our [Contributing Guidelines](CONTRIBUTING.md) for details.\n\n### Development Setup\n1. Fork the repository\n2. Create a feature branch\n3. Make your changes\n4. Add tests\n5. Submit a pull request\n\n## 📝 License\n\nThis project is licensed under the GNU General Public License v3.0 (GPLv3) - see the [LICENSE](LICENSE) file for details.\n\n## 📞 Support\n\n- **Issues**: [GitHub Issues](https://github.com/tanishpoddar/freelancehub/issues)\n\n## 🚀 Roadmap\n\n- [ ] Advanced portfolio themes\n- [ ] Client dashboard\n- [ ] Payment integration\n- [ ] Mobile app\n- [ ] AI-powered recommendations\n- [ ] Multi-language support\n- [ ] Advanced analytics\n- [ ] API documentation\n\n---\n\n**Made with ❤️ by [Tanish Poddar](https://tanish-poddar.is-a.dev/)**\n\n*Your Gateway to Freelance Success* ","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ftanishpoddar%2Ffreelancehub","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Ftanishpoddar%2Ffreelancehub","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ftanishpoddar%2Ffreelancehub/lists"}