A comprehensive freelance management platform built with Next.js, Supabase, and modern web technologies.
FreelancerOS revolutionizes how freelancers manage their business by providing a unified platform for proposal generation, project management, and client communication. Built entirely with Bolt.new for the World's Largest Hackathon 2025.
- 🤖 Smart Proposal Generation - Create professional proposals with customizable templates
- 📊 Project Management - Milestone-driven tracking with progress visualization
- 🔗 Secure Client Portals - Auto-generated portals for real-time project visibility
- ⏱️ Time Tracking - Manual entry with project/task association
- 📈 Analytics Dashboard - Comprehensive insights and conversion metrics
- 🎨 Clean Design - Monochrome aesthetic with light/dark theme support
- Frontend: Next.js 14 with TypeScript and App Router
- Backend: Supabase (Auth, Database, Real-time)
- UI: shadcn/ui components with TailwindCSS
- State Management: Zustand
- Deployment: Netlify
- Development: Bolt.new
- Node.js 18+ and npm
- Supabase account
- Netlify account (for deployment)
-
Clone the repository
git clone https://github.com/thenew-programer/freelanceros.git cd freelanceros -
Install dependencies
npm install
-
Environment Setup
cp .env.example .env.local
Fill in your Supabase credentials:
NEXT_PUBLIC_SUPABASE_URL=your_supabase_url NEXT_PUBLIC_SUPABASE_ANON_KEY=your_supabase_anon_key STRIPE_SECRET_KEY=your_stripe_key
-
Database Setup
# Run Supabase migrations (if available) npx supabase db reset -
Start Development Server
npx next dev
Open http://localhost:3000 in your browser.
FreelancerOS uses a clean monochrome design system:
- Colors: Black, white, and gray scale variants
- Components: shadcn/ui with custom black/white theme
- Typography: Clean, readable fonts with proper contrast
- Layout: Minimalist design focusing on content hierarchy
- Supabase Auth with email/password and social providers
- Row Level Security (RLS) for multi-tenant data isolation
- Secure client portals with link-based access (no signup required)
- Customizable templates for different project types
- Technical recommendations and scope definition
- Professional formatting with branding options
- Convert proposals to trackable projects
- Milestone-based progress tracking
- Task management with time association
- Auto-generated secure links for each project
- Real-time progress updates
- File sharing and communication
- Proposal conversion rates
- Project profitability tracking
- Client engagement metrics
-
Connect Repository
- Link your GitHub repository to Netlify
- Configure build settings:
npm run build
-
Environment Variables
NEXT_PUBLIC_SUPABASE_URL=your_supabase_url NEXT_PUBLIC_SUPABASE_ANON_KEY=your_supabase_anon_key STRIPE_SECRET_KEY=your_stripe_key -
Deploy
- Automatic deployments on git push
- Preview deployments for pull requests
Contributions are welcome! Please feel free to submit a Pull Request.
- Fork the project
- Create your feature branch (
git checkout -b feature/AmazingFeature) - Commit your changes (
git commit -m 'Add some AmazingFeature') - Push to the branch (
git push origin feature/AmazingFeature) - Open a Pull Request
This project was built for the World's Largest Hackathon 2025 presented by Bolt. It demonstrates:
- Complete application built with Bolt.new
- Integration with Supabase for backend services
- Deployment on Netlify
- Real-world utility for freelancers
- Professional design and user experience
This project is licensed under the MIT License - see the LICENSE file for details.
- Built with Bolt.new - AI-powered development platform
- Supabase - Backend as a Service
- shadcn/ui - Beautiful component library
- Next.js - React framework
- Netlify - Deployment platform
Built by [Joseph Bouryal] - @youssef_bouryal
Project Link: https://github.com/thenew-programer/freelanceros
Live Demo: https://freelanceros.netlify.app
⭐ If you find this project useful, please give it a star! ⭐