ATLAS
Contractor Find Jobs Feed

The contractor's primary job discovery experience — marketplace browse, search, filter, bid, and track. Terracotta palette, optimized for speed-to-bid conversion.

1 Browse Feed
2 Filter & Search
3 View Details
4 Place Bid
5 Track Bids
6 Saved Jobs
1 Feed + Detail
2 Bid + Confirm
3 My Bids + Saved
1 Job Marketplace
2 My Bids Manager
Discovery
Feed — Empty State
9:41
Find Jobs
0 jobs available
All Jobs New High Value Nearby
No jobs in your area
Jobs matching your service categories haven’t been posted yet. We’ll notify you when new ones appear.
More jobs coming soon...
Get More Leads
Complete your profile to appear in homeowner searches
Add more service categories to see wider results
Upload portfolio photos to boost your credibility
Home
Find
Projects
Messages
Profile

FindJobsScreen + EmptyState

useQuery(api.jobs.jobs.listAvailable) returns empty array

Feed — Active
9:41
Find Jobs
24 jobs available
All Jobs New 5 High Value Nearby
4
New Plumbing
Kitchen Sink Replacement & Disposal Install
Akron, OH 3.2 mi
$800 – $1,200
2 bids • 3h ago
High Value Roofing
Full Roof Replacement — 2,400 sq ft Colonial
Hudson, OH 8.1 mi
$12,000 – $18,000
5 bids • 1d ago
HVAC RANGE
AC Unit Repair — Not Cooling Properly
Cuyahoga Falls, OH
Home
Find
Projects
Messages
Profile

FindJobsScreen → JobCard (variant="default")

useQuery(api.jobs.jobs.listAvailable, { limit: 50 })

Filters Panel
9:41
Filters
Reset
Category
Plumbing Electrical Roofing HVAC Painting Flooring Landscaping General
Distance Radius
5 mi 30 mi 50 mi
Budget Range
$500
Min
—
$25,000
Max
Date Posted
Any Time Last 24h Last 7 Days Last 30 Days
Property Type
All Single Family Condo/Townhouse Multi-Family Commercial
Urgency
Any Emergency Within 1 Week Flexible

FiltersPanel (bottom sheet / modal)

Local state for filter values, applied on submit

Bidding
Job Detail
9:41
Job Details
Plumbing New RANGE
Kitchen Sink Replacement & Garbage Disposal Install
Posted 3 hours ago • Job #3B-2847
$800 – $1,200
Budget Range
3.2 mi
Akron, OH 44313
Description
Need to replace a double-basin kitchen sink and install a new garbage disposal unit. Current sink has a slow leak at the drain connection. Disposal is original from 2008 and no longer functions. Prefer InSinkErator brand if possible.
Scope of Work
Remove existing double-basin sink
Install new undermount sink (homeowner providing)
Install new garbage disposal unit
Connect water supply lines and test for leaks
Haul away old sink and disposal
Property Details
Property TypeSingle Family
Year Built2008
TimelineWithin 1 week
Bids Received2 of 3 max
Homeowner
M
Michael R.
Member since Jan 2026 • 3 past jobs
Location
Exact address revealed after bid acceptance

JobDetailScreen → PhotoCarousel, ScopeList

router.push("/(contractor)/jobs/${jobId}")

Place Bid
9:41
Submit Bid
Kitchen Sink Replacement
Akron, OH • Budget: $800 – $1,200
Your Bid Amount
$950.00
Enter your total bid amount including labor & materials
Bid Breakdown
Labor $580.00
Materials $290.00
Markup $80.00
Total Bid $950.00
Estimated Timeline
1
Day
2-3
Days
1
Week
2+
Weeks
Cover Message
Hi Michael, I’m a licensed plumber with 12 years of experience in kitchen installations. I can complete this job within 2 days and have installed over 200 InSinkErator disposals. I’ll bring all necessary fittings and materials.
Personalized messages win 3x more bids
Attach Portfolio
Include your best kitchen/plumbing photos
I agree to the 3Bids Terms of Service and Contractor Agreement. I understand plan-based platform fees apply upon completion.

CreateBidScreen → BidBreakdown, TimelineSelector

useMutation(api.jobs.bids.create) → router.push("/(contractor)/bids/create")

Bid Confirmation
9:41
Bid Submitted

Bid Submitted!

Your bid of $950.00 has been sent to the homeowner. You’ll be notified when they respond.

Bid Summary
JobKitchen Sink Replacement
Bid Amount$950.00
Timeline2–3 Days
PortfolioAttached
Estimated Response
Most homeowners respond within 24 hours
Tips for Winning
Respond quickly if the homeowner messages you
Keep your availability calendar up to date
Complete your profile with licenses & insurance

