Audit · 5 September 2026

Nomenclature, by who is signed in

Every page in the app, read twice: once as an agent, once as a vendor. The question on each was whether the words on the screen describe what that person is actually there to do. Most of the app already holds one vocabulary. Where it slipped, it was in the older dialogs and forms, in the pages that never asked which side of the marketplace was looking at them, and in one word for the trade side that the app had already stopped using everywhere else. Fixed in the same pass, then walked again in a real browser as both accounts.

Scope every signed-in route, both account types, plus sign-up and the 404 Method code read, then headless Chrome against /demo as Dana (agent) and Mira (vendor) Changes made 25 files in the app, uncommitted, not deployed

The short version

The two sides now read as two products built from one vocabulary, not one product with the other side bolted on.

The trade side is a vendor, everywhere. The nav, sign-up, the hire wizard, the landing page and the waitlist all said vendor. The profile page said contractor, the admin console said contractor in nine places, and three toasts and labels still said provider. All three words are now one word in every string a person reads. Provider stays in the code, as the standing rule says.
A posted job is never a listing. To an agent a listing is a property they represent, which is why the page was renamed Posted jobs. The applications dialog, the edit dialog and the Posted jobs rail still said listing eleven times between them. They say job now.
The other party on a job you are doing is the agent. Every job is posted by an agent, so "Client", which to an agent means a buyer or seller, was the wrong word on the booking dialog, the calendar and the dashboard. The dialog's contact button reads Contact agent on both sides.
Three pages had no idea who was reading them. Calendar told a vendor about "the ones you posted for somebody else", Settings told a vendor to click a Create button that no longer exists and offered them a card form, and the 404 sent a vendor to Find opportunities, a page they do not have. Each now branches on the account type.
The dashboard applied with one click. Opening a job from the home page and pressing Apply inserted an application at the posted price with no message, skipping the price dialog the board uses. For a vendor on a quote-first job that meant a quote with no number in it. The dashboard now opens the same Apply dialog as the board, with Send a quote where the job is priced by the work.
Sentence case, finished. Sign-up, edit profile, edit job, the review dialog and all of Settings were still in title case: Full Name, Add New Card, Frequently Asked Questions. The rest of the app had already moved. Licence and license were both in use; it is license, this is New Jersey.

The vocabulary

This is the rule the pass was checked against. It is Michael's, from the two renames on 5 September, and it is now what the whole app says. The code keeps its own names (provider, listing, /create-service, /my-listings) and nothing in this pass renamed a column, hook, route or component.

The thing	The word	Where it holds
Someone who represents property	agent	Sign-up, every "posted by" line, the counterpart on any job you take. The poster is always the agent.
Someone in a trade	vendor	Nav (Vendors), sign-up, Hire a vendor, the profile subtitle, the admin console, the landing and waitlist.
Work an agent posts for another agent	opportunity	Find opportunities, My opportunities, the wizard title Post an opportunity, its button and toast.
Work an agent posts for a vendor	job	Hire a vendor, Post job / Send job, the vendor's Find work and My jobs.
The unit of work, generically	job	Every count, rail figure and empty state. "Listing" is never used for a posted job.
The button that posts agent work	Get coverage	Header, dashboard door, Posted jobs empty state, How it works. The bar's tab is Post, the first word of the page it opens.
What an agent's posts are called together	Posted jobs	The nav item and the page. It holds both opportunities and vendor jobs.
Saying yes to a priced job	apply	Apply, Apply now, Apply for this job, Application submitted, Awaiting a decision.
Saying yes to a job priced by the work	quote	Send a quote, Priced by quote, By quote. Only quote-first trades ever see it.
Naming a different price on a priced job	your price	Name your price, Your price is with the agent, Asks $110, asking from $95.
Signing in and out	sign in, sign out	Login page, sidebar footer, toasts. Logout is gone.

What each side sees

Read as a pair. Every row is one place; the two columns are the words an agent and a vendor read there. Where a cell says "same", the page does not need to know who is looking.

