Important: If a customer has not yet been rated or is not found in our system, this should not deter you from accepting a job. Not every customer has been reviewed — many great clients simply haven't been rated yet. Once the job is completed, you can add the customer to the rating system and share your experience to help fellow contractors.
About Contractor Alliance
Contractor Alliance is a customer reputation platform that gives tradespeople the same transparency about their clients that clients have always had about them. Rate your customers, search the shared database before accepting a job, and protect your business from difficult clients — all in one place.
The Problem We Solve
Every contractor has been there: you take on a job that looked great on paper, only to discover the client pays late, changes the scope constantly, or creates hazardous jobsite conditions. Until now, there was no way to know in advance — you were flying blind.
Meanwhile, homeowners and businesses have had access to contractor reviews for years. They can check your reputation before hiring you, but you've never had the same power to check theirs. Contractor Alliance flips that dynamic. Now, contractors can share their experiences and help each other make smarter, safer business decisions.
Think of it as a credit score for customer behavior — one that rewards clients who treat contractors fairly and flags those who don't, so the entire trades community benefits.
How It Works
From adding a customer to making informed decisions — four simple steps.
1. Add Your Customer
Create a customer profile with their name, address, and phone number. The system automatically searches the shared database for duplicates as you type — you do not need to add the same customer again. This prevents duplicate entries and protects the integrity of the scoring, since all ratings for one customer feed into a single composite score. However, if it is a genuinely different customer who happens to share the same information, you can proceed and add them. You don't need to be the one who added a customer to rate them — any contractor can rate an existing customer, and the composite score reflects ratings from all contractors who have worked with that customer, not just the one who created the profile.
2. Rate Across Seven Criteria
Score your customer on a 1–5 star scale across seven professional categories: Respectfulness, Payment Time, Job Site Access, Clear Communication, Scope Adherence, Professionalism, and Jobsite Cleanliness. Not done with the job yet? Save your rating as a draft and come back to finalize it when the work is complete. It's a good idea to wait — a customer can only be rated once, and after you submit your rating you must wait 90 days before you can rate that same customer again.
3. Search Before You Accept
Before taking on a new client, search the shared database by name, phone number, or address to see their reputation score and rating history. Know what you're walking into — payment habits, communication style, jobsite conditions — before you sign a contract.
4. Make Informed Decisions
Each customer's profile shows their composite score (350–800), total ratings received, score trends over time, and individual rating breakdowns. Use this data to set expectations, adjust pricing, or walk away from problem clients before they cost you time and money.
The Scoring System
Seven weighted categories combine into a single composite score from 350 to 800.
Rating Categories & Weights
Respectfulness and Payment Time carry the most weight at 25% each — these are the factors that most directly impact a contractor's livelihood. The remaining five categories each contribute 10%.
700–800
Very Good / Excellent
575–699
Fair / Good
350–574
Below Average / Poor
Complete Feature Catalog
Every tool the platform offers — organized by category so you can find what you need.
Core Platform
Shared Customer Database
A global, shared database of customers that every contractor contributes to and benefits from. When you add a customer, the system automatically checks for duplicates so all ratings for one person feed into a single composite score — no fragmentation, no gaming the system.
Seven-Category Rating System
Rate customers across seven professional criteria — Respectfulness, Payment Time, Job Site Access, Clear Communication, Scope Adherence, Professionalism, and Jobsite Cleanliness — each weighted by impact to produce a fair composite score from 350 to 800.
Draft Ratings
Not done with the job yet? Save your rating as a draft and come back to finalize it when the work is complete. Your draft is private until you submit it.
Global Customer Search
Search the entire shared database by name, phone number, email, address, or customer number. Find any customer's reputation score and rating history before you accept a job.
Dashboard Rating Filters
Filter your customer dashboard by rating status — All, Rated, Unrated, or by color sentiment (Green, Yellow, Red) — so you can quickly find customers who need attention or who have community caution flags.
Score Trends & Breakdowns
Every customer profile shows their composite score, total ratings received, score trend over time, and a per-category breakdown so you can see exactly where a customer excels or falls short.
PDF Customer Reports
Export comprehensive PDF reports on any customer — including score breakdowns by category, full rating history, and trend analysis — to share with your team or keep for your own records.
Trust, Safety & Fairness
Verified Contractor Bonus
When a verified contractor rates a customer, that customer receives a +5 point bonus on their composite score — rewarding customers who choose to work with verified professionals. Verified contractors also appear in the public Verified Contractor Directory, helping you build trust and attract clients.
QuickFeedback System
Submit anonymous green (good), yellow (caution), or red (bad) feedback on any customer in seconds — no full rating required. Aggregate tallies display on customer cards so you can see community sentiment at a glance, even before reading detailed ratings.
Rating Verification
Upload supporting documentation to have your ratings verified by admins. Verified ratings carry extra weight and credibility, giving other contractors even more confidence in the score.
Dispute & Flagging System
If a rating is inaccurate or inappropriate, any contractor can flag it for admin review. Flags go through a formal workflow — New, Under Investigation, Resolved, or Rejected — with public moderator replies and internal admin discussion threads.
Fair Cooldown Periods
You can rate the same customer once every 90 days, preventing score manipulation. After submitting a rating, you have 30 days to edit or delete it before it becomes permanent.
Privacy by Design
Your customer list is private to you and platform admins — never shared with competitors. Customer contact details like email are used only for duplicate prevention, not for marketing or outreach.
Penalty System
Customers who attempt to cheat the system — such as creating duplicate profiles to inflate their score — receive automated score penalties with a full transparency log, including the amount, reason, and expiry date.
Customer Merge Reports
Spot two profiles that might be the same person? Report them as a duplicate, same person, spouse/partner, or other relationship. Admins review and merge profiles while applying penalties for intentional abuse.
Moved-Out Tracking
Mark customers who are no longer at their registered address so fellow contractors know to verify the customer's current location before accepting a job.
Customer Management
Individual & Commercial Customers
Rate individual homeowners and commercial clients alike. Commercial profiles support business type (Sole Proprietorship, LLC, Corporation), owner names, and point-of-contact details, so you can track organizations with multiple decision-makers.
Additional Address Tracking
Associate up to 20 additional addresses with a single customer profile — perfect for landlords, property managers, and customers who own multiple properties. Note: a work address is not considered an additional address and should be entered as the customer's primary address.
CSV Bulk Import
Already have a customer list in a spreadsheet? Upload a CSV file to import multiple customers at once, with automatic duplicate checking against the shared database.
Address Autocomplete
Powered by Google Maps, address fields auto-complete as you type — ensuring accurate, standardized addresses and faster data entry on both mobile and desktop.
Customer Numbering
Every customer receives a unique auto-assigned customer number (e.g. CUST-0001) for easy reference and quick lookups across your team.
Team & Membership
Team Management
Invite team members by email or CSV, manage seats, and track membership capacity. Premium and Enterprise plan holders get multi-user access so your whole crew can share the same customer database.
Team Transfers
Need to move a contractor from one team to another? Submit a transfer request that admins can review and approve, with full audit trails for accountability. A transfer can be initiated by either the contractor's current team owner or by the receiving company requesting the contractor join their team.
Membership Tiers
Choose the plan that fits your business: Single for solo contractors, Premium for growing teams, or Enterprise for large firms with multiple crews. Upgrade or downgrade anytime.
Team Activity Log
Every team action — invites, removals, seat additions, role changes — is logged in a full audit trail so team owners always know what's happening in their account.
Growth & Community
Referral Program
Share your referral code with colleagues and earn free months of membership for every contractor who signs up. The more you refer, the more you save.
Referral Leaderboard
See where you rank among the platform's top referrers. Compete with other contractors to grow the community and earn recognition for your contributions.
Verified Contractor Directory
Verified contractors appear in a public, searchable directory with their company name, trades, licenses, contact info, and logo — helping you attract new clients and build credibility.
My Impact Dashboard
Track your contributions to the platform — customers added, ratings submitted, referrals made — and see the real-world impact you're having on the contractor community.
AI Assistants
Onboarding Assistant
New to the platform? An AI-powered onboarding assistant walks you through account setup, company profile completion, and your first customer rating — step by step.
Rating Assistant
Not sure how to score a tricky customer? The AI rating assistant helps you think through each category and suggests appropriate scores based on your description of the experience.
Score Chat
Ask questions about any customer's score, trends, or rating history in plain English. The AI assistant breaks down the data and explains what the numbers mean for your business.
Account & Personalization
Profile Management
Manage your display name, company name, trade, contact info, website, and profile photo. Your company name is required before you can rate customers, ensuring attribution on every rating.
Smart Notifications
Get notified when a contractor submits a new rating on a customer you share, when someone flags your rating, when a dispute is resolved, and when a dispute is aging toward removal. Toggle each notification type on or off.
Location Privacy Controls
You're in control. Toggle location detection on or off in your profile settings — your privacy preferences are always respected across the platform.
Light & Dark Mode
Switch between light and dark themes for comfortable viewing in any lighting condition. Your preference is saved automatically.
Recent Activity Timeline
See a full timeline of your actions on the platform — customers added, ratings submitted, edits made — so you always have a record of your activity.
Support Tickets
Need help with a password reset, account access, or billing question? Submit a support ticket directly from your profile and track its status through to resolution.
Feedback & Support
Have a suggestion or found a bug? Send feedback directly to the team from your profile page — we read every message.
Self-Service Account Deletion
You own your data. Delete your account and all associated data at any time, no questions asked, directly from your profile settings. When a contractor deletes their account, any customers they created — that have not been rated by other verified contractors — are also removed from the shared database. This is the only scenario in which a previously-existing customer should be re-added to the system; if a customer still has ratings from other contractors, their profile is preserved so the community's rating history remains intact.
Platform & Mobile Experience
Native Mobile Experience
Designed mobile-first with a bottom navigation bar, pull-to-refresh, native-feel dropdowns, safe-area insets, and hidden scrollbars — the app feels like a native iOS or Android app, right in your browser.
Pull-to-Refresh
Pull down on your customer list to instantly refresh data — just like your favorite native apps.
Banner Carousel
Admin-managed promotional banners keep you informed about platform updates, new features, and special offers right from your dashboard.
System Alerts
Platform-wide alert banners notify you of important announcements, maintenance windows, or urgent updates that affect your account.
Admin Custom Styling
Platform administrators can apply custom CSS to tailor the look and feel of the application for all users — no developer required.
File Uploads
Upload profile photos, company logos, verification documents, and banner images with secure cloud storage — all managed in-app.
Billing & Subscriptions
Stripe-Powered Checkout
Upgrade or downgrade your membership plan securely through Stripe checkout — supporting monthly and annual billing cycles for Single, Premium, and Enterprise tiers.
Enterprise Seat Management
Enterprise plan holders can purchase additional team seats at any time, with prorated billing that syncs automatically through Stripe subscription management.
Promo Code System
Admins can generate promo codes with configurable discount percentages, plan types, duration (lifetime or limited months), and multi-seat redemption — giving flexibility for partnerships, referrals, and promotions.
Referral Discounts
Enter a colleague's referral code at checkout to receive 10% off your first billing period. The referrer automatically earns a free month of Premium membership.
Data Management & Recovery
Automated Daily Backups
Every entity in the platform — customers, ratings, users, flags, and more — is backed up nightly to Google Drive as a structured JSON file, with full record counts and file size tracking for auditability.
Manual Drive Upload Fallback
If an automated backup fails to sync to Google Drive, admins can manually re-upload the backup file with one click — ensuring no data is ever lost.
Database Export to Excel
Admins can export the entire platform database — all contractors, customers, and ratings — to a multi-sheet Excel workbook with one click, for offline analysis or compliance reporting.
Backup Download
Download any historical backup file directly from Google Drive through the admin dashboard, with signed URLs for secure, time-limited access.
Security & Data Protection
Row-Level Security (RLS)
Every entity in the database is protected by row-level security policies. Customers can only be edited or deleted by their creator or an admin. Ratings, flags, and merge requests are similarly scoped — users can only modify data they own, and admin-only entities (settings, promo codes, backups) are completely invisible to regular users.
Authenticated Backend Functions
All 45+ backend API endpoints require authentication via session-verified user tokens. Admin-only operations — managing users, applying penalties, merging customers, exporting data, and managing backups — enforce role-based 403 Forbidden checks before any data is touched.
Admin Route Guards
The admin dashboard is protected by a role-based route guard that blocks non-admin users at the navigation level — regular contractors never even see the admin password prompt. A secondary password gate (bcrypt-hashed with a secret pepper) provides defense-in-depth before any admin action is available.
Contact Info Redaction
Contractor contact details — phone, address, and website — are only visible to the public when the contractor is verified and approved. Unverified contractors' contact information is automatically redacted from public profile views, protecting privacy until verification is complete.
Peppered Password Hashing
Admin dashboard passwords are hashed with bcrypt (11 rounds) combined with a secret pepper stored in encrypted environment variables — making brute-force attacks computationally infeasible even if the database were compromised.
Prompt Injection Protection
AI assistant inputs are sanitized and XML-escaped before being passed to the language model, preventing prompt injection attacks. User-supplied content is always treated as untrusted data within system instructions.
CRLF Injection Prevention
All email-sending functions sanitize header-bound fields by stripping carriage returns and line feeds, preventing CRLF/header injection attacks that could spoof recipients or subjects.
Stripe Webhook Signature Verification
All Stripe webhook events are verified against the platform's signing secret using asynchronous signature validation before any subscription or billing change is processed — preventing forged payment notifications.
Private File Storage
Sensitive files — backups, license documents, verification uploads — are stored in private storage with time-limited signed URLs, never publicly accessible. Large content is never stored in database fields.
Secure Secrets Management
API keys, Stripe secrets, Google Maps keys, and the admin password pepper are stored as encrypted environment variables — never hardcoded in source code, never exposed to the frontend, and managed through the platform's secure secrets system.
Audit Trails
Critical actions are logged for accountability: team activity (invites, removals, role changes), customer merge decisions, penalty applications with full history, and admin password changes — all with timestamps and actor attribution.
Self-Service Data Deletion
Contractors can delete their entire account — customers, ratings, notifications, flags, and team activity — at any time, no questions asked. Stripe subscriptions are automatically cancelled before the account is removed.
Security by Design
Protecting contractor and customer information is woven into every layer of the platform.
Database-Level Access Control
Row-level security (RLS) policies enforce ownership and role checks at the database layer — even if a frontend bug or API misuse occurred, the database itself would refuse to return or modify data the user isn't authorized to access.
Server-Side Authorization
Every backend function independently verifies the caller's session and role before processing. Client-side UI state is never trusted — sensitive operations like score recalculation, penalty application, and data exports all require server-verified admin authentication.
Privacy by Default
Contractor contact details are automatically redacted from public views until verification is complete. Customer email and POC details are used solely for duplicate prevention — never shared, marketed, or exposed to other contractors.
Defense in Depth
Admin access requires three independent checks: an authenticated session with an admin role, a route-level role guard, and a bcrypt-peppered password gate — so a single compromised factor is never enough to reach admin functionality.
Who It's For
Contractor Alliance is built for anyone who provides professional services to clients and wants to make smarter decisions about who they work with: