ATLAS
Reviews & Ratings

Two-way review system for posters and contractors. Category ratings, photo evidence, public profiles, response management, and automated review requests.

1 Write Review (Poster)
2 Write Review (Contractor)
3 Review Submitted
4 Contractor Reviews Page
5 Poster Reviews Page
6 Review Detail
7 Review Requests
8 Respond to Review
1 Reviews Overview & Write
2 Review Management
1 Reviews Dashboard
Section 1 — Leave Review
Write Review POSTER
9:41
Leave Review
Job Completed!
Your project is finished — how did it go?
MR
Miller Roofing LLC
Complete Roof Replacement — Akron
Rate Your Experience
Please rate all three categories (your overall rating is the average)
Overall:
4.7
Communication
How well did they communicate throughout the project?
Quality of Work
How satisfied are you with the quality of work?
Likelihood to Recommend
How likely are you to recommend them to a friend?
Write Your Review
Share your experience to help other homeowners make informed decisions.
Great work from Miller Roofing! They arrived on time every day, kept the workspace spotless, and the new roof looks incredible. Communication was excellent throughout the entire project. Would hire again without hesitation.
218 / 1000 characters
Add Photos (Optional)
Show the completed work to help others see the quality
Tips for a helpful review:
  • Be specific about what went well
  • Mention communication and professionalism
  • Note if work was completed on time
  • Share if the workspace was left clean
Skip
Submit Review

PosterLeaveReview — 3 category ratings (Communication, Quality, Recommend), overall auto-computed as average

useQuery(api.jobs.jobs.get) • useMutation(api.users.reviews.submitContractorReview)

Write Review CONTRACTOR
9:41
Leave Review
SJ
Sarah Johnson
Kitchen Remodel — Cuyahoga Falls
How was this client?
Great
Rate by Category
Communication
Were they clear and responsive?
Preparation
Was the workspace ready on arrival?
Payment Timeliness
Was payment handled promptly?
Write a Review (Optional)
Share your experience to help other contractors know what to expect.
Great client! Sarah had clear expectations from day one, responded quickly to updates, and the kitchen was prepped and ready when we arrived. Approvals were prompt and payment went through immediately after completion.
241 / 1000 characters
Tips for a helpful review:
  • Was communication clear and responsive?
  • Were expectations reasonable?
  • Was payment handled promptly?
  • Would you work with them again?
Skip
Submit Review

ContractorLeaveReview — Overall star rating + 3 categories (Communication, Preparation, Payment Timeliness)

useQuery(api.contractor.jobs.getJobDetail) • useMutation(api.users.reviews.submitPosterReview)

Review Submitted SUCCESS
9:41
Review Submitted
Thank You!
Your review has been submitted successfully. It helps the community make better decisions.
Your Review
MR
Miller Roofing LLC
Great work from Miller Roofing! They arrived on time every day and the new roof looks incredible.
Your review helps other homeowners find trusted contractors
Done

AlertDialog — Success confirmation with review preview card and community message

router.replace("/(poster)/jobs/{jobId}") on dismiss

Section 2 — View Reviews
Contractor Reviews PUBLIC
9:41
Reviews
MR
Miller Roofing LLC
Licensed Roofing Contractor • Akron, OH
4.7 (47 reviews)
Rating Breakdown
5
34
4
8
3
3
2
1
1
1
Category Averages
Communication
4.9
Quality of Work
4.6
Likelihood to Recommend
4.5
Most Recent
All
5
4
SJ
Sarah Johnson
Feb 18, 2026
Outstanding work on our roof replacement in Hudson. The crew was professional from start to finish, cleaned up every day, and the final result exceeded our expectations. Highly recommended for any roofing project!
Miller Roofing LLC responded
Thank you Sarah! It was a pleasure working on your home. We pride ourselves on leaving every job site clean and delivering quality work. We appreciate your trust in our team!
Helpful (3)
MP
Mike Patterson
Feb 10, 2026
Good quality work on the gutter installation. Took a bit longer than expected due to weather delays, but they communicated well about the schedule changes. Fair pricing for the area.
Helpful (1)
LW
Lisa Williams
Jan 29, 2026
Could not be happier with the emergency roof repair after the storm. They came out same day, tarped the damage, and had the full repair done within the week. True professionals who care about their community.
Helpful (5)