Place	Agent	Vendor
Menu	Home · Find opportunities · My opportunities · Posted jobs · Vendors · Leads · Referrals · Calendar · Wallet	Home · Find work · My jobs · Calendar · Wallet
Header button	Get coverage	None. The dashboard carries Find work instead.
Phone bar	Home · Find · Post · Vendors · Calendar	Home · Find · My jobs · Calendar · Wallet
Home rail	Next up · Nearby to earn · Waiting on you · Earned (spent as detail)	Next up · Booked · Awaiting a decision · Earned
Home sections	Waiting on you · Your next few days · Earn nearby · Recent activity	Your next few days · Open work · Recent activity
Home, nothing booked	"A job you take, or someone you book for a job you posted, lands here"	"When an agent books you, the job lands here" (was "accepts one of your quotes", wrong for a cleaner)
Board	Find opportunities · "Open jobs near you that another agent can take" · scopes Agent work / Vendor work	Find work · "Jobs in your trade, inside your service radius" · scopes Your trade / Vendor work
Your work	My opportunities · "Work you're doing for other agents… Jobs you posted are under Posted jobs"	My jobs · "The jobs you've been booked for, the applications and quotes still waiting on an answer, and the work you've finished"
Calendar subtitle	"Every job you are booked on, and the ones you posted for somebody else"	"Every job you are booked on, by day"
Calendar month figure	"$520 in pay · $45 to pay" (was "Pay to be quoted" for an agent who only posts)	"$375 in pay"
Wallet subtitle	Paid for covering, paid for coverage, sent to bank	What your jobs have paid, and what has gone to your bank
Profile subtitle	"How other agents and vendors see you before they book"	"How agents see you before they book you"
Edit profile	Full name · Professional title · ZIP code · Bio	Full name · Business name · ZIP code · Service radius · Turnaround · Trade license # · Typical rate · About your work
Settings, banking	Payout setup and the card form	Payout setup only. A vendor never pays here.
Settings, FAQ	How do I post work? How do I get paid? Cancelling: edit the job under Posted jobs	How do I find work? How do I get paid? Cancelling: contact the agent from the job
How it works	Post · Pick · Book and pay · Mark complete	Payouts · Trade and radius · Apply or quote · The agent pays · Get paid
404	Back to home · Find opportunities	Back to home · Find work
Booked job dialog	Counterpart is Covering agent or Vendor on a job you posted, Agent on a job you took	Counterpart is Agent. Contact agent.

The agent dashboard at 1440 wide: Get coverage in the header, a rail of Next up, Nearby to earn, Waiting on you and Earned, then Waiting on you with two posts and their applicants, Your next few days, Earn nearby and Recent activity. — Dana, the agent. Both sides of her day on one sheet: people waiting on her decision, the jobs she is covering, and what she could earn nearby.

The vendor dashboard at 1440 wide for a listing photographer: a Find work button, a rail of Next up, Booked, Awaiting a decision and Earned, then Your next few days empty and Open work with one job marked Sent to you. — Mira, a listing photographer. No Get coverage, no posting language anywhere, and the empty state says "When an agent books you", which is true whether she applies or quotes.

What changed

One word for the trade side

Profile subtitle said "agents and contractors". It now branches: agents read "other agents and vendors", vendors read "agents".
Admin said Contractors, Owed to contractors, Contractor gets, New accounts: contractors, Contractors by trade, and Contractor as an account type in two tables. All vendor now. Two of those figures cover covering agents as well as vendors, so they read Owed on held jobs, Payout and Paid to rather than naming either side.
Provider survived in three strings: the Posted jobs toast ("The provider has been paid"), a saved-vendor button label, and the fallback title under a poster's name ("Real Estate Service Provider", on a person who is always an agent). The first and last now read "Their pay is on its way" and "Real estate agent". The button label sat in the vendor card, which another session rewrote during this pass; its new version carries no role word at all.

No more listings