BidConfirmationScreen (success state)

Navigated after successful useMutation(api.jobs.bids.create)

Tracking
My Bids
9:41
My Bids
All (8) Pending (3) Accepted (2) Declined (2) Expired (1)
Kitchen Sink Replacement
Akron, OH • Accepted
$950
Feb 24
Full Roof Replacement
Hudson, OH • Pending
$14,800
Feb 23
Bathroom Exhaust Fan Install
Stow, OH • Pending
$380
Feb 22
Deck Staining & Sealing
Tallmadge, OH • Declined
$1,200
Feb 20
Water Heater Replacement
Barberton, OH • Accepted
$2,100
Feb 18
Gutter Cleaning & Repair
Fairlawn, OH • Pending
$450
Feb 17
Fence Post Replacement
Norton, OH • Declined
$680
Feb 15
Drywall Patching
Akron, OH • Expired
$250
Feb 10
Home
Find
Projects
Messages
Profile

MyBidsScreen → BidListItem

useQuery(api.contractor.jobs.getMyBids) with status filter

Saved Jobs
9:41
Saved Jobs
4 saved jobs
Updated
Full Roof Replacement — 2,400 sq ft Colonial
Hudson, OH • $12K–$18K
5 bids • 1d ago
Bathroom Tile Remodel — Master Bath
Medina, OH • $3K–$5K
1 bid • 2d ago
Updated
Furnace Inspection & Tune‑Up
Wadsworth, OH • $150–$300
0 bids • 4h ago
Basement Waterproofing Assessment
Copley, OH • $2K–$4K
3 bids • 3d ago
Swipe left to remove from saved
Home
Find
Projects
Messages
Profile

SavedJobsScreen → SavedJobCard

useQuery(api.contractor.jobs.getSavedJobs), useMutation(api.contractor.jobs.toggleSave)

Data Architecture

Schema Tables

jobs
  _id: Id<"jobs">
  posterId: Id<"posterUsers">
  title: string
  description: string
  status: JobStatus
  city, state, zipCode: string
  jobDetails: { budget, timeline, scope[] }
  bidCount: number
  maxBids: number
  bidMode: "precise" | "range"
  categoryId: Id<"jobCategories">
  createdAt: number

jobBids
  _id: Id<"jobBids">
  jobId: Id<"jobs">
  contractorId: Id<"contractorUsers">
  amount: number
  laborCost, materialCost: number
  coverLetter: string
  estimatedDays: number
  status: BidStatus
  attachPortfolio: boolean

contractorProfile
  serviceCategories: string[]
  serviceRadius: number
  latitude, longitude: number

Convex Queries

api.jobs.jobs.listAvailable
  args: { limit?: number }
  returns: { items: Job[] }
  // Open jobs, ordered by createdAt desc

api.contractor.jobs.getNearbyJobs
  args: {
    latitude?: number,
    longitude?: number,
    radiusMiles: number,
    limit: number
  }
  returns: { items: Job[] }

api.contractor.jobs.getMyBids
  args: { status?: BidStatus }
  returns: BidWithJob[]

api.contractor.jobs.getSavedJobs
  returns: SavedJob[]

api.users.contractors.me
  returns: ContractorProfile

Convex Mutations

api.jobs.bids.create
  args: {
    jobId: Id<"jobs">,
    amount: number,
    laborCost: number,
    materialCost: number,
    coverLetter: string,
    estimatedDays: number,
    attachPortfolio: boolean
  }

api.contractor.jobs.toggleSave
  args: { jobId: Id<"jobs"> }
  // Bookmark / unbookmark a job

Hooks & Components

// Hooks
useFindJobs
  filterCategory: FilterCategory
  searchQuery: string
  deviceLocation: { lat, lon } | null

useRefreshControl
  returns: [refreshing, onRefresh]

// Components
JobCard // components/features/JobCard
  variant: "default" | "compact" | "detailed"
  showBidButton: boolean

BidModeBadge // RANGE | PRECISE
StatusBadge // Pending/Accepted/etc.
EmptyState // components/ui/Empty
SearchBar // with filter icon

