Documentation
How Vibe Coder Hub works — every module, every flow.
Overview
Vibe Coder Hub is an AI-native marketplace with two sides: a public face where freelancers browse builders, explore showcase projects, and apply to gigs — and an admin backend where gig posters manage their gigs, review applications, and track conversations.
Each user who signs in gets their own isolated workspace. You only see the gigs you posted and the conversations on those gigs. Other gig posters can't see your data — and you can't see theirs. Public pages (builder directory, showcase, gig application) are shared across all users.
Auth is handled by Clerk. Public pages are open to everyone. Admin pages (under /admin/*) require sign-in and are scoped to the logged-in user. The gig application flow is deliberately login-free — freelancers apply with just a name and track their thread via a private token URL.
Gig Application Flow
The core loop: post → share → apply → converse.
Module Reference
Builder Directory
PublicThe core of the platform. Browse AI-native freelancers by name, skill, or tag. Each builder profile shows their bio, hourly rate, tools they use (Cursor, Claude Code, Lovable, etc.), and tags for discoverability. Creators can edit or delete their own builder profiles.
- •Search builders by name or bio
- •Filter by tag (e.g. web, mobile, automation)
- •View individual profiles at /freelancers/[id]
- •Tag pickers (clickable chips) for tools + skills — no more freeform CSV
- •Edit/Delete buttons visible only to the creator
- •Admin CRUD list at /admin/freelancers (scoped to your builders)
Jewish AI Professionals Directory
PublicA searchable public directory of Jewish AI professionals — operators, founders, researchers. Each entry has name, title, company, location, bio, expertise tags, LinkedIn, and website.
- •Public searchable cards with avatar, title, company, location
- •Expertise badges per profile
- •Authenticated users can add entries; creators can edit/delete their own
Product Showcase
PublicA Product Hunt-style community leaderboard where builders submit vibe-coded projects. The best projects float to the top via upvotes (deduplicated per user). Each project gets a rank badge, comments thread, and inline image/video preview.
- •Submit projects with name, description, URL, tools, tags, image, and video
- •Dedup upvotes — one per signed-in user (UNIQUE constraint on project+user)
- •Rank badges: #1 gold, #2 silver, #3 bronze
- •Expandable comments thread per project (sign-in required to comment)
- •Inline image preview + embedded video preview
- •Edit/Delete buttons visible only to the project creator
Gig Board
Admin (scoped to your gigs)The internal job board where you post and manage your gigs. Three gig types: task (fixed scope), hourly (time-based), and build (full project). Each gig gets a unique public link for applicants. You only see gigs you created — other posters' gigs are invisible to you. Full edit/delete control over your own gigs.
- •Three gig types: Task (Zap), Hourly (Clock), Build (Wrench)
- •Auto-generated public slug for sharing (e.g. /gigs/public/my-project)
- •Budget range or hourly rate
- •Optional Loom video walkthrough — embedded on both admin + public pages
- •Tags for categorization
- •Status tracking: open → in_progress → closed
- •Edit page at /admin/gigs/[id]/edit + delete button on detail view
- •Admin detail view at /admin/gigs/[id] with all conversations
Loom Video Walkthroughs
Optional on every gigDrop a Loom share link into your gig and it auto-embeds as a video walkthrough on both the admin detail page and the public application page. Applicants see exactly what you need before they apply.
- •Paste any Loom share URL (e.g. https://www.loom.com/share/abc123)
- •Auto-extracts video ID and embeds via Loom's official iframe
- •Visible on both admin gig detail and public application page
- •Editable from the gig edit form
Public Gig Application
Public (no login)When a gig is posted, the admin shares its public link. Freelancers land on a clean application page — no login required. They submit their name, optional email, and a message. On submission, they receive a private thread token to track the conversation.
- •No login required — frictionless application
- •Shareable link per gig (auto-generated slug)
- •Applicant submits name, optional email, optional message
- •Instant thread token on apply — bookmark it to check replies
Conversation Threads
Token-based accessEach application creates a private thread between the applicant and the gig poster. The freelancer accesses it via a unique token URL — no account needed. Only the gig owner (the poster who created the gig) can reply from the admin dashboard. Like a lightweight email thread, but in-app.
- •Token-URL access — no login needed for freelancers
- •Only the gig owner can reply from /admin/gigs/[id]
- •Freelancer checks thread at /gigs/thread/[token]
- •Messages are timestamped and ordered chronologically
- •Other gig posters cannot access your conversations
Availability Slots
AdminManage builder availability. Each slot belongs to a freelancer and has a date + time range. Slots can be booked or open. Helps match gigs to builders who are free.
- •Create slots tied to a specific builder
- •Date + start/end time per slot
- •Booked vs. open status
- •Admin CRUD for slot management
Admin Dashboard
Admin (auth required)The ops hub for your account. Shows live counts for your gigs, total freelancers, open slots, replies on your gigs, and showcase projects. Gig type breakdown and your recent gigs list. Everything at a glance — scoped to your data only.
- •Live stats: total/open gigs, freelancers, slots, replies, showcase count
- •Gig type breakdown (task/hourly/build)
- •Recent gigs list with type, status, and relative time
Tech Stack
Gig Types
Fixed-scope deliverable. One shot, one price. Budget min/max range.
Time-based engagement. Set an hourly rate. Track as it goes.
Full project build. Larger scope, budget range, milestones implied.