Applications dialog: "Review and manage applications for this listing" is "Who has applied and what they are asking. Booking one is what pays for the job." Pending Applications is Waiting on you, Processed Applications is Decided, No Applications Yet is Nobody has applied yet, "when users apply for this listing" is "when an agent or vendor applies". A counter-offer reads "$15.00 above the $95.00 you posted". A decided application shows Booked or Rejected instead of the raw status.
Edit dialog was Edit Listing, Basic Information, Service Type, Images, Location Details, Schedule & Pricing, Additional Details. It is Edit job, The job, Kind of job, Photos, The property, Date and pay, Anything else, the same section names the posting wizard uses.
Posted jobs rail said "applicants across 2 listings"; the row said "3 agents applied" under a cleaning job and "bid $110.00" where every other screen says asks. Now "across 2 jobs", "3 applicants", "asks $110.00".
Post an opportunity's own button said Post job and its error said "Couldn't post the job", on the one page whose title is the other word. Post opportunity now.

The other party is the agent

The booked-job dialog's default counterpart was Client, so a vendor and a covering agent both saw "Client: Bluestone Property Group" and a Contact client button. It is Agent, and Contact agent, on the dashboard, the calendar and My jobs. On a job you posted it stays Covering agent or Vendor.
The job preview's fact strip labelled the brokerage Client as well. It reads For now, which is true on both sides.
The dashboard's apply toast said "The client will review it". Gone with the one-click apply; the dashboard now uses the board's toasts.

Pages that now know who is reading

Calendar: subtitle branches, and the month figure adds what an agent owes on jobs they posted instead of showing "Pay to be quoted" beside five booked jobs.
Settings: the card form is agent-only, the FAQ has a posting answer for agents and a finding-work answer for vendors, the cancellation answer says where cancelling actually happens on each side, and the fee explainer no longer addresses an agent as "you" who gets paid by "the agent".
404: "Back to dashboard" is Back to home, since nothing else calls Home the dashboard, and the second button is Find work for a vendor.
Dashboard: Apply opens the price dialog, with Send a quote on quote-first work and the viewer's MLS boards passed through so the access notice shows, the same as the board.

The applications dialog over Posted jobs: Applications for Need coverage — Chapel Hill Road, a line reading Who has applied and what they are asking, then Waiting on you (3) with three applicants, one marked Asks $110.00 and $15.00 above the $95.00 you posted. — The applications dialog, which had kept the old vocabulary longest. Waiting on you, asks, you posted, Booked and Rejected.

The vendor dashboard with the Apply for this job dialog open: At the posted price $375.00 or Name your price, You'd be paid $332.50, Tour Dash fee $42.50, an optional message, Cancel and Apply. — Mira applying from her dashboard. Before, this button inserted the application straight away with no price step and no message.

Sentence case and spelling

Sign-up: Full name, Business name, Brokerage name, Phone number, Confirm password, Trade license #, Typical rate, ZIP code. "Select Radius Location" is "How far you'll travel" on both sides, because that is what the field is.
Edit profile: sentence case throughout, and the field that stores a vendor's business name is labelled Business name for them rather than Professional title. The field that stores a ZIP was labelled Location; it is ZIP code.
Review dialog, Settings (every heading, label, placeholder and button) and the policy text: sentence case. "TourDash" is Tour Dash.
Licence appeared on the vendor's profile badge, sign-up, edit profile and the referral gate. License everywhere.
Sign out replaces Logout in the sidebar, to match Sign in. The sign-in toast is "You're signed in" rather than "You have successfully logged in".
Notifications: the "View all notifications" button only closed the popover, because there is no page. It says Close.

The phone

A second walk at 390 and 320 wide with touch input, as both accounts, every bottom tab and every item in the menu sheet. The bar and the sheet were already current: each label is the page's own name or its first word, the sheet is the complete role-scoped map, and the search box says "Search opportunities" for an agent and "Search work" for a vendor.