// Navigation
/(contractor-tabs)/find-jobs
/(contractor)/jobs/[id]
/(contractor)/bids/create
Tablet — Split-Pane Views (3 Screens)
Job Feed + Job Detail
9:41
Find Jobs
All (24) New (5) High Value Nearby
Kitchen Sink Replacement
Akron, OH · 3.2 mi · $800–$1,200
New
Full Roof Replacement
Hudson, OH · 8.1 mi · $12K–$18K
High Value
AC Unit Repair
Cuyahoga Falls, OH · $300–$600
Range
Panel Upgrade 200A
Stow, OH · 5.4 mi · $2,800–$4,500
New
Exterior House Painting
Fairlawn, OH · 2.1 mi · $3,500–$5,000
Plumbing
Kitchen Sink Replacement & Disposal Install
Posted 3 hours ago · Job #3B-2847
Plumbing New Range
$800 – $1,200
Budget Range
3.2 mi
Akron, OH 44313
Scope of Work
Remove existing double-basin sink
Install new undermount sink
Install new garbage disposal unit
Connect supply lines & test for leaks
Property
Single Family
Timeline
Within 1 week
Bids
2 of 3 max
Place Bid + Confirmation
9:41
Submit Bid
Kitchen Sink Replacement
Akron, OH · $800–$1,200
Your Bid Amount
$950.00
Breakdown
Labor$580.00
Materials$290.00
Markup$80.00
Total Bid$950.00
Timeline
1
Day
2–3
Days
1
Week
Cover Message
Hi Michael, I’m a licensed plumber with 12 years of experience. I can complete this job within 2 days and have installed over 200 InSinkErator disposals.
Bid Submitted!
Your bid of $950.00 has been sent. You’ll be notified when the homeowner responds.
Bid Summary
JobKitchen Sink Replacement
Bid Amount$950.00
Timeline2–3 Days
PortfolioAttached
Estimated Response
Most homeowners respond within 24 hours
My Bids + Saved Jobs
9:41
My Bids
All (8) Pending (3) Accepted (2) Declined (2)
Kitchen Sink Replacement
Akron, OH · Accepted
$950
Feb 24
Full Roof Replacement
Hudson, OH · Pending
$14,800
Feb 23
Bathroom Exhaust Fan
Stow, OH · Pending
$380
Feb 22
Deck Staining & Sealing
Tallmadge, OH · Declined
$1,200
Feb 20
Water Heater Replacement
Barberton, OH · Accepted
$2,100
Feb 18
Saved Jobs (4)
Updated
Full Roof Replacement — 2,400 sq ft
Hudson, OH · $12K–$18K
5 bids · 1d ago
Bathroom Tile Remodel
Medina, OH · $3K–$5K
1 bid · 2d ago
Updated
Furnace Inspection & Tune‑Up
Wadsworth, OH · $150–$300
0 bids · 4h ago
Basement Waterproofing
Copley, OH · $2K–$4K
3 bids · 3d ago
Web — Browser Views (2 Screens)
Job Marketplace — Browse & Filter
https://app.3bids.io/contractor/find-jobs
3Bids
Main
Dashboard ⌘1
Find Jobs ⌘2
My Bids ⌘3
Projects ⌘4
Messages ⌘5
Finances ⌘6
MK
Mike Kowalski
Contractor
Settings ⌘,
Find Jobs
All (24) New (5) High Value Nearby
Search jobs...
Job
Location
Budget
Bids
Posted
Actions
Kitchen Sink Replacement
Plumbing · New
Akron, OH
3.2 mi
$800–$1.2K
2 of 3
3h ago
Full Roof Replacement
Roofing · High Value
Hudson, OH
8.1 mi
$12K–$18K
5 of 5
1d ago
AC Unit Repair
HVAC · Range
Cuyahoga Falls
4.6 mi
$300–$600
1 of 3
5h ago
Panel Upgrade 200A
Electrical · New
Stow, OH
5.4 mi
$2.8K–$4.5K
0 of 3
8h ago
Exterior House Painting
Painting
Fairlawn, OH
2.1 mi
$3.5K–$5K
2 of 3
1d ago
My Bids — Track & Manage
https://app.3bids.io/contractor/my-bids
3Bids
Main
Dashboard ⌘1
Find Jobs ⌘2
My Bids ⌘3
Projects ⌘4
Messages ⌘5
Finances ⌘6
MK
Mike Kowalski
Contractor
Settings ⌘,
My Bids
All (8) Pending (3) Accepted (2) Declined (2) Expired (1)
8
Total Bids
2
Accepted
3
Pending
$20,860
Total Value
Job
Location
Bid Amount
Status
Date
Kitchen Sink Replacement
Plumbing
Akron, OH
$950
Accepted
Feb 24
Full Roof Replacement
Roofing
Hudson, OH
$14,800
Pending
Feb 23
Bathroom Exhaust Fan
Electrical
Stow, OH
$380
Pending
Feb 22
Deck Staining & Sealing
General
Tallmadge, OH
$1,200
Declined
Feb 20
Water Heater Replacement
Plumbing
Barberton, OH
$2,100
Accepted
Feb 18