Open-source collaboration meets freelance opportunity.
Live Demo · Report a Bug · Request a Feature · Product Roadmap
🚧 Status: Active Development — v1.0 in progress. Core features are implemented; contributions are welcome.
For full technical details, setup instructions, and architecture, visit our Documentation Hub.
- Architecture Overview
- Database Schema
- Local Setup & Pre-requisites
- API & Edge Functions
- Product Roadmap (PRD)
Developers today juggle fragmented workflows — discovering open-source projects on GitHub, finding freelance gigs on Upwork, and managing teams on Slack. Colabs unifies all of this into one platform.
Colabs connects developers with open-source projects, freelance gigs, and collaborative teams. It bridges GitHub-based open-source contribution with a structured freelance marketplace — enabling developers to discover projects, claim issues, submit proposals, and earn, all from a single dashboard backed by their real GitHub activity.
| Persona | What they get |
|---|---|
| Developer / Contributor | Discover projects and gigs matching their skills, claim GitHub issues, track progress, and build a verifiable contribution profile |
| Project Owner | Post open-source or paid projects, manage collaboration requests, review proposals, and hire contributors with proven GitHub track records |
| Team Lead | Create teams, invite members by email, assign projects, and manage a shared team workspace |
| Organisation Admin | Manage organisations with role-based access control, configure integrations, and oversee contributor activity at scale |
- 🔗 GitHub Integration — Connect your GitHub account, sync repositories, and toggle collaboration on individual repos
- 🎯 Issue Claiming — Browse open GitHub issues across all collaboration-enabled repos, claim them, and track their status through a kanban-style workflow (
todo → in-progress → in-review → done) - 💼 Gig Marketplace — Post and discover paid freelance gigs with category tags, difficulty levels, milestone-based budgets, and featured listings
- 📋 Project Discovery — Explore open-source and collaborative projects filtered by tech stack, status, and visibility
- 📨 Proposals & Applications — Submit structured proposals with cover letters, milestones, GitHub/portfolio URLs, and resume uploads
- 👥 Teams — Create teams, invite members by email, assign projects, and collaborate in a shared workspace
- 🏢 Organisations — Multi-tier org management with an
owner → admin → memberrole hierarchy - 📊 Contributor Analytics — GitHub-style contribution heatmaps, weekly activity charts, tech stack breakdowns, and profile stats
- 🏆 Leaderboard — Public ranking of top contributors across the platform
- 💳 Subscription Plans — Starter (free), Pro, and Pro+ tiers with feature gating and auto-demotion on plan expiry
Coming soon — add screenshots of the dashboard, marketplace, and issue explorer here.
| Layer | Technology | Version |
|---|---|---|
| Framework | React + TypeScript | 18 / 5.x |
| Build Tool | Vite | 8 |
| Styling | Tailwind CSS + shadcn/ui (Radix primitives) | 4.x |
| Routing | React Router DOM | v6 |
| Data Fetching / State | TanStack React Query | v5 |
| Backend | Supabase — Auth, PostgreSQL, Edge Functions, Storage | latest |
| Forms | React Hook Form + Zod | — |
| Animation | Framer Motion | — |
| Charts | Recharts | — |
| Drag & Drop | @hello-pangea/dnd | — |
For detailed instructions, including Supabase and environment setup, please read our Full Setup Guide.
# 1. Fork & Clone
git clone [email protected]:YOUR_USERNAME/colabs.v2.git
cd colabs.v2
# 2. Install Dependencies
npm install
# 3. Start Development Server
npm run dev(You must configure Supabase and GitHub OAuth before the app will fully function. See Setup Guide.)
Colabs is an open-source project and contributions of all kinds are welcome — from bug fixes and documentation improvements to new features and design enhancements.
Before starting, please read our:
We'd love to have you in the community — whether you're contributing code, sharing feedback, or just following along.
| Channel | Link | Purpose |
|---|---|---|
| 💬 Discord | discord.gg/UKjtBDDFHH | Real-time chat — ask questions, share ideas, meet contributors |
| 🐛 GitHub Issues | colabs.v2/issues | Bug reports and feature requests |
| 💡 GitHub Discussions | colabs.v2/discussions | Long-form questions, proposals, and community conversation |
| 𝕏 X (Twitter) | @SpaceYaTech | Announcements, updates, and release notes |
| @SpaceYaTech | Behind-the-scenes and community highlights | |
| SpaceYaTech | Professional updates and milestones | |
| 🎵 TikTok | @SpaceYaTech | Short-form demos and community content |
🔒 If you find a security vulnerability, please do not open a public issue. Follow the responsible disclosure process documented in SECURITY.md.
This project is licensed under the MIT License — see the LICENSE file for full details.
You are free to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the software, subject to the conditions in the license.
Colabs is built with and on top of excellent open-source tools:
- Supabase — open-source Firebase alternative
- shadcn/ui — beautifully designed components built on Radix
- TanStack Query — powerful async state management
- Vite — next-generation frontend tooling
- Tailwind CSS — utility-first CSS framework
- Lovable — the AI-powered development platform used to bootstrap this project
Thanks goes to these wonderful people
 Lawrence Juma 🚇 💻 📖 |
This project follows the all-contributors specification. Contributions of any kind welcome!
Made with ❤️ by the Colabs community · Powered by SpaceYaTech