Surface	Agent	Vendor
Bottom bar	Home · Find · Post (amber pill) · Vendors · Calendar	Home · Find · My jobs (amber pill) · Calendar · Wallet
Active tab	Lights on Find, Post, Vendors, Calendar and My jobs; nothing lights on a page the bar does not carry, which is correct.
Menu sheet	Home · Find opportunities · My opportunities · Posted jobs · Vendors · Leads · Referrals · Calendar · Wallet · Admin · How it works · Settings · Sign out	Home · Find work · My jobs · Calendar · Wallet · How it works · Settings · Sign out
Header	Menu, wordmark, bell, theme. Get coverage is hidden below 640 because the bar's Post tab is the same door.	Menu, wordmark, bell, theme.
Fit at 320	Every page reads 320 wide except My opportunities, which ran to 376: three tabs with counts, "Awaiting a decision" the widest. Fixed: the strip scrolls inside its own width, and below 640 the tab reads "Awaiting" (the rail beside it spells it out). All three tabs sit inside 320 now.

The agent dashboard on a 390-pixel phone: the summary grid, Waiting on you with two posts, and the bottom bar reading Home, Find, Post, Vendors, Calendar with Post as an amber pill. — Dana on a phone. Post is the bar's one primary, and it opens the same wizard as Get coverage does on the desktop header.

The vendor dashboard on a 390-pixel phone: Nothing booked yet with a Find work button, Open work with one job, and the bottom bar reading Home, Find, My jobs, Calendar, Wallet with My jobs as an amber pill. — Mira on a phone. No Post tab, no Vendors tab; the centre slot is the jobs she has taken.

One naming question is left open on purpose. The bar says Post, the rule being the first word of the page it opens (Post an opportunity); every other button into that wizard says Get coverage. Both follow a stated rule, and they disagree. If the bar should match the header, "Coverage" is the one-word form that fits five tabs at 320; that is Michael's call.

Still open

The skill's standing rule is stale. The /tourdash brief still says "Contractor in the UI, provider in the code". The app has said vendor since the rename and now says it everywhere; the rule should read "Vendor in the UI, provider in the code". One line in the skill file.
The card form under Banking and cards does nothing. It toasts "Card added successfully" and drops the fields. Booking is paid through Stripe Checkout, so the form has no job. It is hidden for vendors now; for agents it should probably go, or become a link to the Stripe customer portal.
Three components are no longer rendered anywhere: QuickAccessTiles, DashboardStats and FindOpportunitiesSection, left behind by the dashboard redesign. They still carry old copy (Hire a provider). Safe to delete; not touched here because they may be another session's.
Money is still written two ways: $95 on the card, $95.00 in the dialog. The September review already lists this; it is not a naming problem, so it was left alone.
The demo agent's title is "Licensed showing agent". Sample data, but it is the one place a reader still meets "showing" as a job word rather than a job type. Cosmetic.

Method

Every page read as code first, with each string a person sees checked against the vocabulary in section 02 and against who can reach the page. The route guards in App.tsx and the nav filter in AppSidebar.tsx were the source of truth for who reaches what.
Every replacement asserted. The edits ran as a script that refused to write a file unless each old string matched exactly once, so nothing was changed by accident and nothing silently missed.
Typecheck and production build both pass.
Walked in a real browser as both accounts. Headless Chrome over the DevTools protocol against /demo, so no live data was touched. As Dana: home, My opportunities, Posted jobs, the applications dialog, Calendar, Settings FAQ and banking, Profile, the 404. Switched to Mira in the demo banner: home, My jobs, Calendar, Wallet, Settings banking and FAQ, How it works, Profile, Edit profile, Find work, and the apply dialog from the dashboard. Then both accounts again at 390 and 320 wide with touch taps: every bottom tab, every menu-sheet item, and the layout width read on each page. The full page text was read out of the DOM on every stop, not just screenshotted.
Another session was rewriting Hire a vendor at the same time (TradePicker, ProviderCard, HireProvider, provider-trades). Those diffs are not part of this pass and were not touched; the tree still typechecks with both sets of changes in it.
Not deployed. The app changes are in the working tree at ~/tour-dash, uncommitted, ready for npm run build and the wrangler deploy once they have been looked at.