ContractorReviews — Public profile with rating breakdown bars, category averages, filter/sort, review cards with responses

useContractorReviews() • useContractorProfile()

Poster Reviews POSTER
9:41
My Reviews
SJ
Sarah Johnson
5.0 (3 from contractors)
Reviews Given (4)
Reviews Received (3)
MR
Miller Roofing LLC
Feb 18, 2026
You
Roof Replacement — Hudson, OH
Outstanding work on our roof replacement. The crew was professional from start to finish and the final result exceeded our expectations.
BP
Buckeye Plumbing
Jan 5, 2026
You
Bathroom Pipe Repair — Cuyahoga Falls, OH
Solid work fixing the burst pipe. Quick response and fair pricing. Only missed a star because cleanup could have been more thorough.
CE
Canton Electric
Dec 12, 2025
You
Panel Upgrade — Stow, OH
Excellent electrical work. Upgraded our panel to 200A with zero issues. Very knowledgeable and professional.

PosterReviews — Poster profile header, tabs for reviews given vs received, contractor info on each card

useQuery(api.users.reviews.getPosterReviews)

Review Detail PUBLIC
9:41
Review Detail
SJ
Sarah Johnson
Feb 18, 2026 • Verified Homeowner
5.0
Outstanding work on our roof replacement in Hudson. The crew was professional from start to finish, cleaned up every day, and the final result exceeded our expectations. Highly recommended for any roofing project!
Category Ratings
Communication
Quality of Work
Likelihood to Recommend
Photos
Contractor Response
Miller Roofing LLC
Feb 19, 2026
Thank you Sarah! It was a pleasure working on your home. We pride ourselves on leaving every job site clean and delivering quality work. We appreciate your trust in our team!
Complete Roof Replacement
Hudson, OH • Completed Feb 15, 2026
Helpful (3)
Report

ReviewDetail — Full review with photos, category breakdown, contractor response thread, related job link, report action

useQuery(api.users.reviews.getReviewDetail)

Section 3 — Review Management (Contractor)
Review Requests CONTRACTOR
9:41
Review Requests
Review Request Funnel
24
Sent
79%
Opened
62%
Responded
19
Submitted
4.7
Avg Rating
79%
Submit Rate
47
Reviews
Auto-Request Settings
Auto-send review requests
24 hours after job completion
Send follow-up reminder
After 5 days if no response
Pending Requests
3 waiting
Deck Staining — Tom Anderson
Completed Feb 20 • 4 days ago
Remind
Gutter Install — Karen White
Completed Feb 17 • 7 days ago
Remind
Siding Repair — Dave Chen
Completed Feb 22 • 2 days ago
Sent
Recent Submissions
Roof Replacement — Sarah Johnson
Submitted Feb 18 • 5.0
Done
Chimney Repair — Brian Taylor
Submitted Feb 12 • 4.0
Done

ReviewRequestsDashboard — Funnel stats (sent → opened → responded → submitted), auto-request settings, pending/completed requests

useQuery(api.reviews.queries.getContractorRequestStats) • useQuery(api.reviews.queries.listContractorRequests)

Respond to Review CONTRACTOR
9:41
Respond to Review
Original Review
MP
Mike Patterson
Feb 10, 2026
Good quality work on the gutter installation. Took a bit longer than expected due to weather delays, but they communicated well about the schedule changes. Fair pricing for the area.
Gutter Installation — Stow, OH
Write Your Response
Your response will be visible publicly below the review.
Thank you Mike for the kind words! You are right that the weather pushed our timeline back a few days. We always prioritize doing the job right over rushing to finish. We appreciate your understanding and are glad the gutters are performing well for you!
274 / 500 characters
Response Best Practices:
  • Keep a professional, courteous tone
  • Address specific concerns mentioned
  • Thank the customer for their feedback
  • Avoid defensive or argumentative language
Public Preview
Miller Roofing LLC Just now
Thank you Mike for the kind words! You are right that the weather pushed our timeline back a few days. We always prioritize doing the job right over rushing to finish...
Cancel
Post Response

RespondToReview — Original review display, response textarea, best practices tips, live public preview

useMutation(api.users.reviews.respondToReview) • 500 char limit

Data Architecture — Reviews & Ratings

Schema: reviews

  • _id — Convex document ID
  • jobId — v.id("jobs")
  • reviewerId — v.id("users")
  • revieweeId — v.id("users")
  • reviewerRole — "poster" | "contractor"
  • rating — Overall rating 1-5 (auto-computed average for poster)
  • categoryRatings — { communication, quality, recommend }
  • text — Written review (max 1000 chars)
  • photos — Array of storage IDs
  • response — Contractor response text (max 500 chars)
  • responseAt — Timestamp of response
  • helpfulVotes — Count of helpful votes
  • isFeatured — Boolean, contractor can feature
  • _creationTime — Auto timestamp

Queries

  • getContractorReviews — Paginated reviews for a contractor profile, with filter/sort/rating params
  • getPosterReviews — Reviews given and received by a poster
  • getReviewDetail — Single review with full data + related job
  • getContractorRequestStats — Funnel metrics (sent, opened, responded, submitted)
  • listContractorRequests — Timeline of individual review requests with status

Mutations

  • submitContractorReview — Poster submits review for contractor (3 category ratings + text)
  • submitPosterReview — Contractor submits review for poster (overall rating + text)
  • respondToReview — Contractor responds to a review (500 char limit)
  • requestReview — Manually send review request to a poster
  • voteHelpful — Toggle helpful vote on a review
  • toggleFeatured — Feature/unfeature a review on contractor profile
  • reportReview — Flag a review for admin review

Hooks & Components

  • useContractorReviews() — Reviews list with filter/sort/pagination state
  • useContractorProfile() — Profile data with aggregate ratings
  • useReviewRequests() — Contractor review request pipeline
  • PosterLeaveReview — app/(poster)/reviews/create.tsx
  • ContractorLeaveReview — app/(contractor)/reviews/create.tsx
  • ContractorReviews — app/(contractor)/(tabs)/(home)/reviews/index.tsx
  • ReviewRequestsDashboard — app/(contractor)/(tabs)/(home)/reviews/requests.tsx
Reviews Overview & Write
Reviews Overview & Write
9:41
Reviews Overview & Write
Reviews Summary
4.8
Rating
127
Reviews
Recent Reviews
James Mitchell
Amazing work on kitchen reno
5.0
Sarah Lopez
Great deck installation
4.5
Tom Anderson
Good plumbing repair
4.0
Review Management
Review Management
9:41
Review Management
Review Requests
Kitchen Renovation
James Mitchell · Completed Mar 5
Pending
Deck Installation
Sarah Lopez · Completed Feb 28
Sent
Plumbing Repair
Tom Anderson · Completed Feb 20
Received
Respond to Review
Title
Enter title...
Description
Enter description...
Notes
Enter notes...
Reviews Dashboard
Reviews Dashboard
https://app.3bids.io/reviews
3Bids
Reviews
Overview ⌘1
Write Review ⌘2
My Reviews ⌘3
Requests ⌘4
Respond ⌘5
MK
Mike Kowalski
Contractor
Settings ⌘,

Reviews Dashboard

4.8
Rating
127
Total
+12
This Month
94%
5-Star
Recent Reviews
Reviewer
Comment
Rating
Date
Status
JM
James Mitchell
Amazing work on our kitchen renovation. Professional and on time.
5.0
Mar 8
Published
SL
Sarah Lopez
Great deck installation, very happy with the results overall.
4.5
Mar 2
Published
TA
Tom Anderson
Good plumbing repair. Fixed the issue quickly and cleanly.
4.0
Feb 25
Published
RW
Rachel Wang
Excellent bathroom remodel. Exceeded expectations.
5.0
Feb 18
Pending
Rating Distribution
5
99
4
18
3
6
2
3
1
1
Review Requests
Kitchen Renovation
James Mitchell · Completed Mar 5
Pending
Deck Installation
Sarah Lopez · Completed Feb 28
Sent
Plumbing Repair
Tom Anderson · Completed Feb 20
Received