Changelog

All notable changes to Tradies Bio® are documented here.
This project follows Keep a Changelog conventions.

---

[3.13.0] — 2026-08-27 — Nova Co-Pilot Context: A Conversational PA with the Tradie in Control

The planned evolution of Tradies Bio® Co-Pilot

This release is the next deliberate step in the Tradies Bio® AI roadmap:

1. Co-Pilot established the conversational business assistant.
2. Nova gave Co-Pilot a clear, natural personality.
3. Nova Voice began a controlled pilot with Stephen Pearce and Ken Hall.
4. Nova Context now gives Co-Pilot a bounded, read-only view of relevant
   information already held in the authenticated tradie's own Tradies Bio® account.
5. Bounded action steps are the planned next migration after Stephen and Ken
   complete context testing and the safety boundaries are confirmed.

This was a pre-planned progression, not a change from assistant to autonomous agent.
The tradie remains 100% in control.

Added — Nova read-only account context

Nova can now act as a helpful conversational PA when a tradie asks ordinary business
questions such as:

• “What quotes have I got recently?”
• “What have I got on today?”
• “Yesterday we followed up money outstanding — what was that about?”
• “What was that about?”

For the current turn, Nova can receive a small, fresh, tenant-isolated snapshot of
the authenticated tradie's own:

• enquiries and customer conversation details;
• quotes and their current status;
• jobs represented in Tradies Bio® enquiry and CRM booking fields;
• follow-ups and their completion state.

The snapshot is separate from Nova's existing conversational history. It is assembled
only when the question needs account context, is limited by source, recency, record
count, field length, and total prompt size, and is never promoted into a new permanent
memory system.

Tradie control and guardrails

Context is information, not authority.

• Nova may explain what the account records say, summarise recent activity, or ask
  one brief clarifying question when “that” could refer to more than one record.
• Customer-entered text is marked as untrusted reference data, never an instruction.
• Missing details must not be invented.
• Contact details that are not needed for the answer are omitted.
• One tradie's records cannot enter another tradie's context.
• Context retrieval does not create, edit, send, schedule, complete, retire, or
  change any record.
• Google Calendar event content, event IDs, event dates, and calendar-derived
  availability are not sent to Nova. Calendar-specific detail remains in My Jobs.
• The presence of context does not grant permission for an action. Existing action
  controls still require a separate, explicit tradie request and confirmation.
• During Stephen Pearce and Ken Hall's controlled Nova Voice learning stage, live actions
  remain blocked: Nova can converse, explain, recommend, and prepare drafts only.

Availability and operation

The context layer is part of the shared Co-Pilot processing engine used by browser,
PWA, voice, and mobile entry points. It is not a separate add-on and no new context
activation switch is required.

• Any authenticated tradie whose account already has Co-Pilot access receives
  the context upgrade automatically when asking an account-related question.
• A tradie opens Co-Pilot once, sends a message, and can continue the conversation
  back and forth in the same chat. Nova uses the existing conversation history for
  natural continuity and builds fresh account context only when needed.
• Nova is not always listening and does not operate in the background. The tradie
  starts each conversation and remains responsible for every decision.
• Nova Voice is now presented to its approved users as a controlled pilot for
  Stephen Pearce and Ken Hall. It still requires the account's voice and
  Co-Pilot access controls. This release does not open voice to every tradie.
• At this stage the context capability is treated as an integral operational part
  of Co-Pilot rather than a separately monetised context product. Existing account
  access controls remain in place until a future commercial rollout decision is
  implemented.

Controlled Nova Voice pilot — change lock — 27 August 2026

Nova Voice has moved from beta wording to a controlled pilot because the first
conversational sessions are working successfully. This is an orderly progression,
not a general rollout.

• Approved users: Ken Hall and Stephen Pearce only.
• Pilot duration: minimum 14 days, with an extension up to four weeks if
  usage is too light to make a reliable decision.
• Pilot evidence: each user should complete at least 10 sessions and
  50 completed turns across at least three days, including Stop/restart,
  microphone denial, backgrounding or phone lock, mute/unmute, and iPhone
  playback fallback checks.
• Context boundary: Nova receives only the authenticated tradie's bounded,
  read-only enquiries, quotes, CRM/job information, and follow-ups. Ambiguous
  references must be clarified rather than guessed.
• Calendar boundary: Google, Apple, and Outlook event content, IDs, dates,
  and derived availability remain outside external Nova prompts.
• Action boundary: learning mode remains conversation and draft only;
  saving, sending, texting, emailing, scheduling, and other live actions remain
  disabled for this pilot.
• Privacy boundary: voice audit records retain support-safe operational
  metadata, not recordings or dictated text; Nova Voice remains foreground-only.
• Rollout lock: no public sign-up, automatic enablement, allowlist removal,
  new persistent memory system, embeddings pipeline, or new integration is
  introduced during this pilot.

The next decision is evidence-based: extend the two-person pilot, invite a small
additional cohort through explicit per-user enablement, or pause for remediation.
Nova Co-Pilot, Tradie Scout, and Never Miss a Call / AI Receptionist remain
separate capabilities.

The next migration — bounded actions after pilot testing

After Stephen and Ken have tested Nova Context in real conversations, the next
planned migration is to explore tightly bounded, tradie-approved action steps, for
example:

• adding an approved appointment to the appropriate workflow;
• recording that a money-outstanding reminder has been sent;
• progressing a clearly identified follow-up;
• offering a proactive next step while waiting for the tradie's explicit approval.

These are roadmap examples, not capabilities released by this context upgrade.
Every future action must preserve explicit approval, idempotency, auditability,
tenant isolation, honest delivery status, and a safe manual alternative when an
external service is unavailable.

Tradies Bio® AI roles remain separate

Tradies Bio® uses several independent AI capabilities. They cooperate toward the
same business outcome but retain different responsibilities and boundaries:

• Nova Co-Pilot — the tradie's conversational PA and operational helper. Nova
  discusses what has been happening, explains records, helps think through the next
  step, and keeps the tradie in control.
• Tradie Scout — opportunity intelligence. Scout identifies relevant leads,
  quotes, follow-ups, and job opportunities for the tradie to consider.
• Never Miss a Call / AI Receptionist — inbound call handling. It answers and
  captures customer enquiries when the tradie cannot take the call.

They work independently, in a spirit of cooperation, to help a tradie:

Win more jobs. Run the business more efficiently. Grow the value of the business.

Win. Run. Grow. with Tradies Bio® AI.

Validation

• The context upgrade passed tenant-isolation, prompt-boundary, source-limit,
  unavailable-data, and conversation-continuity tests.
• Existing Nova learning-mode, Co-Pilot action, and Google Calendar privacy tests
  continue to pass.
• Browser testing confirmed a tradie could ask about a saved quote, continue with
  “What was that about?”, receive a contextual answer, and see no action confirmation.
• The production publish completed successfully on 27 August 2026.

---

[3.12.0] — 2026-08-19 — Google Calendar OAuth Verification Approved

Google approval recorded

Google has approved OAuth app verification for Tradies Bio® (Google Cloud project
tradies-bio, project number 781850304663) for the single approved Google Calendar
scope:

• https://www.googleapis.com/auth/calendar.events

The approval follows the completed verification evidence: the Google consent screen,
plain-English permission disclosure, a customer quote enquiry appearing in Tradies Bio®,
the resulting calendar event, and the Google Calendar disconnect flow. The final
demonstration video is retained as part of the verification record.

The approved operating lane

Google Calendar is an optional, Google-first workflow for Tradies Bio®. It helps a
tradie bring customer enquiries and booking requests into their primary Google Calendar,
see upcoming work in My Jobs, and reduce double handling while on the tools.

The verified Google workflow uses the tradie's primary Google Calendar. It does not
offer Work-versus-Personal selection or multiple-calendar support. Outlook and Apple
Calendar remain separate integrations for accounts that have connected them; they are
not part of this Google OAuth verification or presented as equivalent Google workflows.

Tradies Bio® remains a guest in a tradie's calendar:

• the tradie chooses whether to connect;
• Calendar settings clearly show whether the Google Calendar connection is active;
• the tradie can disconnect from My Jobs → Calendar settings at any time;
• disconnect clears local credentials and revokes the Google grant;
• existing calendar events remain in the tradie's calendar.

Events created before the primary-calendar conversion are left untouched when their former
calendar is known or cannot be established after a prior disconnect; they are not silently
recreated in primary. New Tradies Bio® calendar events use primary Google Calendar.

Change-control commitment

This approval is not a blanket approval for future Google data use. Before releasing
any calendar-related change, Tradies Bio® must decide whether a new Google verification
request is required. This review is mandatory before:

• requesting an additional OAuth scope, including calendar.readonly;
• changing the OAuth consent screen or scope justification;
• expanding what calendar data is read, written, retained, shared, or used;
• introducing a new calendar-related feature or public claim.

The Google OAuth operating guide and 12-week review checklist are maintained in
docs/google-oauth-operating-guide.md.

Changed

• Public calendar and onboarding information now explains the approved primary-calendar
  workflow in plain English.
• Calendar setup no longer says another permission is awaiting approval.
• Outlook and Apple Calendar are accurately identified as separate account integrations,
  not as part of the verified Google Calendar workflow.
• The Google OAuth guide now establishes permanent due-diligence guardrails for all
  applicable Google policies and procedures, with an immediate baseline review required
  before the recurring 12-week cadence begins.

---

[3.11.0] — 2026-08-16 — Google OAuth Verification #3: Full Compliance, Honest Disclosure & Tradie Benefit

A statement of principle — why this release exists

By Stephen Pearce — Founder, Tradies Bio®

Tradies Bio® will not mislead, misrepresent, or give false information — under any circumstances — to a tradie, to Google, or to any third party. This is not a legal position; it is a character position. We say what we do, and we do what we say.

A tradie's Google Calendar belongs to the tradie. It is their diary, their business, their private life. Tradies Bio® is a jobs platform — our purpose is to help tradies win more work, run their business more efficiently, and build the long-term value of everything they have worked for. Google Calendar is one tool we use to help deliver that outcome. We are a guest in the tradie's calendar. We facilitate; we never own, control, or exploit.

Every disclosure, every data statement, and every policy on this platform reflects that principle exactly. Where we found gaps between what we said and what we actually do, we fixed them before proceeding with this verification submission.

---

What this release addresses

This release completes the third and final round of compliance corrections required before Tradies Bio® can pass Google's formal OAuth verification review for the calendar.events scope. Google's verification team checks every layer of the application — the connection screen a tradie sees before authorising, the dedicated disclosure page, and the published privacy policy. All three must agree with each other and with the code. This release makes that true.

---

Issues found and resolved

1. Scope mismatch — the root cause of verification failure (Fixed in today's session)

The application was silently bundling a previously-granted calendar.readonly scope into new OAuth requests via a parameter called include_granted_scopes. This meant tradies' consent screens were showing both calendar.events and calendar.readonly — but Google Cloud Console only registered calendar.events. Google's reviewer flagged the discrepancy. The parameter has been removed. The consent screen now shows exactly one scope — calendar.events — matching the registered scope precisely.

2. False claim removed from disclosure page and privacy policy (Fixed)

Both tradiesbio.au/google-calendar and tradiesbio.au/privacy incorrectly stated that calendar.events "grants read access to the calendar list." It does not. Listing a tradie's calendars requires a separate scope (calendar.readonly). Stating otherwise was factually incorrect and could have caused Google to reject the submission for misrepresenting scope behaviour. Both documents have been corrected.

3. Tradie Scout was absent from the pre-OAuth connection screen (Fixed)

The connection screen — the panel a tradie sees before tapping through to Google's consent page — listed two uses of the calendar.events scope (reading busy times, writing new bookings) but said nothing about Tradie Scout, which also reads calendar data. Google's policy requires every use of a scope to be disclosed to the user before authorisation. Scout has been added as the third benefit row on the connection screen with explicit language: "reads your available time gaps (start and end times only — never event details)."

4. Scout timing was vague — "always active" needs clarification (Fixed)

The disclosure page and privacy policy described Scout without saying when it accesses calendar data. The correct answer is: Scout reads calendar data when a tradie opens Co-Pilot and requests its analysis. It does not run silently in the background without the tradie's interaction. Both documents now state this explicitly.

---

What Tradies Bio® reads from Google Calendar — and why

Feature	What is read	When	Stored?
My Jobs	Event title, location, description, start/end time	When tradie opens My Jobs	Never
Tradie Scout	Start and end times only — no titles, descriptions, or attendee data	When tradie opens Co-Pilot	Never

What Tradies Bio® writes to Google Calendar — and why

Trigger	What is written
Customer books via Bio page	A new calendar event: job type, customer name, location, start/end time, contact details, enquiry reference

Tradies Bio® never deletes or modifies events a tradie has created themselves. We only create new events. We operate only on the specific calendar the tradie connects.

---

Benefit to the tradie — Enquiries, Jobs, Scout

Enquiries

Every call, web enquiry, WhatsApp message, and Bio page booking lands in the tradie's Enquiries dashboard — one place, all channels. The Enquiries card on the dashboard is prominently highlighted so no lead is ever missed. When a customer books, Tradies Bio® writes the job directly into the connected Google Calendar so there is no double-handling and no risk of missing the appointment.

Jobs (My Jobs)

The My Jobs view pulls the next 10 days of calendar events into the tradie's dashboard in a clean, on-site-friendly list. No need to open a separate calendar app on the tools. When Google Calendar is connected, the list updates live — new bookings from the Bio page appear automatically. Jobs are grouped by day with time, location, and a clear visual indicator for today.

Tradie Scout

Scout is the AI agent that works for the tradie even when they are on the tools. It reads the tradie's calendar gaps (start and end times only) and cross-references them against open quotes, unanswered enquiries, and follow-up reminders logged in Tradies Bio®. When the tradie opens Co-Pilot, Scout surfaces the single most urgent opportunity with a plain-language briefing — "You have a quote for Paul Smith that has been open 12 days and you have availability Thursday morning." The tradie taps once to follow up, and Co-Pilot handles the rest.

Scout reads only the minimum data required to do its job. Event titles, attendee names, descriptions, and private details are never requested and never received.

---

Google OAuth verification — test account and video evidence

To support this verification submission, a dedicated Tradies Bio® test account has been established:

• Test account email: tradiesbiotesttradie01@gmail.com
• Status: Account credentials (email and password) have been shared directly and privately with Google's verification team — not published anywhere on this platform.

A video demonstration will accompany this submission. The video records a complete end-to-end flow:
1. Logging in as the test tradie account
2. Navigating to My Jobs → tapping "Continue with Google Calendar"
3. The updated connection screen — showing all three scope uses including Scout
4. Google's consent screen — showing only calendar.events as the requested scope (no calendar.readonly)
5. Approving the connection
6. Calendar events appearing in My Jobs

This video, together with the test credentials and a step-by-step instruction document, will be sent directly to Google's verification team by email reply — not resubmitted through Google Cloud Console, which would restart the queue.

Tradies Bio® will provide a separate video explanation of how Tradie Scout uses Google Calendar data, confirming that Scout reads only start and end times and that the data is never stored, shared, or used for any purpose other than surfacing job opportunities to the tradie in real time.

---

Added

• Scout disclosed on pre-OAuth connection screen with explicit scope justification language
• Scout timing disclosure added to /google-calendar and /privacy — clarifies Scout reads on-demand when tradie opens Co-Pilot, not in the background
• Win / Run / Build framework woven into /google-calendar disclosure page — articulates the three strategic goals of Tradies Bio® and maps each calendar feature to a tradie benefit
• Dedicated test Google account (tradiesbiotesttradie01@gmail.com) established for Google verification evidence

Changed

• Pre-OAuth connection screen (My Jobs → gcal-info-panel): three benefit rows now cover Read (prevent double-bookings), Write (sync new bookings), and Scout (find available gaps) — all three uses of calendar.events are now explicitly disclosed before the OAuth redirect
• Scope description in /google-calendar corrected: removed false claim that calendar.events grants access to the calendar list (it does not — that requires calendar.readonly)
• Scope description in /privacy corrected: same false claim removed and replaced with accurate read/write/Scout breakdown
• Calendar picker section updated to reflect current behaviour: defaults to Primary Google Calendar; separate calendar selection (Work vs Personal) pending calendar.readonly approval
• WIN / RUN / BUILD section divider labels removed from dashboard — declutters the UI
• Enquiries card on dashboard given a prominent double orange border to visually prioritise it as the most important action for the tradie

Fixed

• include_granted_scopes=True removed from OAuth URL — this parameter was silently bundling the old calendar.readonly token into every new request, causing the scope mismatch that Google flagged
• Calendar picker (gcal_pick) no longer crashes with an error after OAuth connect — gracefully falls back to Primary Calendar when calendarList.list() is unavailable under the current scope

---

[3.10.0] — 2026-08-11 — AI Voice Pilot Launch: Nova, Scout & Google Calendar

Added

• Nova voice for Co-Pilot — Beta testers Stephen Pearce and Ken Hall successfully completed the first live voice conversations with Co-Pilot on 11 August 2026. Tradies tap the microphone, speak their question, tap again, and Nova speaks the answer back aloud. Powered by OpenAI speech-to-text and the gpt-audio voice model (Nova). No typing required — designed for on-site, hands-free use on iPhone via Safari.
• Scout opportunity scanner — Pilot confirmed live — Scout silently monitors each tradie’s pipeline in the background: stale quotes, unanswered enquiries, and open calendar days. It surfaces the single most urgent opportunity with a plain-language briefing and hands it to Co-Pilot with one tap for immediate follow-up. Every outcome is logged — actioned opportunities are never repeated. Phase 2 (Co-Pilot queries Scout automatically in natural conversation) is in development.
• Google Calendar OAuth verification submitted — Tradies Bio® has lodged a formal OAuth verification application with Google, including a recorded demonstration video. Until Google grants approval, tradies who connect their Google Calendar will see a standard Google “unverified app” screen — the connection is safe and functional. Verification submitted 8 August 2026. Connecting to Google Calendar is treated as a privilege: Tradies Bio® reads events only; no edits, deletions, or data sharing occur.

Changed

• Co-Pilot speech-to-text switched from whisper-1 to gpt-4o-mini-transcribe (Replit AI proxy compatibility)
• Co-Pilot text-to-speech switched from tts-1/audio/speech to gpt-audio via chat completions with Nova voice (Replit AI proxy compatibility)

---

[3.9.5] — 2026-08-07 — Google OAuth Verification: Transparency, Trust & Tradie Control

A note on why this matters

By Stephen Pearce — Founder, Tradies Bio®

Connecting to Google Calendar inside a business platform is a privilege, not a right. Google requires any application seeking to integrate with its Calendar API to demonstrate — in writing and on video — that the application handles user data responsibly, explains itself clearly before requesting access, and gives users genuine control to disconnect at any time.

This release is our formal response to that requirement. Every change below exists because it is the right thing to do for tradies — and because it is what Google's verification process demands. The two goals are the same goal.

---

What was built

Pre-authorisation Info Panel (My Jobs)

Before a tradie is redirected to Google's OAuth consent screen, Tradies Bio® now displays a clear, plain-English explanation panel. This panel appears the moment a tradie taps "Continue with Google Calendar" — before any data request is made, before Google is contacted.

The panel explains three things:
- See your next 10 days of jobs — appointments appear in My Jobs, no app switching on-site
- Create job bookings automatically — customer bookings from the Bio page go straight into the calendar
- Track follow-up appointments — quotes, check-ins, and return visits stay on the radar

A "Not now" button lets the tradie close the panel without proceeding. Google receives the connection request only when the tradie actively taps "Connect my Google Calendar."

Sidebar — My Calendar Section (Always Visible)

The sidebar navigation now includes a permanent My Calendar section, visible to every logged-in tradie without scrolling. It shows:
- A direct My Jobs — Next 10 Days link
- When connected: a green "✅ Google Calendar connected" status pill alongside a clearly visible red Disconnect button
- When not connected: an invitation to connect via the My Jobs page

This makes disconnecting a first-class, one-tap action — not a buried setting. It is permanent, prominent, and always reachable.

Disconnect Button (My Jobs Page)

The previously invisible disconnect button on the My Jobs page has been replaced with a clearly visible red button, styled for immediate recognition. It now includes a confirmation prompt to prevent accidental disconnection.

Privacy Policy — Full Google API Compliance Update

The Privacy Policy at tradiesbio.au/privacy has been updated across four areas:

1. Platform scope redefined — the opening statement now accurately describes Tradies Bio® as a PWA, personal tradie dashboard, and integrated platform — not just a "website." The Consent clause names the PWA, dashboard, and Google Calendar integration explicitly.

2. Informed consent section added — documents the pre-authorisation info panel, confirming tradies are informed of the purpose before any OAuth redirect.

3. Revoking access — fully detailed — names the exact sidebar location (My Calendar section) and My Jobs page disconnect button by name. Documents revocation from Google's own permissions page (myaccount.google.com/permissions). Confirms that all stored tokens and the calendar ID are deleted immediately on disconnection.

4. Google API Services Limited Use Compliance — the required compliance statement is published at tradiesbio.au/privacy#limited-use and available as the compliance URL for Google Cloud Console submission.

Terms of Service Page

A dedicated Terms of Service page is now live at tradiesbio.au/terms. This fulfils a Google OAuth consent screen requirement — the consent screen must link to both a Privacy Policy and a Terms of Service before Google will approve an application.

---

Why this release is significant for monetisation

Google Calendar integration is the foundation for future paid features:
- Automated job booking from the Bio page directly into a tradie's calendar
- AI-assisted scheduling through Co-Pilot
- Follow-up appointment reminders and Tradie Scout diary analysis

None of those features can be offered commercially until Google approves the OAuth integration. This release makes that approval possible.

---

Google verification checklist — completed

Requirement	Status
Privacy Policy published at a stable URL	✅ tradiesbio.au/privacy
Terms of Service published at a stable URL	✅ tradiesbio.au/terms
Limited Use compliance statement at linkable anchor	✅ tradiesbio.au/privacy#limited-use
App explains purpose before OAuth redirect	✅ Pre-auth info panel
Users can disconnect from within the app	✅ Sidebar + My Jobs page
Users can disconnect from Google's side	✅ Documented in Privacy Policy
Google data not sent to AI services	✅ Documented in Privacy Policy
Consent language covers PWA and dashboard	✅ Updated opening statement
Demo video showing OAuth consent screen	⏳ To be recorded by founder

---

Stephen Pearce
Founder — Tradies Bio®
7 August 2026

---

[3.9.4] — 2026-08-01 — My Jobs Now Connects to Google Calendar

A milestone for Tradies Bio®

By Stephen Pearce — Founder, Tradies Bio®

This is a genuine platform milestone. For the first time, the Tradies Bio® dashboard PWA can reach outside itself and pull real job data from the world's most popular calendar — Google Calendar.

Every tradie carries their jobs in their head, in a notebook, or scattered across their phone. Now, any tradie who uses Google Calendar to track appointments can connect it directly to their Tradies Bio® dashboard. Their jobs appear automatically in My Jobs, sorted chronologically, showing the next 10 days at a glance — from the same PWA they already use every morning on site.

This is not a gimmick. This is a tradie's entire schedule, in the palm of their hand, inside the same tool they use to send reviews, handle enquiries, and manage their vault. It turns a business card app into a business operating system.

---

What was built

Google Calendar OAuth Integration (Full Production)

• Any tradie can tap Connect Google Calendar from the My Jobs screen — they are taken through Google's standard secure sign-in flow and asked to grant read access to their calendar
• Tradies choose which calendar holds their jobs (e.g. "Tradies Bio Calendar", "Work", "primary") from a live picker showing all their Google calendars
• The next 10 days of events are displayed in My Jobs, sorted by date and time, with the event title, date, time, and duration shown clearly
• The token is stored securely against the tradie's account and auto-refreshes silently — tradies never have to reconnect unless they revoke access from Google
• A Disconnect option is always available so tradies remain in full control of what they share

How it works — under the hood

Google Calendar connection uses the industry-standard OAuth 2.0 protocol with PKCE (Proof Key for Code Exchange) — the same secure handshake used by major apps like Xero, MYOB, and Canva. No password is ever shared with Tradies Bio®. Google issues a private token that only works for this app, which can be revoked at any time from the tradie's Google account settings.

The connection is now live at tradiesbio.au and enabled for all tradies on the platform.

Also ready (dormant — no credentials required from tradies)

• Microsoft Outlook Calendar — the full OAuth flow is built and ready to activate the moment an Azure app registration is configured
• Apple iCloud Calendar — connect via ICS paste (already live)

---

Why this matters

A tradie who sets up Google Calendar connection gets:
- Their jobs visible the moment they open the PWA on site
- No double-entry — jobs they add in Google appear automatically in Tradies Bio®
- One less app to switch between — their business card, vault, enquiries, and schedule are all in one place

This is the beginning of Tradies Bio® becoming the single screen a tradie needs on site.

---

Stephen Pearce
Founder — Tradies Bio®
1 August 2026

---

[3.9.3] — 2026-07-26 — Booking QR: A Simple Way to Capture Your Next Job

The idea in plain language

A tradie finishes a job, or is mid-site talking to a customer, and the customer wants to book them again. Right now that means swapping numbers, hoping someone follows up, and often the job goes nowhere. This update gives every tradie a printed QR code they can leave behind — on a fridge, a window sticker, the back of a business card, or handed over on the phone. The customer scans it, fills in four fields, and a request lands in the tradie's Enquiries dashboard. That's it. The tradie is still running the show — they decide when to call back, what to quote, and whether to take the job.

This is not a booking system. It is a job-capture tool. The next job starts here.

---

What was built

New — Customer Booking Page (/u/<slug>/book)

• A clean, standalone page — no bio sidebar, no distractions — showing only the tradie's name and a short form
• Four fields the customer fills in: Name, Mobile, What do you need done, Preferred date (date picker), Preferred time (Morning / Midday / Afternoon / Flexible)
• On submit, the customer receives an SMS confirmation immediately: "Thanks [name], [Tradie] has received your booking request and will be in touch shortly"
• The page works on any device — phone, tablet, desktop — without the customer needing an account

New — Booking request lands in Enquiries

• Every submission appears in the tradie's Enquiries dashboard exactly like a web enquiry — but with a distinct orange 📅 Booking Request badge so it cannot be confused with a regular message
• The preferred date and preferred time appear highlighted in orange inside the enquiry card
• A new 📅 Bookings filter tab lets the tradie view only booking requests in one tap
• The tradie receives an email notification with the customer's details, preferred date, and a direct link to Enquiries — same reliable pattern as all other enquiry alerts

New — Booking QR on the Share page

• A new 📅 Booking QR accordion card on the Share page sits alongside the Bio QR
• Preview shows the QR in-browser; Download QR delivers a high-resolution PNG ready to print, laminate, or send to a signwriter
• A Copy Link button copies the booking URL for sharing via SMS, email, or WhatsApp manually

New — Tool Box shortcut

• 📋 Booking QR shortcut added to the Tool Box on the dashboard — one tap to the Share page, QR ready to download

New — "Book Me" button on the public Bio page (Task #67)

• Customers who land on the tradie's Bio page (/u/<slug>) via any link see a prominent 📅 Book Me button that takes them straight to the booking form — no extra steps

---

How the QR code gets used in the field

Situation	How
Finishing a job on-site	Show the customer the QR on your phone; they scan, done
Leaving a fridge magnet or window sticker	Print the QR from Share → Download QR; stick it anywhere
Business card	Add the QR to the back at your next print run
Follow-up text	Copy the booking link from Share and paste it into an SMS
Bio page visitors	The Book Me button is already there — no action needed

---

The tradie is still running the show

The booking request is a signal, not a commitment. Nothing is confirmed, no slot is locked, no price is set. When the request arrives, the tradie reads it, decides if the job suits them, and calls the customer back in their own time — using the phone, SMS, or enquiry tools already in the platform. If they don't want to take the job, they simply don't call. The customer cannot see whether their request was read, accepted, or declined — there is no automated calendar, no instant confirmation of availability, and no way for the customer to select a time slot. The tradie chooses when to respond and what to say.

That is the point. The QR makes it easy for the customer to raise their hand. The tradie decides everything after that.

---

Security

• The booking page is fully public — no login required — but is rate-limited to prevent spam
• CSRF protection applies to the submission form
• The customer's mobile number is normalised and validated server-side before any SMS is sent
• SMS acknowledgement fails silently if Twilio is unavailable — the enquiry record is always saved regardless

---

Changed — siri_shortcuts email (emails/siri_shortcuts.html)

• 5 Apple Shortcuts iCloud install buttons now appear at the very top of the email — right after the greeting — so a tradie can tap-to-install immediately without scrolling
• Each shortcut shown in a compact two-column row: dark label on the left, orange 🍎 Install → button on the right
• Footer hint below the 5 buttons: "All 5 installed? Scroll down — Hey Siri setup steps are below"
• Subject line updated to 🚀 Start Your Engines — 5 Apple Shortcuts for Your iPhone
• Step 2 (detailed install cards) remains intact further down the email for tradies who want context

---

[3.9.1] — 2026-07-20 — Start Your Engines: Preview-Only, Individual Send, Correct Label

Changed — "Start Your Engines" is now individual-only — no batch fire

• Test Lab batch-fire-to-all card replaced with a Preview to My Inbox card
• Pick any tradie from a dropdown — the email renders with their Facilitator's name in the sign-off, exactly as the tradie would see it
• Email fires to Stephen's inbox only — the tradie is never contacted
• No EmailLog entry is created (it is a preview, not a real send)
• A clear link to "Admin → Communications" guides Stephen to the real individual-send button
• Individual send (from the tradie's comms page → 🍎 Send Shortcuts →) is unchanged and works as before

Fixed — Label shown in email history now reads correctly

• siri_shortcuts email type was labelled "Part 2 — Go Hands-Free on Your iPhone" everywhere (email history, comms page, tracker)
• Now correctly labelled 🚀 Start Your Engines — Apple Shortcuts in all admin views

---

[3.9.0] — 2026-07-20 — Test Lab: Search, Collapsible Sections, Alphabetical A–Z Navigation

New — Test Lab navigation overhaul (/admin/test-lab)

• Search bar at the top: type any keyword (e.g. "batch", "shortcuts", "monthly", "sheets", "ABN") to instantly filter sections and cards — non-matching sections collapse, matching ones expand automatically
• Collapsible sections — all 9 sections now use native <details>/<summary> elements; closed by default to save real estate on mobile; tap any section heading to expand
• Batch Actions section (🚀) — always open on load; sits at the top of the TOC as the featured green entry so "Start Your Engines" and "Android Routines" are never more than one tap away
• Alphabetical A–Z TOC — sections listed: Batch Actions, Email Templates, Facebook / QuickStart, Integration Tests, Monthly Check-In, Page & Form Tests, Pinned (Facilitator), Questionnaire 2026, Signup Simulation, Super Admin (bottom, Super Admin only)
• TOC links auto-open the target section on click, then smooth-scroll to it
• Pinned panel links auto-open the parent section before scrolling to the card (so collapsed state doesn't break pinned shortcuts)
• ✕ Clear button on search restores default section states

---

[3.8.9] — 2026-07-20 — Start Your Engines: Apple Shortcuts Batch, Facilitator Attribution, Mail Fix

Fixed — Credentials Pack email logging as "pending"

• credentials_pack was missing from the send_tradie_email template map — caused every admin click to log "pending, no mail server" even when mail server is live. Now correctly routes to emails/credentials_pack.html.
• prospect_nudge also added to template map (was also missing).

Fixed — Admin tradie comms page: email button clarity

• Removed credentials_pack, admin_invite, accountant_referral, and gbp_support_request from the admin Send Email button list (these require special context or are not tradie-directed drip emails)
• Added footnote: "Credentials Pack is sent by the tradie from their own Vault"

New — Facilitator attribution on Admin Comms page

• Tradie detail comms page now shows the assigned Facilitator's name, email, and phone in orange under the tradie header
• "No Facilitator assigned" shown clearly when unassigned

New — "Start Your Engines" — 5 Siri Shortcuts button (individual + batch)

• Prominent dark-background action card on each tradie's comms page with one-click "🍎 Send Shortcuts →" button
• Shows which Facilitator's name will appear in the sign-off block
• Batch in Test Lab updated: now fires to ALL tradies (removed iOS-only filter, reduced cutoff from 5 days to 2 days)
• Batch result shows Facilitator name per tradie — for Facilitator follow-up calls

The 5 iCloud links included in every "Start Your Engines" email

• 🚀 Start Your Engines → https://icloud.com/shortcuts/34c72d5e2d4c4330ae001d6413969c3e
• ✍️ Tradie Quote → https://icloud.com/shortcuts/b702a03bb1a84242a32a0f9f3f677f29
• 💰 Tradie Money → https://icloud.com/shortcuts/c9572cd92c1a49d8be72d782954f0d8f
• 🏊 Tradie Swims → https://icloud.com/shortcuts/ee9b53fa2ea9493fbb63843143648fc4
• 📅 Tradie Follow → https://icloud.com/shortcuts/04cef60d36974183b62d7f90901dc9ef

---

[3.8.8] — 2026-07-20 — Pitch Deck: Version Footer, PDF Download in Admin, 22-Slide Labels

Added — Slide Footer: Version Badge

• Every slide footer now shows V-TB-accountants-005 in grey next to the Tradies Bio® logo — confirms version at a glance in print and on-screen

Updated — Accountant Package (Admin)

• Step 1 now has two links: "Open Deck — 22 Slides (Live)" and "📄 Download PDF — 22 Slides (Officeworks / Print)"
• PDF download note: "PDF is print-ready — take to Officeworks for colour A4 or A3 copies"
• Link label shows V-TB-accountants-005 so the version is visible before downloading

PDF Regenerated

• 22 slides, 5.4 MB → static/docs/accountant-pitch-deck-2026.pdf — includes version badge in every footer

---

[3.8.7] — 2026-07-20 — Pitch Deck: Real Photography Across All Voice Command Slides

Second image pass on the accountant pitch deck — all five voice command slides now carry outstanding real photography from the Tradies Bio® branding library and tradies-speaks carousel. PDF regenerated at 22 slides, 5.4 MB.

Updated — Slide: Tradie Money (Slide 5)

• Right panel: full-bleed tradie-voice-command-branding.png — construction site, tradie in hi-vis with phone, AI voice bubble "Check the job specs for Smithson's project, will ya?", phone screen showing "Listening… Checking Smithson's project…" — replaces previous icon graphic

Updated — Slide: Tradie Quote (Slide 4)

• Right panel: full-bleed tradie-quote-branding.png — bold orange/black "QUOTE IN SECONDS!" marketing graphic — replaces grey placeholder comparison image

Updated — Slide: Start Your Engines (Slide 6)

• Right panel: full-bleed tradie-voice-command-branding.png — same construction-site photography as Money; slides are separated by three intervening slides — replaces old dashboard screenshot

Updated — Slide: The Calendar Automation System (Slide 5.75)

• Left panel: replaced previous phone screenshot with automated-diary-card-clean.jpeg (IMG_6350) — the clean Automated Diary carousel card ("Secure the next job. Before you drive away.") at 88% width with premium shadow — the product speaks for itself

Updated — Slide: Family Time (Slide 8)

• Background: replaced old JPEG with tradie-home-time-2.png — branded "More home time" family BBQ photography at 40% opacity with white-to-transparent gradient overlay — reinforces the emotional close

Technical

• All photography sourced from existing Tradies Bio® branding library (/static/branding/) and carousel — no third-party images
• Caption bars added to all updated voice command panels (dark rgba(26,26,46,0.78) overlay, uppercase label)
• PDF regenerated: 22 slides, 5.4 MB → static/docs/accountant-pitch-deck-2026.pdf

---

[3.8.6] — 2026-07-20 — Accountant Pitch Deck Rebuild — 22 Slides, New Images, Partner Terminology

Pitch deck rebuilt for accountant presentations on 29 July and 6 August 2026. Three slides updated with real product photography, "Partnership" removed from all accountants-facing pages, and the PDF regenerated at 22 slides.

Updated — Slide: Tradie Follow-up (Slide 5.5)

• Right panel replaced with the Tradie Follow Up branded photography (tradie at ute with tablet showing calendar) — removes placeholder screenshot, installs the actual marketing asset

Updated — Slide: The Calendar Automation System (Slide 5.75)

• Left panel replaced CSS card mockup with the actual live dashboard screenshot (Automated Diary — "Secure the next job. Before you drive away.") — accountants now see the real product

Updated — Slide: It All Comes Together (Slide 7)

• Dashboard proof strip added below the 5-command grid — real Siri shortcuts screenshot + "Live in the dashboard now" anchor, removes any doubt the system is live

Updated — Slide: Quick Reference (Slide 14)

• Deck index section heading "The Partnership" → "The Partner Opportunity" — consistent with accountants-page terminology rule

Fixed — Accountants Pages — "Partnership" → "Partner"

• main/accountants.html: "The Accountant Partnership" → "The Accountant Partner"; "Partnership Proposal" → "Partner Proposal" (heading and agenda title)
• public/accountants.html: "The Three-Way Partnership" → "The Three-Way Partner Programme"
• Rationale: "Partnership" in front of accountants implies legal/liability exposure; "Partner" signals commercial opportunity

Updated — Admin Sidebar

• "Pitch Deck — All 18 Slides" → "Pitch Deck — All 22 Slides"
• "Download PDF — 18 Slides" → "Download PDF — 22 Slides"
• PDF at /static/docs/accountant-pitch-deck-2026.pdf regenerated (22 slides, 19.9 MB)

---

[3.8.5] — 2026-07-20 — iPhone Onboarding Email — Siri Shortcuts (Part 2)

New email specifically for iPhone tradies: "Part 2 — Go Hands-Free on Your iPhone" (siri_shortcuts email type). Mirrors the Android Routines drip in timing and purpose — sent 5 days after signup to iPhone tradies who haven't yet received it.

New — Email Template (emails/siri_shortcuts.html)

• Highlights the Siri lock-screen advantage over Android (works with screen off, gloves on)
• All 5 Apple Shortcuts presented as one-tap iCloud install buttons — no manual setup
• Quick-reference table: all 5 phrases and their destination pages
• 4-step "how to use" section (Hey Siri from lock screen, speak command, page opens, troubleshooting)
• Tradie Follow shortcut card uses dark green (#0d5c3a) to distinguish it as Step 5 after the job
• Closes with personal call offer from team — the facilitator follow-up hook

New — Email Type Registration

• EmailLog.EMAIL_TYPES: "siri_shortcuts" → "Part 2 — Go Hands-Free on Your iPhone"
• Appears automatically in admin Communications register and tradie comms view
• mailer.py template_map updated — routed via standard send_tradie_email()

New — Test Lab (/admin/test-lab)

• Individual fire card: 🍎 iPhone — Day 5 Follow-Up — "Fire to My Inbox" (dark green)
• Batch fire panel: finds all iPhone tradies 5+ days old who haven't received this email, fires to all, shows results with facilitator names
• Facilitator/Stephen/Ken phone call hook built into the panel description

---

[3.8.4] — 2026-07-20 — Tradies Speaks — All 5 iCloud Shortcuts Confirmed

All five Apple Shortcuts iCloud links confirmed by Stephen Pearce and locked into the platform. Links updated across the admin procedures table and the Edit Profile shortcut card grid.

Confirmed iCloud Links — Tradies Speaks Suite

Shortcut	Siri Phrase	iCloud Link
Start Your Engines	"Hey Siri, Start Your Engines"	https://www.icloud.com/shortcuts/34c72d5e2d4c4330ae001d6413969c3e
Tradie Quote	"Hey Siri, Tradie Quote"	https://www.icloud.com/shortcuts/b702a03bb1a84242a32a0f9f3f677f29
Tradie Money	"Hey Siri, Tradie Money"	https://www.icloud.com/shortcuts/c9572cd92c1a49d8be72d782954f0d8f
Tradie SWMS	"Hey Siri, Tradie Swims"	https://www.icloud.com/shortcuts/ee9b53fa2ea9493fbb63843143648fc4
Tradie Follow	"Hey Siri, Tradie Follow"	https://www.icloud.com/shortcuts/04cef60d36974183b62d7f90901dc9ef

Next Step — Onboarding Email Integration

All 5 links are ready to be embedded as one-tap install buttons in the tradie welcome email sent at signup. Tradie taps each link on their iPhone — shortcut installs in one tap, no App Store required.

---

[3.8.3] — 2026-07-20 — Feature Spotlight: Tradie Follow-up Scheduler — Building Customers for Life

Why This Matters — The Business Case

Every tradie knows the feeling. You finish a great job. The customer is happy. You pack up, drive away — and that customer is gone. Maybe they call again in a few years. Maybe they don't. Maybe they call someone else because they couldn't remember your name.

That single moment — leaving a job site without locking in the next touchpoint — is one of the most expensive habits in the trades industry. Not because the job was bad. Because there was no follow-up.

Tradies Bio® has solved this. It's called the Tradie Follow-up Scheduler. And it is free.

A tradie who services a customer's air conditioning unit in January could be back in twelve months for the annual service — if they booked the return visit on the day they did the job. That one follow-up, repeated across twenty customers, is not a small thing. It is the difference between a tradie who is always chasing new work and a tradie whose diary is already half-full before the week begins.

Think about the lifetime value of one customer. A plumber who fixes a tap for a family in their first home may be the same plumber who replaces the hot water system, renovates the bathroom, and services the pipes for twenty years. That relationship is worth tens of thousands of dollars — if the tradie stays in touch. The follow-up is not a courtesy. It is a business strategy.

Tradies Bio® puts that strategy into the hands of every tradie on the platform. Free. From the job site. By voice.

---

How It Works — The Tradie's Side

Step 1 — Finish the job

The tradie completes the work. Before they drive away, they open the Tradies Bio® dashboard. The "Finished a Job?" card is right there — five steps, one card. Step 5 is Schedule Follow-up.

Step 2 — Open the Follow-up Scheduler

One tap on "📅 Schedule Follow-up — Step 5" (or say "Hey Siri, Tradie Follow" while still at the job site). The Follow-up Scheduler opens instantly at tradiesbio.au/dashboard/follow.

Step 3 — Set the details

The tradie fills in:
- Customer name (who the follow-up is for)
- Contact — email or phone
- Date — 1 month, 3 months, 6 months, 12 months — the tradie decides
- Time — morning, afternoon, or a specific time
- Type — Service Return / Phone Call / Quote / Inspection / Other
- Summary — a short note about what was done and what the follow-up is for

This takes under two minutes. The record is saved permanently inside Tradies Bio®.

Step 4 — Send it straight to the calendar

This is where the platform does the heavy lifting. The tradie taps the blue "Open in Google Calendar" button. The calendar app opens — on the tradie's phone, on their tablet, in their browser — with every field already filled in: the customer's name, the date, the time, the notes.

No manual entry. No copy-paste. No re-typing.

The tradie taps Save in Google Calendar (or Outlook, or Apple Calendar — the tradie's existing calendar, whichever one they use). The event is locked in. The diary is updated. The follow-up will not be forgotten.

Works with every major calendar:
- 🗓 Google Calendar — calendar.google.com opens directly, pre-filled
- 📅 Microsoft Outlook — same direct-link method, pre-filled
- 🍎 Apple Calendar — calendar.apple.com opens directly, pre-filled

No API keys. No account linking. No permissions to grant. The tradie uses their own calendar — Tradies Bio® just writes the invitation for them and puts it one tap away.

---

How It Works — The Customer's Side

This is the part that is genuinely different. This is Gold.

Once the event is in the tradie's calendar, the tradie can add the customer as a guest — one field in Google/Outlook/Apple Calendar. The customer receives a calendar invitation by email. They tap Accept — and the appointment lands in their calendar too.

Think about what that means from the customer's perspective. They had a good tradie come and do excellent work. And then, unprompted, a professional calendar invite arrived — not a vague "I'll be in touch" — but an actual date, an actual time, a reminder that will appear on their phone one day before and one hour before.

No other tradie does this. This is the behaviour of a well-run business. This is how tradies build repeat relationships that last decades.

The customer sees:
- The tradie's business name in the calendar event title
- The date and time agreed for the next visit
- A note about what the visit is for
- A reminder on their phone — automatically

They do not need a Tradies Bio® account. They do not need to install anything. They just accept the invite and it is in their diary.

---

Voice Command — Hands Free, On the Job

Platform	Phrase	What happens
iPhone (Siri)	"Hey Siri, Tradie Follow"	Follow-up Scheduler opens instantly
Android (Google)	"Hey Google, Tradie Follow"	Follow-up Scheduler opens instantly

This is Shortcut #5 in the Tradies Speaks voice command suite. It sits after Tradie Money — the last step after the job is done and the payment is sorted.

The complete voice suite — in order:
1. Start Your Engines — Opens the dashboard
2. Tradie SWMS — Safety paperwork, on site
3. Tradie Quote — Quote built and sent before leaving the driveway
4. Tradie Money — Overdue invoice chased professionally
5. Tradie Follow-up — Return visit locked into both calendars

---

Part of the Free Offering

The Tradie Follow-up Scheduler is included free in every Tradies Bio® account. There is no paid tier for follow-ups, no credits, no limit on the number of follow-ups a tradie can schedule.

This is Tradies Bio® honouring its founding commitment: free for licenced tradies with an active ABN.

---

Coming Next — AI Telephone Answering

The Tradie Follow-up Scheduler is part of a larger picture. Tradies Bio® is building an AI telephone answering service — a system that answers calls when a tradie is on the tools, captures the enquiry, and alerts the tradie immediately.

The follow-up feature is the closing loop: the AI answers the call, the tradie does the job, and then the Tradie Follow-up Scheduler brings the customer back for the next job. From first contact to repeat business — handled entirely within Tradies Bio®.

This is the platform story that Facilitators will present to tradies. It is not a collection of tools. It is a complete business system. And building your business is our business.

---

[3.8.2] — 2026-07-20 — Tradie Follow-up — Global AI Speaking Integration

Changed — AI Speaking Page (/aispeaking)

• "Tradie Follow" shortcut card added as #5 (dark green, 📅 icon)
• Phrase: "Hey Siri — Tradie Follow" · Title: "Schedules the Return Visit"
• Description: "Job done? One voice command opens the Follow-up Scheduler. Set the date, pick the customer, and tap the Google Calendar button — it lands straight in your calendar and theirs. Step 5 after every job."
• URL chip: tradiesbio.au/dashboard/follow
• Story block updated: now lists all 5 commands — "Start Your Engines. Tradie SWMS. Tradie Quote. Tradie Money. Tradie Follow."
• Step 5 shortcut-naming tip updated to include Tradie Follow in the exact-phrase list

Changed — Landing Page (/)

• "Tradie Follow" tile added to Tradies Speaks shortcut grid (dark green 📅, ✅ Live)
• "Hey Siri, Tradie Follow" command card added: "Return visit scheduled — straight into Google Calendar"

Changed — Edit Profile Page (/dashboard/edit-profile)

• "Hey Siri, Tradie Follow" shortcut card added (card #4 in the grid, ✅ LIVE)
• "Set Up Shortcut →" button links to /aispeaking setup guide

---

[3.8.1] — 2026-07-20 — Big 5 — Unified After-Job Card + Voice Commands

Changed — Dashboard & Public Page

• "Finished a Job?" card now shows all 5 steps in a single unified card (was: Big Four card + separate Step 5 card below)
• Step 5 "📅 Schedule Follow-up" is a dark button directly inside the card — no separate card needed
• Sub-label updated: "Send the Big 5 link to your customer"
• "Preview your Big 5 ↗" link (replaces "Preview your Big Four page")
• "View follow-ups →" link (right-aligned, subtle, same row as preview link)
• Public page /u/<slug>/big-four: badge updated from "The Big Four" → "The Big 5"
• Public page #5 button added: "📅 Book a Return Visit" → links to tradie's public bio (enquiry form)
• Page title and meta description updated to Big 5
• Setup nudge updated: "enable all four" → "enable all five"

Changed — Voice Commands

• "Hey Siri, Tradie Follow" added to dashboard voice shortcut strip (after Tradie Money)
• "Hey Google, Tradie Follow" added to dashboard voice shortcut strip (after Tradie Money)
• Voice command deep-link: https://tradiesbio.au/dashboard/follow
• Voice action: "Schedule a return visit or follow-up call"

---

[3.8.0] — 2026-07-20 — Tradie Follow-up — Step 5 After the Job

New Feature — Tradie Follow-up

The fifth post-job action is now live on every tradie's dashboard.

What it does:
- Tradie taps + Schedule Follow-up on the dashboard
- Picks an existing enquiry/customer from their own database (pre-fills name, email, phone) or types a new one
- Sets a date, optional time, follow-up type (Service / Call / Quote / Inspection / Other), and a short summary
- Taps Schedule Follow-up — done
- Immediately downloads a .ics calendar file — one tap adds it to Google Calendar, Apple Calendar, or Outlook with no sign-in required
- Optionally sends the customer a branded calendar invite email (with .ics attachment and the Tradies Bio® orange email header)

Dashboard integration:
- New card: 📅 Step 5 — After the Job — Tradie Follow-up below the Big Four card
- Follow-up list at /dashboard/followup/ — upcoming and completed views
- Overdue follow-ups shown with red border warning
- Mark as Done / Delete actions
- Direct-dial link on customer phone numbers

Database:
- New followups table (Alembic migration 68422679b767)
- Links to existing enquiry records via enquiry_id foreign key
- Stores: customer details, date, time, type, summary, invite sent status, completion

Calendar standard:
- RFC 5545 compliant .ics file — VCALENDAR/VEVENT with 1-hour VALARM reminder
- AEST timezone (UTC+10) — Australian-first
- Works across Google Calendar, Apple Calendar, Outlook — no API sign-in required
- Future-proof: same .ics format works with any calendar system

Siri / Apple Shortcut ready:
- /dashboard/follow is a clean URL — can be deep-linked from a Siri shortcut ("Hey Siri, Tradie Follow")
- Same pattern as existing Quote, SWMS, and Money shortcuts

---

[3.7.5] — 2026-07-18 — Critical Discovery: Dialogflow CX Never Wired to Twilio Numbers

Discovery

The Star was never on stage.

A major architectural gap was uncovered during Twilio support investigation (engineer: Amogh Bagade, ticket #28257389).

The Tradies Bio® AI Speaking system has two components:
- Dialogflow CX (Google Cloud) — the AI agent; greets callers, collects name, job, suburb in natural conversation. This is the product.
- Replit voice webhook (/webhooks/voice) — a fallback voicemail; rings the tradie's mobile, records a message if unanswered. This is the backup.

Both Twilio numbers (+61 257 610 509 and +61 745 178 010) had been pointing to the Replit backup webhook as their PRIMARY handler since provisioning. Dialogflow CX was fully built but had never received a single live call. Every caller heard the voicemail backup — not the AI conversation.

How it was discovered

Amogh updated the 07 number's webhook to https://tradiesbio.au/webhooks/voice and noted it was not previously configured correctly. This revealed that neither number was routing calls to Dialogflow CX.

What is already built and ready

• ✅ Dialogflow CX agent — built, SSML greeting configured, full conversation flow
• ✅ Replit fulfillment webhook (/webhooks/dialogflow) — receives enquiry data from Dialogflow CX, saves to database, sends SMS magic link
• ✅ Replit voice backup (/webhooks/voice) — SSML voicemail, call logging, fallback
• ✅ Call log system — records every call regardless of handler
• ❌ Missing: Twilio numbers not pointed at Dialogflow CX as primary handler

Three actions required to activate (Stephen Pearce — Twilio + Dialogflow CX consoles)

Action 1 — Twilio console: Toggle +61 745 178 010 from US1 → AU1 (sub-account AC4bce7...)
Action 2 — Dialogflow CX console: Integrations → Telephony → Twilio → copy the generated webhook URL
Action 3 — Twilio console: Both numbers → "A call comes in" → paste Dialogflow CX URL → save

When complete

Every incoming call on 02 and 07 will be answered by the Dialogflow CX AI. The Replit voicemail activates only if Google Cloud is unreachable. This is the intended architecture and the foundation of the monetisation product.

---

[3.7.4] — 2026-07-18 — SSML Voice — Natural Pauses and Emphasis on All AI Greetings

Changed

Voicemail greeting — SSML applied to Polly.Nicole (Amazon Polly via Twilio)
- All three <Say> responses in the voice webhook now use SSML markup instead of plain text
- Adds natural breath-pause timing (<break> tags: 150ms–400ms) between sentences and phrases
- Adds spoken emphasis (<emphasis level="moderate">) on key phrases: "out on the tools", "text you a link straight away", "very soon"
- Result: the AI voice sounds like a person taking natural pauses — not a machine reading a sentence
- SSML supported natively by Amazon Polly (Polly.Nicole voice) via Twilio TwiML <Say> verb

Messages improved:
- Voicemail greeting (tradie didn't answer) — full SSML rhythm applied
- Post-recording thank-you — pauses and emphasis added
- Error fallback — opening "G'day!" pause added

Note: The Dialogflow CX interactive greeting ("G'day! Thanks for calling…" AI conversation) is configured inside Google Cloud Console — not Replit code. See instructions below for applying the same SSML there.

---

[3.7.3] — 2026-07-18 — Call Logs — Every AI Speaking Call Now Recorded

Added

Call log system — call_logs database table + admin view (/admin/call-logs)
- Every inbound call to a Tradies Bio® AI Speaking number is now recorded the moment it arrives — answered, missed, and voicemail calls all captured
- Previously missing: answered calls were completely invisible; only voicemails that triggered a recording created any record
- New CallLog model: call_sid, tradie_id, to_number, from_number, started_at, status (answered/missed/voicemail/unknown), answered_duration_s, voicemail_left, enquiry_id
- Voice webhook updated with three-stage call tracking:
- /webhooks/voice — logs every inbound call immediately (status=unknown)
- /webhooks/voice/voicemail — updates to answered (with duration) or missed
- /webhooks/voice/recording-done — updates to voicemail, links the created Enquiry
- New admin page /admin/call-logs:
- Summary stats: Total / Answered / Missed / Voicemails / Unknown
- Full call table: date/time, tradie, number called, caller number, status badge, duration, enquiry link
- Filter by tradie or status
- Per-tradie activity breakdown table — total, answered, missed, voicemails, last call date
- Foundation for tradie-facing call activity reports

Root cause — why the two test calls showed no activity

The voice webhook previously only created a database record when a voicemail recording was completed. If the call was answered, nothing was written — the call was invisible. From this version forward, every call is logged immediately on arrival.

---

[3.7.2] — 2026-07-18 — Twilio AU1 Provisioner Fix (Amogh Bagade Confirmation)

Fixed

twilio_provisioner.py — AU1 routing corrected to Twilio-confirmed endpoint
- Wrong endpoint replaced: was routes.sydney.au1.twilio.com/v2/PhoneNumbers/{E164} — this is the external routing API, not the number configuration API
- Correct endpoint: api.twilio.com/2010-04-01/Accounts/{SID}/IncomingPhoneNumbers/{PhoneNumberSid}/VoiceRegion.json with VoiceRegion=au1 — confirmed by Amogh Bagade (Twilio Voice Support, Jul 2026)
- Argument fixed: set_au1_region() now accepts the PhoneNumberSid (PN...) not the E164 phone number — the SID is what the VoiceRegion endpoint requires in the URL path
- Missing step added: after AU1 switch, configure_webhooks() is called again — Amogh explicitly warned that AU1 does NOT inherit configuration from US1; webhooks must be re-applied in the AU1 context
- New apply_au1_and_webhooks(phone_sid) — standalone utility for manually completing AU1 migration on an existing number (Ken Hall: PN68f3462376b67d2e7f2b56e28055a9aa)
- Search improvement: search_au_numbers() now adds in_locality="Sydney" + voice_enabled=True filters, with automatic fallback to area-code-only if Sydney returns nothing

Changed

• purchase_number() now passes account.sid (PhoneNumberSid) to set_au1_region() — previously passed E164 number which would have caused a 404 on the VoiceRegion endpoint

---

[3.7.1] — 2026-07-17 — Pitch Deck: Business Advisor Instrument Panel Slide

Added

New slide — "The Business Advisor Instrument Panel" (AdvisorDashboardNav.tsx)
- Live dashboard screenshot (mobile nav) showing the Business Advisor section in every Tradies Bio® tradie app
- Three menu items explained for accountants: My Business Advisor / Build Sell Tax-Free / Business Risk Register
- Closing statement: "You are not being added later. You are already there."
- Positioned at slide 0.68 — between the RHD Gold Rush slide (0.625) and The New Position (0.75)
- Built for WSC meeting (Catherine & Lindsey, 29 July) and Better Business Accounting — Julie Norris (6 August)

---

[3.7.0] — 2026-07-17 — Pitch Deck: AI Gold Rush Moment — Right-Hand Drive Slide

Added

New slide — "AI Gold Rush Moment — Right-Hand Drive" (RightHandDrive.tsx)
- Cinematic car-interior POV from the driver's seat — Australian right-hand drive
- "COMPLIANCE" badge sits over the rearview mirror — looking back
- "AI Gold Rush Moment" in gold overlaid on the windscreen road view — looking ahead
- Bottom message: "Stop running your practice on compliance. Start driving your clients' businesses."
- "Entrepreneurial Compliance Seizure" definition card — pivot from compliance-only to management accounting
- Subtle 🇦🇺 "Right-hand drive — because we're Australian" note
- Positioned at slide 0.625 — between The Frontier (0.5) and The New Position (0.75) in the accountant deck sequence
- Built for WSC meeting (Catherine & Lindsey, 29 July 11am) and Better Business Accounting — Julie Norris, Woonona (6 August 10:45am Menai)

---

[3.6.9] — 2026-07-16 — Ken Hall Phone Number Provisioned + Provisioner Address Fix

Added

Ken Hall (Facilitator #1) — phone number provisioned
- Twilio number +61 7 4517 8010 purchased and assigned to Ken Hall (user ID 8, knhall6@gmail.com)
- Registered mobile 0420 337 166 will ring 10s before AI greeting engages
- Number linked in DB: users.twilio_number = '+61745178010' for user ID 8
- AU1 Sydney routing pending — Amogh Bagade (Twilio VIP) to set manually (sub-account auth restriction on routes.sydney.au1.twilio.com)
- Number routes via US1 in the interim — call flow is fully functional, no user-facing difference

provisioner: automatic address SID lookup (error 21631 fix)
- AU geographic numbers require a registered address SID at purchase time (Twilio error 21631)
- New _get_address_sid() function looks up the first registered address on the account dynamically
- Address on file: 7 Tinakill Ave, Engadine NSW AU — SID AD8d381c5169e0ced50be8a6ac816d1b92
- Future number purchases for all facilitators will resolve the address automatically — no manual step

Facilitator Phone Onboarding Checklist — docs/facilitator-phone-onboarding-checklist.md
- Step-by-step documented procedure for provisioning any new facilitator's AI Speaking number
- Covers: number selection, purchase, webhook config, AU1 routing, DB assignment, test call, Quick Reply
- Note on 02 Sydney numbers: Twilio inventory currently zero — Amogh engaged; 07/08 used as interim
- Note on AU1 routing: sub-account credentials return 401 on routes.sydney.au1.twilio.com — manual step via Twilio VIP

Notes

• Steve Wells (facilitator, QLD) may inherit +61 7 4517 8010 when he joins — number is already QLD area code
• 02 Sydney number: email sent to Amogh Bagade requesting stock or direct provision

---

[3.6.8] — 2026-07-16 — Quick Reply SMS Button + Ken Hall Onboarding Ready

Added

⚡ Quick Reply SMS button on every enquiry card
- Red standout button (btn-quick-reply) sits in the action row of every phone/WhatsApp enquiry with a known caller number
- Tapping opens the tradie's native iPhone/Android Messages app with a pre-written template pre-filled
- Template: "Hi, I've got your message — I'm on the tools right now but your job is important to me. I'll call you back ASAP. In the meantime feel free to reply with your email address so I can update my records. — [Business Name]"
- Tradie can edit before sending — goes from their own Telstra/Optus mobile, no Twilio, no compliance, zero cost
- Uses standard sms: URI with &body= parameter — works on all iOS and Android devices
- CSS class .btn-quick-reply added to style.css (red #dc2626, white text, bold)

Ken Hall onboarding — account ready, procedure documented
- Ken Hall confirmed as user ID 8 (knhall6@gmail.com) — no twilio_number assigned yet
- Awaiting 02 (NSW) Twilio number stock — API confirmed zero 02 numbers in Twilio inventory (16 Jul 2026)
- Amogh Bagade (Twilio VIP engineer) asked to source a 02 number
- Once available: webhook auto-configured + AU1 routing (65s) + UPDATE users SET twilio_number WHERE id=8
- Full test plan: Stephen calls Ken's number → AI greeting → enquiry in Ken's dashboard → Ken taps Quick Reply

Changed

Voice greeting — hang up instruction
- Updated from "Press hash when you're done" to "Just hang up when you're done, or press the hash key"
- Resolves confusion for callers unfamiliar with "hash" = # (confirmed by Ken Hall test call)

---

[3.6.7] — 2026-07-16 — Never Miss a Call: AU1 Auto-Routing + SMS Messaging Service

Added

Automatic AU1 region routing after number purchase
- twilio_provisioner.purchase_number() now automatically routes new AU geographic numbers to AU1 (Sydney) after purchase
- Waits 65 seconds post-purchase (Twilio requires propagation delay before the Inbound Processing Region API will accept the call — confirmed by Twilio Voice Support engineer Amogh Bagade, Jul 2026)
- Retries up to 4 times with 20-second gaps; non-fatal if all fail — logs a warning to prompt manual Twilio console action
- New set_au1_region() function: POSTs to https://routes.sydney.au1.twilio.com/v2/PhoneNumbers/{E164} with VoiceRegion=au1
- Terminating carrier for +61 2 5761 0509 confirmed as Symbio by Twilio VIP engineer

Twilio Messaging Service for SMS text-back
- TWILIO_MESSAGING_SERVICE_SID env var added — Messaging Service SID MG677a29d3bb0a703ac1a12be806537a67
- twilio_client.send_sms() now uses messaging_service_sid= parameter when env var is set, falling back to from_number
- Resolves "From number is not SMS-capable" error — AU 02 geographic numbers are voice-only; a Messaging Service routes SMS via Twilio's pool

Changed

Phone Configuration Guide updated
- Step 4 flow description now states AU1 routing is automatic (~2 min total setup time)
- Checklist item p3_1b updated: AU1 is attempted automatically; manual Twilio console step retained as verification + fallback with exact API command from Twilio support

---

[3.6.6] — 2026-07-12 — Phone Configuration: Global Rename + Pre-Activation Checklist

Fixed

Admin sidebar — "Phone Numbers" dead link resolved
- Confirmed admin/phone_numbers.html template (223 lines) exists and route is healthy
- Verified SQLAlchemy 2.0.49 query with .nullslast() executes correctly (0 records returned cleanly)
- App restart confirmed all routes live — no 500 errors on /admin/phone-numbers

Changed

Global rename — "wizard" → "Phone Configuration"
- Sidebar: "Wizard Guide" → "Phone Configuration Guide"; "Set Up Phone" → "Phone Configuration"
- dashboard.html: "✅ Wizard Live" → "✅ Config Active"; "Phone Wizard" → "Phone Configuration"; "Admin wizard (5-min setup)" → "Admin setup (5-min)"; "📘 Full Guide & Wizard Flow →" → "📘 Phone Configuration Guide →"
- tradie_list.html: "launch wizard to activate" → "launch Phone Configuration"; "📱 Set Up Phone →" → "📱 Phone Configuration →"
- phone_onboarding_guide.html: page title updated to "Phone Configuration Guide"

Added

Phone Configuration Guide — Pre-Activation Flight Checklist
- 16-step interactive checklist organised into 5 phases: Money First · Pre-Configuration · Configuration & Testing · Handover & Go Live · Facilitator Management
- Tick-off checkboxes with localStorage persistence — state survives page refresh within the same session
- Progress bar shows "X / 16" steps complete with orange fill
- "🔄 Reset for next tradie" button clears all ticks (with confirmation) — ready for the next setup
- Phase colour coding: green (money) · blue (pre-config) · purple (tech) · orange (go live) · grey (facilitator)
- Sits between the product positioning and the sale flow — visible before pressing any button
- For Stephen · Ken · Daniel only (super admin — guide is admin-only)

---

[3.6.5] — 2026-07-12 — Tradie List: Email Collapsible + VIP Phone Card

Changed

Admin tradie list — email section
- Renamed section heading to "Tradies Welcome Brief of Emails"
- All welcome email buttons now collapse into a <details> pulldown to save real estate
- Summary bar shows sent count and a down arrow — closed by default

Admin tradie list — Never Miss a Call (VIP monetisation card)
- Phone wizard action pulled out of the admin controls row into its own dedicated dark card
- Card appears above the admin controls row, visible to super admins only
- Four states: dark/orange (not set up), amber (provisioning/testing), green (active + live number), red (failed)
- Active state shows the live Twilio number inline; all states show a clear CTA button
- Old inline phone buttons removed from the admin controls row

---

[3.6.4] — 2026-07-12 — Never Miss a Call: One Section + AI Co-Pilot Sales Column

Changed

Admin Dashboard — phone sections consolidated into one
- Deleted separate "Never Miss a Call — Architecture Brief" section (had outdated "To Be Built" content)
- Merged all content into the founding-team-only dark card (Stephen, Ken, Daniel)
- Four collapsible <details> panels save real estate: ⚠️ Cost Trigger · 💰 Pricing · 🤝 Facilitator Talking Points · 🛠️ What's live
- Header, product brief, and "How it's sold" remain always-visible
- Updated "To Be Built" → "Roadmap" (only 3 items remain; everything else is built)

Facilitator Scorecard table — column 3 replaced
- Deleted "→ 100 TARGET" column (progress bar + X/100 counter)
- Replaced with "📱 Co-Pilot Sales" — count of active phone onboardings per Facilitator
- Shows orange badge (📱 N) when > 0; dash when none
- Footer text updated: "100 each · 1,000 total target" → "1,000 tradie milestone"
- Admin dashboard route now passes phone_sales_map dict to template

Bug fix — Facilitator Scorecard (The 10 Facilitators page)
- status="live" → status="active" in the phone_map query (was returning zero results)

---

[3.6.3] — 2026-07-12 — Never Miss a Call: Consolidated Brief

Changed

Admin Dashboard — "Never Miss a Call" founding-team card (previously "Co-Pilot Phone Pipeline")
- Removed outdated "In Development" badge, Phase A/B/C roadmap, and stale September timeline
- Replaced with a clean, current brief: what it is, how it's sold (Facilitator → wizard → live), pricing stance
- Status badge now reads "✅ Wizard Live"
- Three quick links: Full Guide, Phone Numbers, Facilitator Scorecard
- Restricted to Stephen, Ken Hall, Daniel Pearce (founding team) — unchanged

Phone Wizard Guide — product positioning preamble added
- New "What This Is — The Monetisation Element" section at the top of /admin/phone-onboarding-guide
- States clearly: Tradies Bio® is free; Never Miss a Call is the first paid add-on; one saved job covers the cost
- Competitor comparison: $107–$500/month vs ~A$1.50/month Twilio fee
- Page is now the single source of truth — brief + operational SOP in one place

Tradie Dashboard — interest card badges updated
- Removed "September 2026" date badge (product is available now via Facilitator, not waiting for a future date)
- "📌 New" → "📱 Available Now"
- "Tradies' Favourite" → "Ask Your Facilitator" (reflects the correct sales path)

---

[3.6.2] — 2026-07-12 — Phone Wizard Guide + Facilitator Scorecard + Admin Sidebar hub

Added

Phone Wizard Guide — /admin/phone-onboarding-guide
- New super-admin page explaining the complete 6-step UX flow from "Facilitator makes a sale" to "phone number is live"
- Plain-language step-by-step: confirm sale → Global Customers → Preview → Approve & Begin Setup → Test call → Go Live
- Quick links grid to all four key pages: Set Up Phone (Tradie List), Phone Numbers, Facilitator Scorecard, Concierge
- Authorisation reminder showing the three authorised names and their email addresses
- Facilitator responsibility section: each Facilitator owns their stable; notifies Stephen/Ken/Daniel immediately after a sale
- Accessible from the new "📱 Never Miss a Call" sidebar section (super-admin only) and the Admin Dashboard

Facilitator Scorecard — Never Miss a Call column
- The 10 Facilitators Matrix (/admin/the-10-associates) now shows a "📱 live" counter per Facilitator — how many tradies in their stable have an active phone number provisioned
- Header summary stat added: total active phone numbers across all Facilitators (orange, real-time)
- Data powered by a new phone_map dict in the route: associate_id → live phone count from the phone_onboarding table

Admin Sidebar — "📱 Never Miss a Call" hub
- New super-admin sub-section in the Administration sidebar (collapsible label in orange) with 4 direct links:
- Phone Numbers — all provisioned numbers + billing
- Facilitator Scorecard — sales per Facilitator + phones live
- Wizard Guide — the step-by-step UX flow
- Set Up Phone — shortcut to Tradie List (where the orange 📱 button lives per tradie)

---

[3.6.1] — 2026-07-12 — Never Miss a Call value case + Go Live authorisation lock

Added

Preview page — "Never Miss a Call — Why this pays for itself" collapsible section
- New <details> value proposition block opens by default on the phone onboarding preview page — makes the ROI case before Stephen approves provisioning
- Hero stat: $1,000s estimated lost per month from unanswered calls (industry average)
- Plain-language argument: a tradie on the tools is earning; answering the phone is not — at $85–$120/hr every interruption costs real money
- 6-point checklist covering: 1 hr/day admin saving, AI answers every call, voicemail + magic link SMS capture, single dashboard for all enquiries, cost < 20 min of tradie time, automated follow-up within the hour
- Cost vs Value table: Twilio number ~A$1.50/month vs lost billable time vs estimated thousands in unanswered-call revenue lost per month
- Authority notice prominently shown: "Only Stephen Pearce, Ken Hall or Daniel Pearce can authorise provisioning and Go Live"

Changed

• Go Live authorisation tightened: start, mark-tested, confirm-payment, and retry routes now require the signed-in admin's email to be in the authorised set (stephenp@tradiesbio.au, knhall6@gmail.com, daniel.pearce@teck.com) — any other super-admin is blocked with a clear message; read-only routes (preview, tracker) remain accessible to all super-admins
• Step 6 label updated: "WhatsApp number set — button goes live on public Bio & PWA instantly" (was "flagged for setup pending Meta approval")
• Steps 7 & 8 attribution updated: "Confirmed by Stephen, Ken or Daniel" (was "Confirmed by Stephen" alone)

Fixed

• Killed zombie gunicorn process holding port 3000 after Task #55 merge — workflow restarted clean

---

[3.6.0] — 2026-07-12 — Phase 26: Phone Onboarding Wizard

Added

Admin Phone Onboarding Wizard — Never Miss a Call
- New super-admin wizard (/admin/phone-onboarding/<id>) automates provisioning of the Phone + SMS + WhatsApp trio for any tradie
- Preview screen (/preview): shows the full 8-step plan with no side effects — Stephen can read every action before anything happens in Twilio
- Available AU 02 numbers fetched live from Twilio and displayed for selection; cost estimate shown (~A$1.50/month per number)
- Approve & Begin Setup: purchases the chosen number, configures voice + SMS webhooks, flags WhatsApp for Meta Business verification, and writes the tradie's twilio_number — all in one atomic step
- Step Tracker (/admin/phone-onboarding/<id>): timestamped progress board showing all 8 steps; automated steps (1–6) marked instantly; manual steps (7–8) await Stephen's confirmation
- Mark Tested (step 7): Stephen confirms a test call was made and passed
- Confirm Payment → Go Live (step 8): Stephen enters an optional payment reference, fires Go Live — tradie receives a branded welcome email + SMS, admin team receives an alert
- Provisioning writes both users.twilio_number (voice + SMS routing) and users.whatsapp_number (WhatsApp routing) to the same Twilio number in one atomic step — the WhatsApp button appears on the tradie's public Bio and PWA immediately after provisioning, no manual entry required
- New phone_onboarding DB table (migration f6c9207e4228) tracks every field: number, SID, cost, payment ref, timestamps, created-by, error details
- Tradie List integration: each tradie card now shows a context-aware "📱 Set Up Phone" button (orange = not started, amber = in progress, green = live, red = failed) — super-admin only
- Retry support for failed provisioning attempts
- Go Live email carries full Tradies Bio® branding: T-mark, wordmark, orange footer, tagline; describes all three channels and links to Enquiries dashboard
- All routes @super_admin_required — no admin-level access

---

[3.5.0] — 2026-07-10 — Phase 25: SMS Text-Back & WhatsApp Channel

Added

Automatic SMS text-back after every call (AI Speaking)
- After every call handled by the AI Speaking phone inquiry system, the caller immediately receives an
SMS with a secure magic link — a personalised page where they can add photos of the job, confirm
their email, and leave any extra notes
- The magic link page works on any mobile browser — no app, no login, no friction
- If the caller dialled from a landline and gave a different callback mobile during the call, the text
goes to that alternate number instead of caller ID
- After voicemails too — callers who leave a voicemail also get the text-back link automatically
- Magic links are one-time — once the customer submits, the link is marked as used so it can't be
tampered with
- Tradies can manually re-send the link from any Phone Call enquiry card with the new 📲 Re-send
Link button, if the original text didn't arrive

Enquiry follow-up page (/enquiry/magic/<token>)
- Clean mobile-first page showing a summary of what the AI captured (job description, location, urgency)
- Customer can confirm or update their email, add notes, and upload up to 5 photos or videos (JPG,
PNG, HEIC, MP4, MOV — 10 MB per file)
- Drag-and-drop upload with instant photo preview thumbnails
- On submit: enquiry card on the dashboard updates in-place — no duplicate records

WhatsApp as a second enquiry channel
- New WhatsApp inbound webhook at /webhooks/whatsapp — handles every inbound WhatsApp message
- Twilio signature validation on every request (machine-to-machine security)
- Inbound message matched to the correct tradie by their WhatsApp-enabled number (set by admin)
- Any media attachments (photos, videos) the customer sends via WhatsApp are stored and shown on the
enquiry card in the dashboard
- Auto-reply sent immediately with the magic link so the customer knows their message was received
- During the approval period (awaiting Meta Business verification), the Twilio shared sandbox routes
test messages to Stephen's account for end-to-end testing
- WhatsApp button appears on the tradie's public bio page (green, styled distinctly) once a WhatsApp
number is provisioned — only shows if the number is set

WhatsApp filter on Enquiries dashboard
- New 💬 WhatsApp source filter alongside existing Web Form and Phone Calls filters
- WhatsApp enquiries get a green 💬 WhatsApp badge (distinct from the blue Phone Call badge)
- Magic link status shown inline: "📤 Link sent — awaiting customer response" / "✅ Customer completed
the follow-up link"
- Customer notes submitted via the magic link page appear on the enquiry card in a green callout box

Changed

AI Speaking greeting — warmer, faster, no email ask
- Updated voicemail greeting: more conversational, on-the-tools tone; explicitly tells the caller a
text link is coming; no longer asks for email (collected via magic link instead)
- Dialogflow CX fulfillment: email is now optional — the AI no longer requires it; any email the
customer provides via the magic link page is attached to the same enquiry automatically

Enquiry creation from phone calls
- No email required — enquiry is created from name + job + caller ID only
- callback_mobile field: if the caller confirms a different mobile to text back to, that number
takes priority for SMS delivery over the caller ID

Technical

• New database columns on enquiries: magic_link_token (unique index), magic_link_sent_at,
  magic_link_used_at, callback_mobile, media_json, customer_notes
• New column on users: whatsapp_number
• Alembic migration ab25cd36ef47 — idempotent (inspector-guarded), merges both existing branch heads
• New routes registered: /enquiry/magic/<token> (GET + POST), /enquiry/media/<enq_id>/<path>,
  /webhooks/whatsapp, /dashboard/enquiries/<enq_id>/resend-magic-link
• Magic link and WhatsApp webhook endpoints are CSRF-exempt (token-authenticated / Twilio-signature-
  authenticated respectively)
• New Dialogflow CX call script guide: docs/dialogflow-cx-call-script-guide.md — step-by-step
  instructions for Stephen to update the Dialogflow flow, full recommended call script included

---

[3.4.11] — 2026-07-10 — URL Library — One-Click Back Button

Added

"← Back to URL Library" button on every page you open from the Library
- Every clickable URL in the Library now carries a hidden marker so the page it opens shows a small
orange ← Back to URL Library button top-left, right above the page content
- One tap/click returns straight to the URL Library — no more hunting through the sidebar or
switching browser tabs to find your way back
- Works everywhere in the platform automatically (built into the shared page layout) — no per-page
setup needed for new pages added to the Library in future
- Only ever shown to Super Admins, and only on pages reached via a Library link — normal navigation
and every other visitor sees no change

Fixed

Opening a Library link no longer requires a second tab
- Library links now open in the same tab/screen instead of a new tab, which was the real cause of the
"four clicks to get back" problem on the mobile app (new tabs don't behave the same way inside the
app's webview) — the new back button makes returning instant either way

---

[3.4.10] — 2026-07-10 — URL Library — Clickable URLs & Mobile Fix

Fixed

Mobile view was clipping the "Open" column
- On phones, the URL Library table was hiding the "Open" and "Facilitator" columns off the edge of the
screen, making URLs look un-clickable — the columns weren't gone, they just weren't visible
- Every URL in the main list is now a clickable link directly (no need to find a separate "Open"
button)
- On phone-sized screens, each row now stacks into its own card instead of a cramped table, so every
column (Section, Open, Facilitator) is visible and usable — nothing is clipped off-screen anymore

Added

• Simple orange border added around the URL Library table (and around each row card on mobile) to make
  each entry easier to scan

---

[3.4.9] — 2026-07-10 — "View Global URL" Added to Sidebar

Added

• New View Global URL link in the sidebar, sitting directly above View Public Website, giving
  Super Admins a second quick way into the master URL Library (/admin/url-library) without needing to
  scroll up to the Administration section
• Super Admin only — matches the existing URL Library visibility rule

---

[3.4.8] — 2026-07-10 — URL Library — The Business Model

Added

Every URL In The Platform, In One Place — Super Admin Only
- New URL Library page (/admin/url-library), styled to match the blue "Platform History" hero,
headed "Tradies Bio® — The Business Model" with the tagline "Building Your Business Is Our
Business"
- Automatically catalogues every visitable URL the app has ever registered — public, dashboard,
admin, and system routes — in strict alphabetical order, with a live search box, section badges,
and one-click "Open" links for every URL that doesn't need a value plugged in (dynamic routes like
/u/<slug> are shown as text, tagged Dynamic, since they need a real profile to resolve)
- Added to the sidebar (Administration) and the Admin dashboard's Quick Links, visible to Super
Admins only

Facilitator Access Flags — Foundation Laid
- Every row now has a Facilitator checkbox — tick any URL to mark it reviewed and approved for
the Facilitator Network; flags are saved instantly and persist across restarts
- This is step one of a two-step rollout: flagging is live today, but the Facilitator sidebar itself
doesn't consume these flags yet — that switch flips once Stephen has finished reviewing the full
inventory and given the go-ahead

Fixed

The Full Count — 284 URLs, Not 149
- The original library only listed the 149 URLs you can actually visit (pages). It left out the
135 behind-the-scenes URLs that also exist but aren't meant to be clicked — form submissions,
save/delete actions, webhooks (Stripe, Dialogflow, Twilio), and the static file server that quietly
serves every uploaded document, image, and branding asset
- Added a collapsible "Action & System Endpoints" section beneath the main library showing all
135 of these, with the HTTP method and a plain-English note on what each one does
- Hero banner now shows the true scale — 284 URLs ever built (149 pages + 135 action/system) —
so the full size of the platform is visible at a glance
- No bug in the original count — this was a deliberate scope decision (only clickable pages belong in
a Facilitator-flaggable directory) — the addition simply makes the complete inventory visible too

---

[3.4.7] — 2026-07-09 — "See a Completed Tradies Bio" Added to Sidebar

Added

Showcase Profile Link — Always One Tap Away
- The "👀 See a Completed Tradies Bio" link (the finished example profile shown on the one-time
welcome screen) is now also in the Dashboard sidebar under Business Tools, next to "My
Public Bio" — opens in a new tab
- Previously this link only ever appeared once, on the first-look welcome modal, so there was no
way to find it again afterwards — useful when showing a Facilitator or new tradie what a
finished profile looks like
- Shows for every logged-in user, automatically follows whichever profile is set as the showcase
in Admin → Settings → Showcase Profile — no code change needed if that profile is swapped later

---

[3.4.6] — 2026-07-09 — Global Back-to-Dashboard Navigation on Public Bio

Fixed

No Reliable Way Back From Your Own Bio
- Viewing your own live Bio (via the "Preview" link, a bookmark, or a direct visit) left no
obvious way back to the Dashboard — the browser's back button doesn't help if the page opened
in a new tab, and there's no in-page back link, so tradies were falling back on a social icon
that was never meant to be a way out
- Every tradie's Bio page now shows a persistent dark bar at the very top with a clearly labelled
"← Back to Dashboard" link whenever they're viewing their own live Bio — never shown to real
customers, only to the signed-in owner
- The existing "This is what customers see — Share it" prompt (shown from the onboarding preview
link) now lives inside the same bar alongside the back link, instead of replacing it
- This is a shared, global template used by every tradie's Bio page, so the fix applies to all
Facilitators and their tradies automatically — no per-profile changes needed
- Brings the Bio page in line with the same "← Dashboard" back-bar pattern already used on the
Big Four referral page

---

[3.4.5] — 2026-07-09 — Video Instructions — Collapsible Help & Android Support

Changed

Your Business Video — Declutter & Android Support
- The "How to get your YouTube link" box on the Edit Profile → Your Business Video card is now a
collapsible "Video Instructions" panel — collapsed by default, tap to expand — so the card
stays tidy while the full steps are always one tap away
- Step 1 now covers recording on both iPhone (built-in Camera app, Video mode) and Android
(built-in Camera app, Video mode), holding the phone upright/vertical, alongside the existing
YouTube upload steps

Admin → Settings — Onboarding Video Instructions
- Added the same collapsible "Video Instructions" panel to the Onboarding Video card, covering
both iPhone (Control Centre → Screen Recording, Do Not Disturb first) and Android (Quick Settings
→ Screen Record) screen-recording steps, plus filming tips (steady hands, good light, keep it
short, trim the ends, turn on auto-captions) and the YouTube upload/link steps

Public Bio Page — Vertical Video Support
- The "Meet the team" video on a tradie's public Bio page now displays vertical/Shorts-style videos
correctly — shown true to shape on the dark Tradies Bio® background, matching the fix already
shipped for the onboarding video frame

First Look Welcome — "Start Your Engines" Label
- Added a small "🚀 Start Your Engines" label above the welcome video on a brand-new tradie's
First Look screen, matching the naming already used on the Admin → Settings side — the
"G'day, welcome to Tradies Bio®" heading underneath is unchanged

Fixed

Welcome Video Showing Blank — Legacy Saved Link
- The onboarding video URL saved before the automatic YouTube-Shorts-link conversion existed was
never re-converted, so it still showed a blank/black box on both the First Look welcome screen
and the Admin → Settings live preview
- The conversion now also runs every time the video is read back out for display (not just when
it's saved), so a link saved before this fix now displays correctly without needing to be
re-pasted and re-saved

First Look Welcome — Autoplay
- The "Start Your Engines" welcome video now autoplays (muted) the instant a new tradie reaches
their dashboard for the first time, instead of waiting for a tap — grabs attention in the one
moment they're actually looking at the screen
- "Watch the welcome intro again" (already available once the First Look has been seen) is
unchanged and continues to give tradies a way back to the same video any time later

---

[3.4.4] — 2026-07-09 — First Look Polish — Equal-Choice Buttons & Vertical Video Support

Changed

First Look Welcome — Two Real Choices
- "See a completed Tradies Bio ↗" and "Update My Profile →" are now shown as two equal-sized,
equal-weight buttons with a clear "OR" divider between them — so a new tradie sees this as a
genuine choice, not a primary button with a small footnote underneath
- "See a completed Tradies Bio" is now a solid blue button (first use of blue in the Tradies Bio®
palette, reserved for this one comparison), "Update My Profile" stays Safety Orange

Vertical / Shorts-Style Video Support
- The onboarding video frame (First Look welcome + Admin → Settings live preview) now displays
correctly for vertical "Shorts"-style videos — the video is shown true to its own shape, centred
on the Tradies Bio® dark gradient, instead of being squashed into a horizontal frame
- Admin → Settings now automatically converts a pasted YouTube "Shorts" link, a normal
"watch" link, a shortened youtu.be link, or a Loom "share" link into the correct embeddable
format — no more "non-standard URL" warning for these common link formats

---

[3.4.3] — 2026-07-09 — New Signup First Look — Live Showcase Bio

Added

First Look Welcome — Showcase a Working Bio®
- A brand-new tradie's very first screen after setting their password now shows a simple, full-screen
welcome — one short message, one clear button
- Added an optional "See a completed Tradies Bio ↗" link so a new tradie can see a real, finished
profile in action before diving into their own — set once by a Super Admin and shown to every new
signup from that moment on
- The single call-to-action button now reads "Update My Profile →" and drops the tradie straight
into their own edit-profile screen, ready to start entering their own details immediately
- Super Admins can change the showcase profile at any time from Admin → Settings — for example,
featuring a Facilitator's own Bio as recognition for their referral work

Watch the Welcome Intro Again
- Added a small, always-available "🎬 Watch the welcome intro again" link on the dashboard for any
tradie who skipped the First Look welcome too quickly and wants another look

---

[3.4.2] — 2026-07-01 — AI Speaking Auto-Reply Email System & Strategic Briefing v002

Added

Automated Email Auto-Responder — AI Speaking Phone Enquiries
- When a customer calls a tradie's Tradies Bio® AI Speaking number and provides their email address
during the AI voice conversation, a fully branded acknowledgement email is dispatched automatically
within seconds — managed and sent by the Tradies Bio® platform, zero manual effort required
- Email content: warm personal greeting, confirmation their enquiry was received, structured summary
(name, job, location, urgency, timestamp), "What Happens Next" steps, direct link to the tradie's
bio page, and a promise of a personal phone call follow-up from the team
- Full Tradies Bio® branding: T-mark, tagline "Building Your Business Is Our Business," orange accent
design, and the tradie's business name throughout — professional from first contact
- Live preview of the auto-reply available at tradiesbio.au/preview/phone-inquiry-auto2Customer

AI Speaking Strategic Briefing v002 — Administrators Report
- Comprehensive strategic report issued to Ken Hall and Daniel Pearce (CC Stephen Pearce)
- Major UI improvement: white/light background throughout — fully readable on mobile devices
- Added Table of Contents with 10 numbered sections and jump links
- Added Index at the bottom cross-referencing all key terms to sections and figures
- Three images embedded with captions:
- Fig. 1: Call flow diagram ("Never Miss a Lead — Tradies Bio® Co-Pilot")
- Fig. 2: Enquiries dashboard screenshot — where every enquiry lands
- Fig. 3: "Less admin. More home time." — the tradie outcome
- New section: "Never Miss a Call — Co-Pilot Premium" — formal naming of AI Speaking as the
first Tradies Bio® premium paid product (frontier tier)
- New section: Automated Email Response System with link to live preview
- Market cost comparison table: build it yourself = $18,000–$32,000; old call answering service
$200–$500/month with no CRM, no email, no dashboard
- Revenue projection table: 10 / 50 / 100 Co-Pilot Premium subscribers

VIP Report URL — Admin Only
- AI Speaking Strategic Briefing v002 accessible online at tradiesbio.au/admin/reports/ai-speaking
— admin login required

---

[3.4.1] — 2026-07-01 — Strategic Milestone — Tradies Bio® AI Speaking: Never Miss A Call

Strategic Acknowledgement

Tradies Bio® AI Speaking is now live in production — a cloud-based, automated call-answering
system that captures customer enquiries 24 hours a day, 7 days a week, with no human operator required.

This is a landmark addition to the Tradies Bio® platform. Every registered tradie with an active ABN
receives this capability as part of their free Tradies Bio® account — no subscription fees, no
per-call charges. The AI Speaking system is included in the same free offering that covers the
bio page, compliance vault, Co-Pilot, enquiries dashboard, and CRM.

What was implemented:
- Google Dialogflow CX integrated via a secure webhook (POST /webhooks/dialogflow) — token-verified,
fail-closed, production-hardened
- AI voice assistant answers calls 24/7, introduces the tradie's business, and collects 5 structured
enquiry details: name, email, callback number, job description, and urgency
- Every call is instantly logged as a Phone Inquiry in the tradie's Enquiries dashboard with source
badge, urgency level, job location, and caller details
- Automatic branded acknowledgement email dispatched to the caller within seconds if email provided
- Full enquiry lifecycle tracking: outcome (Won / Lost / Following Up), private timestamped notes,
response tracking
- Tradie guide page at /dashboard/phone-inquiries explaining the system in plain language
- Facilitator procedures manual at /facilitator/ai-speaking-guide

Benefits for tradies:
- Never lose a lead because the phone went unanswered on the tools, in a crawl space, or at dinner
- Every enquiry arrives pre-qualified with urgency and job description — you know what you're
walking into before you call back
- Caller receives professional confirmation within seconds — builds trust before first contact
- Works 24/7 including weekends, public holidays, and knock-off time
- No app to check — enquiries appear in the same dashboard as web form leads

Pricing: FREE — included in the standard Tradies Bio® account for licenced tradies with an active ABN.

Production status: Live. Webhook verified and tested. Alembic migration c7d8e9f0a1b2 applied.

---

[3.4.0] — 2026-06-30 — Phase 24 — Phone Inquiry System + Enquiry Dashboard Upgrade

Added — Phone Inquiry System (Dialogflow CX Integration)

Webhook endpoint POST /api/dialogflow-webhook — connects Dialogflow CX telephone flows to the Tradies Bio® platform.

• Receives call data from the AI voice assistant after a completed call
• Verifies caller identity via X-Webhook-Token header (HMAC-safe compare against DIALOGFLOW_WEBHOOK_SECRET env var)
• Matches the dialled number to a tradie via users.twilio_number
• Creates an Enquiry record with full phone inquiry fields: source, urgency, job_location, caller_phone
• Fires an automatic branded acknowledgement email to the caller within seconds of the call ending
• Returns a valid Dialogflow CX fulfillment JSON response confirming the enquiry was logged
• CSRF-exempt (machine-to-machine endpoint, authenticated by webhook token)

5 questions collected by the AI voice assistant:
1. Caller's full name
2. Email address (triggers auto-ack email)
3. Callback phone number
4. Job description — what they need done
5. Urgency — Today / This week / Quote only

Auto-acknowledgement email (templates/emails/phone_inquiry_ack.html) — fully branded with T-mark, business name, job details, urgency, and link to tradie's public bio. Sent automatically when caller provides email.

Database changes (Alembic migration c7d8e9f0a1b2):
- enquiries table: source, urgency, job_location, auto_ack_sent, auto_ack_sent_at, outcome, outcome_at, notes, responded_at, response_method
- users table: twilio_number (VARCHAR 20) — the Twilio number assigned to each tradie
- All existing enquiries backfilled with source = 'web'

Added — Enquiry Dashboard Upgrade

Source badges on every enquiry card:
- 📱 Web Form — enquiries from the public bio contact form (green badge)
- 📞 Phone Call — enquiries from the AI voice system (blue badge)

Urgency badges on phone inquiry cards:
- 🔴 Urgent — Today — call back within 15 minutes
- 🟠 This Week — follow up within 24 hours
- 📋 Quote Only — planning stage, respond within 48 hours

Outcome tracking — three buttons on every enquiry card:
- ✅ Won — job secured
- 🔄 Following Up — in conversation
- ❌ Lost — didn't get the job
- ✕ Clear — remove outcome flag

Private notes — freetext note field on every card. Each note is timestamped automatically (e.g. [30 Jun 11:18am] Called back — coming Thursday 2pm). Notes stack — multiple entries per enquiry.

Source filter — filter enquiries by All Sources / 📱 Web Form / 📞 Phone Calls (alongside existing status and sort filters).

Auto-ack status line on phone inquiry cards — shows whether the caller received a confirmation email.

Location display — suburb/area shown next to contact details when collected.

Outcome-coloured card border — green for Won, red for Lost, orange for Following Up — visible at a glance.

Outcome/notes routes:
- POST /dashboard/enquiries/<id>/outcome — set or clear outcome
- POST /dashboard/enquiries/<id>/note — append timestamped note

Added — Phone Inquiries Sidebar + Guide Page

Sidebar entry — "📞 Phone Inquiries" added to the Business Tools section.

Guide page GET /dashboard/phone-inquiries — tradie-facing explanation of the phone inquiry system:
- How the 5-step call flow works
- What lands in the dashboard
- Urgency badge meanings
- How to respond (call, SMS, Co-Pilot reply, outcome tracking)
- Pricing note (phone system is a premium add-on — all other features remain free for licenced tradies with an active ABN)
- Setup contact instructions

Changed — Web Form Enquiries

All new web form enquiries now tagged with source = 'web' at creation. Existing enquiries backfilled by migration.

---

[3.3.2] — 2026-06-26 — Co-Pilot "Save an Hour a Day" — 12-Feature Training

Changed — AI Co-Pilot

Presentation-ready training block added for the question "How can I save an hour a day in admin?"

The Co-Pilot now responds with a structured, numbered, alphabetical list of all 12 Tradies Bio® time-saving features — designed for live group demonstrations to accountants, business advisors, and decision-makers.

• Opens with a positioning statement: "Tradies Bio® has been built with AI at every screen"
• Lists all 12 features numbered 1–12 in alphabetical order, each with a plain-language benefit (2–3 lines)
• Features covered: AI Co-Pilot, Big Four, Chase Money by Voice, Document Vault, Enquiries Dashboard, Google Business Profile, Office BCC, Public Bio Page, Quote Builder, Siri Shortcuts, Supplier Orders, SWMS Builder
• Closes with the platform tagline and a built-in follow-up question: "Now — out of those 12, which one did you not know existed?"

The follow-up question is mandatory — it converts a demonstration into a conversation and lets the tradie identify their own gap.

Changed — Admin

• Admin Dashboard — new "Never Miss a Call" architecture brief added: cost trigger rule, built vs. to-be-built status, 7-step trigger flow, pricing tiers, facilitator opportunity card
• Facilitator Playbook — new upsell conversation section: opening questions, scripted pitch, two-tier pricing, cost rule

Changed — Dashboard / Edit Profile

• "Video Intro" renamed to "Your Business Video" across edit profile page
• "Finished a Job?" card: URL + Copy button replaced with full-width "📤 Send to Your Customer" button (Web Share API with clipboard fallback)

---

[3.3.1] — 2026-06-25 — Hero Banner Now Tappable → Co-Pilot

Changed — Dashboard

Hero banner converted from a passive <div> to a full-width tap target (<a>) linking directly to the Tradies Bio® AI Co-Pilot.

Added an orange "Save 1 hr/day — tap to start →" pill inside the banner text — sits beneath the "Less admin. More home time." headline. Signals clearly that the image is interactive and states the immediate benefit. Every pixel of the banner is now a tap target.

---

[3.3.0] — 2026-06-25 — Co-Pilot Showcase Carousel

Changed — Dashboard

Savings Pin → Co-Pilot Showcase — the dismissible blue strip replaced with a 3-panel auto-scrolling carousel that sells the platform's vision with maximum impact and minimal words.

Each panel auto-scrolls every 4.2 seconds, swipe-navigable on touch, orange dot indicators:

Panel	Headline	CTA
🎙️ Voice Control	"Run your business by voice" — Hey Siri, Tradie Money	Try Co-Pilot →
💬 Customer Enquiries	"Reply in seconds. Win the job."	Reply Now →
📤 Job Done?	"No website needed. No Google Ads."	Promote Yourself →

Every panel CTA is a live button that goes somewhere — Voice → Co-Pilot, Reply → Co-Pilot pre-loaded, Promote → Big Four page. No dead buttons. Each panel has its own gradient background (dark navy / dark green / dark blue) with orange eyebrow labels and white headline text.

Still dismissible (✕ top right). Uses new localStorage key tb_showcase_dismissed — existing tradies who dismissed the old savings pin will see the new carousel fresh.

---

[3.2.9] — 2026-06-25 — Big Four: "Something not right? We'll fix it."

New — Big Four page (/u/<slug>/big-four)

Recovery card added below the four positive-action cards — visible only when the tradie has a phone number on their profile.

• Separated from the Big Four by a subtle divider labelled "Anything you need?"
• Card text: "🤝 Something not right? We'll fix it."
• Sub-text: "Contact [Business Name] directly — we stand behind our work"
• Action: Opens an SMS directly to the tradie's phone number with a pre-addressed message: "Hi [Business Name], I wanted to reach out about the recent work."
• Visually distinct from the Big Four — dark charcoal background, no number badge, muted border — so happy customers scroll past it naturally

Why this matters: A slightly unhappy customer who has a direct SMS line to the tradie will almost always text rather than review. The tradie resolves it the same day. No 1-star Google review. No festering. One pre-emptive card protects the tradie's entire online reputation.

---

[3.2.8] — 2026-06-25 — Promote Yourself + Send to Your Customer

Changed — Dashboard Quick Tasks

• Promote Yourself button now has a bold orange outline and orange text to visually distinguish it from the five grey Co-Pilot task buttons. Orange fill on tap.

New — Big Four page (/u/<slug>/big-four)

Send to Your Customer — large full-width orange button added above the Big Four action cards.

• Tapping opens the iOS/Android native share sheet via the Web Share API (navigator.share). The pre-written message reads: "Hi! Thanks for choosing [Business Name]. Your feedback means everything — it only takes 30 seconds. Here's the link: [URL]"
• The tradie picks the customer from their contact list in the share sheet (iMessage, SMS, WhatsApp, email — their choice) and sends with one tap.
• Fallback: On browsers without Web Share API support (desktop), the button copies the Big Four URL to clipboard and shows a green "✓ Link copied" confirmation.
• A line below the button reads: "Opens your phone's share sheet — pick any contact"

Why this matters: A tradie finishing a job has their phone in their hand. One tap sends their Big Four link directly to the customer. No website needed, no Google Ads, no agent. The customer gets a Google review request, Facebook follow, referral form, and vCard — all in one link.

---

[3.2.7] — 2026-06-25 — Bunnings-Style Dashboard Redesign

Changed — Dashboard (/dashboard)

Full visual redesign of the tradie dashboard — Bunnings-inspired image card layout replacing the previous icon-only button grid.

Hero banner — Full-bleed photo (tradie on roof, hi-vis gear) with dark gradient overlay, orange "Tradies Bio® AI Co-Pilot" eyebrow, bold "Less admin. More home time." headline, and orange "Live Now" badge. Sits above all action cards.

Enquiries card — Redesigned as a bold full-width card with orange gradient (when new enquiries) or dark charcoal (when clear). Shows live unread count with white badge, or "All caught up ✓" when clear. Bubble decoration inspired by Bunnings' promotional banners.

SWMS Safety + Quotes — Side-by-side image cards with full-bleed background photos, dark gradient overlays, white label text, and coloured category badges ("Required" orange / "Fast" green) — exactly the treatment Bunnings uses for category tiles.

Compliance Vault — Full-width card with faded hero image fading in from the right, navy gradient left-to-right, icon + title + subtitle + chevron. Vault is now a destination card, not a plain button.

Monthly Check-in — Removed from dashboard. Still accessible via nav. Declutters the primary screen.

Siri Voice Shortcuts — New dark strip before Quick Tasks, showing three iOS Siri phrases tradies can set up: "Tradie Money", "Tradie SWMS", "Start Your Engines".

Quick Tasks — Alphabetical order. Removed "Write a Quote" (covered by Quotes image card). Added "Promote Yourself" (links to Big Four page).

Big Four section — Header renamed from "Tradies Bio® Big Four" to "Finished a Job?" — more intuitive trigger language.

---

[3.2.6] — 2026-06-24 — TB 365-100 Registry

New Feature — TB 365-100 Registry (Admin)

TB 365-100 is the new name for the permanent Google Meet communication channel between tradies and their business advisors. TB = Tradies Bio®, 365 = 365-day permanent link, 100 = the 100-second async video update format.

Registry page added at /admin/tb365-registry — accessible to admin team only (Stephen Pearce, Daniel Pearce, Ken Hall):

• Stock model — Google Meet URLs are loaded as generic stock (no firm assigned at import). Admin pastes URLs one per line, adds an optional batch note, and imports. URLs sit in the pool as Available.
• Assign — When an accounting practice refers a tradie, admin selects the firm name and the tradie. The next Available URL is locked to that tradie and firm instantly. The URL appears in the tradie's Business Advisor page automatically as their TB 365-100 Join button.
• Inventory view — Table shows Available and Assigned counts by accounting practice (BBA, WSC, etc.) with a live pool summary at the top.
• Recent assignments — Last 10 allocations shown with tradie, firm, date, and link.
• Quick link added to the Admin Dashboard.

Rename — "365 Link" renamed to "TB 365-100" throughout the Business Advisor page. Badge updated to "365d · 100sec". Button reads "Join — Open TB 365-100".

Database — New platform_meet_registry table added via idempotent migration b365100r001a.

---

[3.2.5] — 2026-06-23 — Production Hotfix · Migration Chain

Two non-idempotent migrations in the Business Advisor chain were blocking all production deploys. Migrations 5456564cea96 (add accountant_phone) and a7b7fa627a22 (add advisor_pending_questions) used batch_op.add_column, which fails with DuplicateColumn when the column already exists in the production database. Both rewritten to use ALTER TABLE … ADD COLUMN IF NOT EXISTS. The Business Advisor page (/dashboard/my-business-advisor) is now stable in production.

---

[3.2.4] — 2026-06-23 — Business Advisor · 365 Link

New Feature — 365 Link

A new 365 Link section has been added to the Business Advisor page (/dashboard/my-business-advisor).

A 365 Link is a permanent Google Meet URL that acts as a direct communication channel between you and your business advisor. Paste your Google Meet link once and it stays in your Tradies Bio® dashboard forever.

Two modes, one link:

• Together (synchronous): Both of you click the link at the same time — instant face-to-face meeting. No calendar invite. No new link to generate. No delay.
• Solo (asynchronous): You click it alone, hit record, and leave your advisor a video message or screen recording. Google Meet registers the activity and resets the expiry clock — keeping your 365 Link permanently alive.

How to use it: Paste your permanent Google Meet URL into the 365 Link field on the Business Advisor page and tap Save. A green 🎥 Join — Open 365 Link button then appears above the field so you can launch directly into the meeting room with one tap.

---

[3.2.3] — 2026-06-23 — Business Advisor · Production Crash Fix

Bug Fix — Business Advisor Page 500 Error

A production 500 crash on /dashboard/my-business-advisor introduced in the previous deployment has been resolved.

Root cause: Three Alembic migrations were not idempotent — if any of their target database columns or tables already existed (from a prior deployment), the migration would fail and leave the schema in a partially applied state. On the Business Advisor route, the lazy-migration block accessed accountant_* user fields directly without a safety net. A failed or partial migration left those columns in an uncertain state, causing SQLAlchemy to crash when the route tried to access them — specifically after any db.session.commit() call expired the current_user object and forced a reload.

What was fixed:

• c946cc5afa2c migration — add_accountant_fields_to_users now uses ALTER TABLE ... ADD COLUMN IF NOT EXISTS for all four accountant columns. Will run safely regardless of prior schema state.
• d11ae10a886a migration — add_advisor_fields_and_meetings_table now checks inspector.get_table_names() before creating the advisor_meetings table, and uses ADD COLUMN IF NOT EXISTS for all four advisor user columns.
• 5fd45cc95b6b migration — add_advisor_reviews_table was already made idempotent in this session.
• /dashboard/my-business-advisor route — The lazy-migration block is now fully wrapped in try/except with db.session.rollback() on failure. current_user.id is cached as a local variable before any commit() call so subsequent queries never depend on a potentially-expired ORM session. The accountant_* field sync in the POST handler is also wrapped in try/except for the same reason.

Result: The Business Advisor page loads correctly whether or not the accountant columns exist in the database. The idempotent migrations will cleanly record themselves in alembic_version on next deploy without touching any existing data.

---

[3.2.2] — 2026-06-22 — Co-Pilot Phone · Coming September 2026

Co-Pilot Phone — Introducing a New Optional Add-On

Tradies Bio® AI Co-Pilot is expanding. A new optional add-on is coming in September 2026 — Co-Pilot Phone — designed to ensure no tradie ever loses a lead because they were on the tools when a customer called.

A Register My Interest card is now live on the dashboard for every tradie. One tap registers your interest — the team will be in touch personally when it launches. No obligation. No charge to register.

---

[3.2.1] — 2026-06-22 — Platform Security Hardening · Anti-Scraping Protection

Increased Security — Competitor Scraping Protection

Three layers of anti-scraping protection added to Tradies Bio® at zero cost to the platform.

What was implemented:

• Bad-bot blocking middleware — 14 known aggressive scrapers (AhrefsBot, SemrushBot, DotBot, MJ12bot, DataForSeoBot, PetalBot, serpstatbot, BLEXBot, and others) are now blocked before they reach any page. Requests with no User-Agent identity are also rejected. Google, Bing, and Apple crawlers are unaffected — SEO is intact.

• Rate limits on public Bio pages — each tradie's public Bio page (/u/slug) is now limited to 30 requests per minute / 300 per hour from any single IP. vCard downloads are limited to 10 per minute. Real customers and real phones are unaffected; bulk enumeration is stopped.

• Tightened robots.txt — four additional private routes added to the Disallow list (/private/, /facilitator/, /checkin/, /risk-register/). Eight aggressive crawlers now have individual Disallow: / rules with their exact names — belt-and-suspenders protection for bots that respect the robots.txt protocol.

Cost: $0.

Cloudflare Pro — Not Implemented (Budget Decision)

Cloudflare Pro (the next logical layer of protection) is not being implemented at this time. At USD $20–$30/month it is not financially feasible for Tradies Bio® at the current stage of the platform.

Scheduled for discussion: September 2026 pricing review.

The three layers above provide meaningful protection at zero cost. Cloudflare Pro will be re-evaluated alongside the broader pricing and cost review in September 2026.

---

[3.2.0] — 2026-06-20 — Enquiry Reply via Email & SMS · Apple Shortcuts Programme

Co-Pilot Enquiry Reply — One-Tap Send

When a tradie opens the Co-Pilot via "Reply with Co-Pilot" from their Enquiries dashboard, the Co-Pilot drafts the reply as before — but now shows a three-button action bar immediately below the response:

• ✉️ Send Email — sends the reply directly to the customer's email address, signed with the tradie's business name, phone, and ABN. BCC'd to the office address if Office BCC is configured. One tap — no copy, no paste, no navigating away.
• 💬 Send SMS — opens the native iPhone or Android Messages app with the customer's phone number and the Co-Pilot reply pre-filled. The tradie taps Send. Only appears if the customer provided their phone number in their enquiry.
• ← Back to Enquiries — returns directly to the Enquiries list.

This eliminates the "copy and stare at the screen" problem. The tradie stays in flow from enquiry to sent reply without leaving Tradies Bio®.

Process — How Enquiry Replies Work

1. Customer submits an enquiry via the tradie's public Bio page
2. Tradie sees it in Enquiries (dashboard sidebar)
3. Tradie taps Reply with Co-Pilot — Co-Pilot opens with the customer's name and message already loaded
4. Co-Pilot drafts a professional reply in seconds
5. Tradie reviews — taps Send Email or Send SMS
6. Done. Back to the job.

Apple Shortcuts Programme — In Progress

Tradies Bio® has established a suite of custom Apple Shortcuts (iOS, voice-triggered via Siri) that connect directly to the platform. Shortcuts confirmed and in use as at 20 June 2026:

• "Hey Siri, Start Your Engines" — opens Tradies Bio® ready to work
• "Hey Siri, Tradies" — direct launch to the Tradies Bio® dashboard
• "Hey Siri, Trade Money" — quick access to financial and business planning tools within the Co-Pilot
• "Hey Siri, Trading Quote" — launches the Co-Pilot Quote Builder directly, ready to build a professional quote on site

Additional custom Shortcuts are being developed to trigger specific Co-Pilot quick tasks by voice — e.g. SWMS, Quote Builder, Supplier Order — so tradies can launch any platform feature hands-free from the job site.

This programme extends the existing "Hey Siri, Tradie SWMS" and "Hey Siri, Tradie Bio" shortcuts already live in the platform and documented in the app.

---

[3.1.2] — 2026-06-20 — AI Agent Confirmation · ChatGPT (GPT-4o) · 12-Week Review Cycle

Strategic Decision — Internal Record

Following a formal assessment of the AI agent landscape — including Apple Intelligence, Siri, and Google Gemini — Tradies Bio® has confirmed that ChatGPT (GPT-4o, via OpenAI) is the correct AI agent for the Tradies Bio® AI Co-Pilot at this time.

This decision is recorded as a standing platform commitment. Review cycle: every 12 weeks. Next review: 12 September 2026.

---

Assessment Summary — Apple Intelligence & Siri

A full strategic report was prepared and distributed to Stephen Pearce and Ken Hall on 20 June 2026. Key findings:

What Apple Intelligence is
Apple's on-device and cloud AI system, launched in iOS 18.1 (October 2024). Requires iPhone 15 Pro or iPhone 16 series (A17 Pro chip or later). Older iPhones — iPhone 14, 13, 12 — cannot run it.

Pros of Siri as AI agent for Tradies Bio®
- Native to the iPhone — "Hey Siri" triggers with no app launch, no tap, no login
- Apple Shortcuts already integrated into Tradies Bio® — this is our Siri layer, working today on every iPhone generation
- On-device processing — privacy-first, no third-party cloud for simple tasks
- Trusted brand — tradies are already comfortable with Siri
- The Credentials Pack ("send my verified licences to the builder") is a natural Siri/Shortcuts use case
- No per-token billing for voice-triggered intent actions

Cons and risks of Siri as primary AI agent
- Hardware wall: Apple Intelligence excluded on iPhone 14 and older — a large portion of the tradie market cannot access it
- 50% of Tradies Bio® users are on Android — Siri is iOS only, creating a two-tier product
- Siri's on-device model cannot generate complex content (quotes, SWMS, professional letters) at GPT-4o quality — it hands off to ChatGPT anyway
- No custom system prompt — Tradies Bio®'s tradie personality, Australian compliance context, and Co-Pilot voice cannot be injected into Siri
- Full Siri/App Intents integration requires a native iOS Swift app — not compatible with the current Python/Flask/PWA stack — estimated 3–5 months of development plus App Store submission
- Several advanced Siri features were still rolling out in Australia as of mid-2026

Comparison: GPT-4o vs Google Gemini vs Apple Intelligence/Siri

Capability	GPT-4o (current)	Gemini	Apple Intelligence/Siri
Text generation quality	★★★★★	★★★★★	★★★☆☆
Complex docs (quotes, SWMS, letters)	Excellent	Excellent	Basic / hands to ChatGPT
Custom tradie system prompt	✓ Full control	✓ Full control	✗ Not possible
Voice interface	Web Speech API (en-AU)	Web Speech API	✓ Native Siri — "Hey Siri"
iOS integration	Web / PWA	Web / PWA	✓ Deep native (App Intents)
Android support	✓ Full	✓ Full	✗ iOS only
Works on older iPhones	✓ All devices	✓ All devices	✗ iPhone 15 Pro+ only
Privacy	Cloud (OpenAI)	Cloud (Google)	✓ On-device option
Works with Python/Flask stack	✓ Native (current)	✓ Native (API swap)	✗ Requires Swift/Xcode
Australia availability (mid-2026)	✓ Full	✓ Full	Partial — rolling out
Migration effort from current stack	Already live	~2–4 weeks	3–5 months

Migration complexity
- GPT-4o → Gemini: a 3-line code change. Equivalent output quality. Viable contingency if OpenAI pricing or terms change.
- GPT-4o → Siri as primary AI: requires a native iOS Swift app, App Store submission, and complete rebuild of the Co-Pilot generation pipeline. Not a simple command swap.

Our Apple Shortcuts advantage
Tradies Bio® has already implemented Apple Shortcuts. "Hey Siri, [Shortcut name]" triggers Tradies Bio® actions by voice, on every iPhone generation, today — no App Intents, no native app, no App Store required. This is Siri integration working right now. The correct next step is to deepen the Shortcuts layer (more Co-Pilot tasks triggerable by voice), not to replace the GPT-4o generation engine.

---

Confirmed Platform Position

• AI generation engine: GPT-4o (OpenAI) via Replit AI Integrations proxy — confirmed ✓
• Voice interface: Web Speech API (en-AU) — confirmed ✓
• Apple integration: Apple Shortcuts (live, all iPhone generations) — confirmed ✓
• Next AI review: 12 September 2026
• Contingency: Google Gemini (3-line code swap, no architectural change)
• Longer-term watch: Apple App Intents — revisit when iPhone 16 hardware is dominant in the tradie market (est. 2027)

---

[3.1.1] — 2026-06-19 — Pitch Deck · Accountant Frontier Slide Strengthened

Pitch Deck — Internal

Rewrote the Accountant Frontier slide (slide 0.5) ahead of the Bruce Spaul meeting (23 Jun), BBA (29 Jun), and WSC (23 Jul 2026).

The banking decimation analogy now anchors the slide:

• Card 01 — The Avalanche: half of Australia's bank branches closed in a decade. Not a wave — an avalanche. Tax compliance work is on the same curve, right now.
• Card 02 — The Moment: AI is eliminating compliance work. Not a forecast. Tradie clients are already using voice AI on the job site every day.
• Card 03 — The Pioneering Opportunity: the winners when banking collapsed were not the branch managers — they were the advisors who became indispensable in the new world. Tradies Bio® is the bridge: your practice embedded in every tradie's dashboard before anyone else gets there.
• Pull-quote: "The bank managers who said 'our clients still prefer the branch' became the cautionary tale. The accountants who move first write the success story."

---

[3.1.0] — 2026-06-19 — Pitch Deck · Two Accountant Opener Slides Added

Pitch Deck — Internal

Two new slides added to the front of the Tradies Bio® pitch deck, purpose-built for tax accountant meetings.

• Slide 0 — Accountant Opener: Full-bleed dark opener with AI Gold Rush hero illustration. Headline: "The accountant who moves first wins." Three framing statements: The Automation Shift, Your Clients Are Already There, Tradies Bio® Is the Bridge.
• Slide 0.5 — The Frontier: Three-column reasoning slide building the avalanche case.

---

[3.0.9] — 2026-06-17 — Payment System Status · Admin Reference · September 2026 Review Item

Internal Admin Note — Not a User-Facing Release

This entry is a standing record of the payment system status for administrator reference and the September 2026 pricing review.

What is already built

The full Stripe subscription infrastructure exists and is wired to live Stripe keys:

• Every user account carries three fields: stripe_customer_id, stripe_subscription_id, and subscription_status
• A /checkout route exists with a complete Stripe Checkout session flow (create session, success, cancel, webhook confirmation)
• The subscription price is already coded at $9.99/month AUD
• The webhook handler that upgrades a user's subscription_status to "active" on confirmed payment is in place

What is NOT active

The gate. Nothing currently checks subscription_status before admitting a tradie to their dashboard, vault, Co-Pilot, or any other protected area. Every tradie who signs up receives free access — by design, for the free period running to the September 2026 review.

What flipping the paywall requires

When the decision is made to move to paid access, the following changes will be needed:

1. A subscription-check decorator applied to all protected dashboard routes
2. Redirect logic — unsubscribed users hit /checkout instead of their dashboard
3. Grandfathering decision — do tradies who joined before the paywall go-live date get a grace period or free-forever status?
4. Signup flow update — new tradies after go-live must subscribe before accessing the platform
5. Stripe webhook confirmation — already built, but must be verified against the live product/price ID

September 2026 review — decision required

• Confirm whether paid tier activates 1 January 2027 or is deferred
• Set the grandfathering policy for existing tradies
• Confirm the $9.99/month AUD price point or revise it
• Commission structure for Facilitators activates simultaneously with subscription income

---

[3.0.8] — 2026-06-16 — Facilitator Referral Engine · Self-Propelling Install & Signup Flow

Facilitators — 10 Referral System · Self-Propelling · Builds Each Facilitator's Own Business

Strategic · Stephen Pearce — Author and Architect

Why we built this — the problem it solves

A Facilitator's job is to introduce Tradies Bio® to tradies. Previously, that introduction required the Facilitator to be physically present, or to explain the platform verbally and hope the tradie remembered to look it up later. There was no frictionless, self-contained handoff. A tradie who received the link might open it once, close it, and never return. And critically — there was no mechanism for that tradie to then pass it forward to the next tradie, still linked back to the same Facilitator.

That gap is now closed.

What was built

Every Facilitator has a unique referral join link in the format:

tradiesbio.au/join?ref=asc_XX

Where XX is their personal referral code (SP = Stephen Pearce, DP = Daniel Pearce, BC = Brad Carter, GK = George Kijurina, KH = Ken Hall, JL = Josh Le Cudennec, LR = Leonard Ropeta, PS = Phil Sullivan, SW = Steve Wells — and every future Facilitator added to the platform).

When a tradie opens any Facilitator's link on their iPhone or Android, they now see — immediately, before anything else on the page — a dark-themed install banner:

📲 Add Tradies Bio® to your home screen
iPhone: Tap the Share button in Safari → Add to Home Screen → Add
Android: Tap the ⋮ menu in Chrome → Add to Home Screen

The tradie installs Tradies Bio® as an app on their phone home screen. They then complete signup — registered permanently under that Facilitator's referral code. From that moment, the Tradies Bio® icon sits on their phone alongside their other apps.

How the self-propelling referral chain works

Once the app is on a tradie's phone, they use it daily — quoting, SWMS, AI Co-Pilot, compliance vault. When a colleague asks "what's that?", the tradie opens Tradies Bio®, goes to their own referral link (built into their dashboard), and shares it. That next tradie goes through the same install flow — and signs up under the original Facilitator's code.

The Facilitator does the first referral. The platform does the rest.

Facilitator → Tradie A (installs + signs up) → Tradie A refers Tradie B → Tradie B refers Tradie C → all registered under the same Facilitator

The Facilitator's referral code travels forward through every generation of signup that flows from their original introduction. They do not need to be present for any of those subsequent referrals. Their income builds passively from a single conversation.

Procedure note — how the QR code travels

The ?ref=asc_XX part of the link is embedded in the QR code itself. It does not matter how many times the QR code is forwarded — whoever scans it and signs up is permanently recorded under that Facilitator. The attribution is captured the moment the join page loads, before a single field is filled in.

Facilitator shares QR code → Tradie A scans & signs up (Facilitator attributed ✓)
Tradie A screenshots the QR and sends it to Tradie B → Tradie B scans & signs up (same Facilitator attributed ✓)
Tradie B sends it to Tradie C → signs up (same Facilitator attributed ✓)

Critical distinction for the procedure: The Facilitator's QR code and personal link are what must travel forward — not a tradie's own dashboard referral link. Every tradie also has their own referral capability ("My Tradies" in their dashboard), but that is a separate tradie-to-tradie credits system. For Facilitator attribution to be preserved across the full chain, tradies should be encouraged to screenshot and forward the Facilitator's QR — not generate their own.

Why this matters for building a Facilitator's own business

Each of the 10 Facilitators is building their own stable. Their stable is not capped by how many people they can physically speak to. It is capped only by how many tradies are connected to the tradies they have already introduced. In a trade-dense network — a building site, a supplier relationship, a sporting club, a suburb — one Facilitator introduction can propagate through dozens of tradies without the Facilitator lifting a finger after the first conversation.

This is the Tradies Bio® referral flywheel:

1. Facilitator shares their personal link — once, to one tradie
2. Tradie installs the app, signs up, uses it every day
3. Tradie shares forward — naturally, conversationally, because it helps their peers
4. Every signup that flows from that chain is attributed to the same Facilitator
5. From 1 January 2027, every tradie in that chain generates subscription income for that Facilitator — monthly, passively, indefinitely

Technical implementation

• The install banner is built into the join page template — not specific to any referral code
• It detects mobile devices automatically — desktop visitors never see it
• It detects if the app is already installed — tradies who have already added it to their home screen do not see it again
• It can be dismissed with "Got it ✕" — dismissed state is saved to the device so it does not reappear
• Works for all current and future Facilitators with zero additional setup — any new Facilitator added to the platform gets this behaviour automatically from their first referral

Scope

This release applies globally to all 10 Facilitator slots — current and future. No Facilitator requires individual configuration. The referral attribution is handled by the ?ref=asc_XX parameter which is preserved through signup and stored against the new tradie's account permanently.

---

[3.0.7] — 2026-06-14 — Go-To-Market Strategy · URL Architecture for Audience-Specific Outreach

Strategic · Stephen Pearce — Author and Architect

Tradies Bio® will not be sold directly to tradies by Stephen Pearce. That is the job of Facilitators. Stephen's personal go-to-market focus is accountants, business advisors, and taxation professionals — the trusted advisors who already hold the relationships with licensed tradies across Australia.

Three dedicated URLs have been built and are live on tradiesbio.au for this purpose. Each one is designed for a different audience and a different moment in the conversation.

URL	Audience	Purpose
tradiesbio.au/accountants	Accountants & taxation advisors	Introduce the platform, frame the referral opportunity, establish trust
tradiesbio.au/aispeaking	Anyone curious about the AI Co-Pilot	Watch it in action — voice commands and live on-site demos
tradiesbio.au/theaistory	Boardroom, advisors, Facilitators	The full narrative — Our AI Gold Rush Moment, Win · Win · Win

How Stephen uses these URLs:

• Sent to an audience before a meeting — to warm the room and set the frame before Stephen arrives
• Opened on screen during a meeting — as a live showcase to open conversation and lead to a CTA
• Left with an audience after a meeting — as a reference point to share with colleagues

The distribution model:

Stephen speaks to groups of accountants and business advisors. Those advisors make recommendations to their stable of tradie clients — becoming Referral Associates of Tradies Bio®. Facilitators operate at the individual tradie level — one-to-one conversations — but the vision is that Facilitators will in turn present Tradies Bio® to their own groups, multiplying reach without Stephen needing to be in every room.

The chain:

Stephen → Accountants & Business Advisors → their tradie clients
Stephen → Facilitators → tradies one-to-one → Facilitators presenting to groups

This is a referral-led, relationship-first distribution model. The platform does not advertise directly to tradies. Word of mouth, trusted advisor recommendation, and Facilitator presentation are the three engines of growth.

---

[3.0.6] — 2026-06-09 — Facilitator Playbook + Onboarding Flow Formalised

Super Admin Only · Strictly Confidential

A locked internal strategy document — the Facilitator Playbook — has been added at /admin/facilitator-playbook. Visible only to super admins (Stephen Pearce, Ken Hall, Daniel Pearce).

What it covers:

• What Tradies Bio® is and the full tradie journey it supports (quoting → SWMS → compliance vault → AI Co-Pilot → risk mitigation → business exit tax-free)
• The Facilitator role: consultant and builder, not a salesperson; runs parallel to their existing career
• Two income streams — by design:
• Stream 1 — Subscription income: monthly, passive, forever, from 1 January 2027
• Stream 2 — Exertion income: consultative, active, starts immediately on first referral
• The minimum target: one new tradie per month (12/year); compounded by the tradie-refers-tradie model built into the platform
• Five-step onboarding procedure: Stephen invites → welcome email sent → Facilitator self-serves vault setup → begins referring immediately → management team provides ongoing support
• Recruiting correspondence log: summary of all outbound correspondence to Facilitator candidates, starting with Brad Carter (9 June 2026)
• Management responsibility: Stephen Pearce (relationships + strategy), Ken Hall (governance + oversight), Daniel Pearce (platform + operations)
• The vision: a committed Facilitator has the potential to match their current salary from their stable alone by mid-2027, with their existing job income unchanged

Self-service vault setup also completed this release:

A Facilitator invited via the welcome email can now click "Open My Vault →" and choose their own password without any manual action from Stephen. The setup link is time-limited (30 days) and signed with a server-side token.

Brad Carter onboarded — 9 June 2026:

Welcome email sent. Personal follow-up from Stephen sent (CC: Stephen, BCC: Daniel Pearce and Ken Hall). Brad's contact details saved to his associate record.

---

[3.0.5] — 2026-06-08 — Pricing Language Clarified — Free & Founding Members

Internal policy — no contradiction, no misleading claims

The words "free forever" and "permanently free" have been removed from all user-facing copy and are prohibited going forward. They were making a promise the business cannot guarantee.

Why "free" and "free for Founding Members" are not a contradiction:

• "Free" describes the current price. Accurate.
• "Founding Members" describes the group receiving that price. Accurate.
• "Licenced tradies with an active ABN" is an eligibility condition — it says who can join, not how long it will remain free. These are separate concepts.
• The Terms & Conditions already state that free does not mean permanently free. The marketing copy does not contradict the T&Cs — it never makes a duration promise.

When pricing is reviewed (September 2026, January 2027), Founding Members retain their status. New members after the cutoff date may be subject to subscription pricing. The ABN eligibility requirement does not change — it is not a pricing promise.

Approved language: "Free for Founding Members" · "free for licenced tradies with an active ABN" · "free"
Prohibited: "free forever" · "permanently free" · "always free" · "free for life"

---

[3.0.4] — 2026-06-07 — SEO Improvement: AI Co-Pilot & Quoting

What changed

The title and description that Google displays in search results have been updated. The old title was a tagline — "Tap It. Scan It. Share It." — which was memorable but did not match what tradies actually type into Google.

The new title is:

Tradies Bio® — Free AI Co-Pilot & Quoting for Australian Tradies

The new description (the blurb beneath the title in Google results) is:

Save 1 hour a day in admin. Free AI Co-Pilot, professional quoting, digital profile and compliance vault — built exclusively for licenced Australian tradies with an active ABN.

Why we changed it

Search engines rank pages by matching what people type into Google against what a page says it is. Tradies do not search for "Tap It Scan It Share It" — they search for things like "AI for tradies", "tradie quoting app", and "digital profile tradie Australia". The new title and description speak directly to those searches.

"AI" is the fastest-growing search category on Google globally right now. Tradies Bio® is one of the only platforms in Australia offering a free AI Co-Pilot to licenced tradies. This is early-mover territory — ranking for "AI for tradies" now, while competition is near zero, builds authority that is very hard for competitors to dislodge later.

"Quoting" was added because it has strong commercial intent — a tradie searching "quoting app" is ready to sign up.

"Save 1 hour a day" stays in the description as the click hook — once a tradie sees the result in Google, that line makes them tap it.

What we expect from this

• Google begins matching tradiesbio.au to "AI for tradies", "tradie quoting app", and related searches within 1–7 days of the next publish
• Higher click-through rate from search results (the "Save 1 hour a day" hook is more compelling than a tagline)
• Gradual ranking improvement for those search terms over 4–12 weeks as Google confirms the relevance

Structured data (schema) also updated

Three new schema blocks were added to the invisible code Google reads: SoftwareApplication, Service, and an OfferCatalog listing all five features (AI Co-Pilot, Professional Quoting, Digital Profile & QR Code, Compliance Vault, Lead Capture). This helps Google display richer search results — star ratings, feature descriptions, and service area (Australia-wide).

SEO monitoring cadence

SEO results are reviewed every 12 weeks. Baseline: June 2026. Next review: September 2026.

---

[3.0.3] — 2026-06-06 — Calling out Agencies & Google Vs Tradies Bio®

Dashboard — Savings Pin

Every tradie now sees a pinned message on their dashboard that puts the value of Tradies Bio® into plain dollars. An agency charges $1,500/month — nearly $40,000 a year — for Google review generation, social following, word-of-mouth referrals, and CRM. Tradies Bio® delivers all of this free to every licenced tradie with an active ABN.

The pin appears once on the dashboard. The tradie can dismiss it with a single tap and it stays gone permanently — no nagging.

Dashboard — After-Job Big Four Nudge

A mobile-only prompt appears at the bottom of the dashboard each session: "Just finished a job? Send your Tradies Bio® Big Four link." One tap drafts a warm thank-you SMS via the AI Co-Pilot with the tradie's Big Four link embedded — ready to copy and send from the ute. The Big Four link lets the customer leave a Google Review, follow on Facebook, refer a mate, or save the tradie's contact. This is the tradie sharing their credentials, seeking endorsement, and improving their standing with customers — all in one link, sent in 30 seconds. Dismissed per session so it reappears when it's most useful.

Co-Pilot — 📩 After-Job Link Quick Task

New Quick Task button in the AI Co-Pilot styled in Tradies Bio® steel blue. Tapping it asks the Co-Pilot to draft a personalised after-job SMS — the tradie provides the customer's first name and the Co-Pilot writes a professional, warm, under-160-character message with the Big Four link. No copy-paste, no agency needed.

Public Bio Footer — ABN Accuracy

Replaced the previous "credentials privately verified" claim with the accurate statement: ABN checked with the Australian Business Register (ABR). This is precisely what Tradies Bio® does — live ABR lookup at signup and on any update. Honest, verifiable, defensible.

---

[3.0.2] — 2026-06-05 — ⚠️ Security & Platform Risk Audit — Review Required 30 June 2026

Context

Questions raised by potential facilitator George (05 June 2026): "Can the system be hacked? Can someone access our data? What firewalls do we have?" These are legitimate pre-onboarding questions that will be asked repeatedly as the facilitator network grows. This entry documents the current security posture, the honest platform risks, and the mitigation actions to be completed before 30 June 2026 launch.

---

Current Security Posture — What Is In Place

Encryption in transit
All traffic is served over HTTPS (TLS). The Replit reverse proxy handles TLS termination. Data between a user's browser and the server is encrypted — equivalent to online banking standards. A network interceptor sees only scrambled noise.

Passwords
Passwords are hashed with pbkdf2:sha256 (Werkzeug). They are never stored in readable form. Even direct database access would yield only a one-way hash — no password can be recovered from it.

Application security headers — Flask-Talisman
Content Security Policy (CSP), X-Frame-Options, X-Content-Type-Options, and HSTS headers are active on every response. These block the most common web attack categories: cross-site scripting (XSS), clickjacking, and MIME-type sniffing.

CSRF protection
Every state-changing form carries a CSRF token. Requests from external sites cannot silently submit actions on behalf of a logged-in user.

Role-based access — hard boundaries
- Super admin (Stephen, Ken, Daniel): full access
- Admin: global customer list and most admin tools — no super-admin routes
- Facilitator: their assigned clients only — enforced at the database query level, not just the UI
- Tradie: their own profile and dashboard only
- Vault documents: every file download enforces user_id == current_user.id — a tradie cannot access another tradie's compliance documents even by guessing a URL

Payment data
No credit card or banking data is stored on Tradies Bio® servers. Stripe handles all payment processing. Card numbers never touch the application.

What data is actually stored
Business name, ABN (already a public record via the ABR), trade type, phone, email, service area, and compliance documents uploaded by the tradie. This is not a bank, health service, or identity provider. The risk profile of the stored data is low-medium.

Spam and bot protection
Enquiry forms carry a honeypot field. ABN is verified server-side via the ABR — it cannot be bypassed at the client.

---

Platform Risk — Replit Dependency

Honest assessment
Tradies Bio® is hosted entirely on Replit, which runs on Google Cloud Platform infrastructure. This is a real dependency. If Replit experienced an extended outage or ceased to operate, the platform would be unavailable until migrated.

Why this is manageable, not catastrophic
The entire platform is standard, portable technology:
- Language: Python 3.11 / Flask 3.x — runs on any Linux server
- Database: PostgreSQL — the most widely supported open-source database in the world
- Storage: object storage (compatible with S3-standard APIs)

Migration to any cloud provider (AWS Sydney, Google Cloud Sydney, a managed VPS) is achievable. It is not a rebuild — it is a redeployment. Estimated effort with a competent developer: one to two business days.

Replit's stability profile
Replit is a well-funded platform with millions of users and enterprise customers. Short outages (minutes to low hours) occur like any hosted platform. Extended outages are rare. Catastrophic data loss has not been a feature of their history.

---

Recommendations — Actions Required Before 30 June 2026

1. Automated weekly database backup (not yet built)
A scheduled export of the PostgreSQL database to a downloadable file (or secondary object storage bucket). This ensures that even in a worst-case scenario, all customer data — every tradie, every enquiry, every vault record — is recoverable. Stephen to confirm this is prioritised for build before launch.

2. Document the migration path (not yet written)
A one-page internal document describing the steps to move Tradies Bio® from Replit to an alternative host. Purpose: not because migration is expected, but so that if the question is ever asked ("what happens if Replit goes down?"), the answer is: "We have a tested plan." This is the professional standard for any business-critical platform.

3. Confirm super-admin accounts (in progress)
Ken Hall and Daniel Pearce to be promoted to super admin before launch. Stephen Pearce is the only account with change authority. This has been implemented in the access control layer — execution pending.

4. Facilitator briefing note (not yet written)
A plain-English one-page security summary for facilitators — covering what data is stored, how it is protected, and what happens in the event of a platform issue. George's question will be asked by every facilitator. Having a written answer is a professional obligation.

---

Review Date: 30 June 2026

All four recommendations above must be assessed at the 30 June launch review. Items 1 and 2 (backup and migration path) are considered pre-launch requirements. Items 3 and 4 are in progress.

Owner: Stephen Pearce. Raised: 05 June 2026.

---

[3.0.1] — 2026-06-04 — Phase 27: Prospect Nudge System

Overview

A full nudge system for prospects who haven't signed up yet — available to admins in the Prospect Register and to facilitators in their My Customers dashboard.

What Was Built

Nudge Email — emails/prospect_nudge.html
A warm, motivating follow-up email — distinct from the original concierge invite. Subject: "[Name] — your Tradies Bio® is still waiting for you". Body: lists all 5 features already built and waiting (Bio page, Enquiry form, QR/vCard, AI Co-Pilot, Vault), emphasises the platform is free, ends with a personal note from Stephen (or the facilitator). Every nudge refreshes the claim token so the link is always valid for 7 days.

Admin Nudge — Prospect Register (/admin/prospect-register)
Each pending prospect card now has a 📨 Nudge button alongside "Resend invite". Nudge vs Resend invite are intentionally different: the nudge sends the warmer motivating message, the resend sends the original technical invite. After each nudge the card shows "📨 Nudged 3× — last 4 Jun" so you always know the history at a glance.

Facilitator Nudge — My Customers (/dashboard/my-customers)
My Customers now splits into two sections: ⏳ Pending Sign-up (invited but not yet claimed) and ✅ Signed Up. Each pending prospect shows a 📨 Send Nudge button. Facilitators can only nudge their own prospects — security enforced server-side. Nudge count and last-nudge date show on every pending card.

Database migration cd56ef78ab90
Two new columns added to users: prospect_nudge_sent_at (DateTime) and prospect_nudge_count (Integer, default 0). Every nudge sent increments the count and updates the timestamp.

Email logging
Every nudge (admin or facilitator) is logged to email_logs with type prospect_nudge, full status tracking (sent / pending / failed), and sent_by_id so you always know who sent it.

---

[3.0.0] — 2026-06-04 — Phase 26: Prospect Follow-up Fix + Admin Logo Upload

Overview

iOS follow-up date bug fixed in the Prospect Register, plus a new super-admin logo upload capability on any tradie's Edit Profile page.

What Was Built

Prospect Register — iOS Follow-up Date Bug Fixed
On iOS Safari the native date wheel does not commit its value to the form input until the user taps "Done" on the picker — tapping the "Save" button directly without tapping "Done" first submitted the empty original value, leaving the date unchanged. Fix: onchange="this.form.submit()" added to the date input so the form saves automatically the instant iOS fires the change event (after "Done"). The manual "Save" button is retained as a fallback for desktop/Android. A success flash message is now displayed after every save so the admin can confirm the date was recorded.

Admin Logo Upload — /admin/tradies/<id>/edit-profile
New "🖼️ Profile Logo — Upload on Behalf of Tradie" section added to the Super Admin Edit Profile page. Accepts JPG or PNG up to 2 MB, stores the file in object storage under logos/<user_id>/, sets user.logo_url, and goes live on the tradie's public bio immediately. Existing logo (if any) is shown as a 72 px thumbnail before uploading. Full audit log entry written on every upload.

---

[2.9.9] — 2026-06-04 — Phase 25: Facilitator Matrix + Integrity Pass

Overview

Facilitator tracking matrix built into the admin, Josh Le Cudennec's name corrected globally, Daniel Pearce added to all admin notifications, and a platform-wide integrity pass removing undelivered Co-Pilot claims.

What Was Built

Facilitator Matrix — /admin/the-10-associates
The existing "The 10" page rebuilt as a full pipeline dashboard. Each of the 10 facilitator positions now shows: name, facilitator code, coloured avatar, onboarding status badge (🔵 Planning → 📤 Proposal Sent → ✅ Signed Off → 🟠 Active), proposal sent date, agreement date, and live tradie count. An ✏️ Update panel lets Stephen update status and dates inline — one tap, saved immediately. Total tradies under facilitator management displayed at the bottom. "Email All Facilitators" button opens a pre-addressed group email to everyone with an email on file. Three new columns added to the associates table via migration ab34cd56ef78: onboarding_status, proposal_date, agreement_date.

Activate My Customers — Admin Toggle
New 👥 button on every associate card in /admin/referral-associates. Links the associate to their tradie account (by email auto-match or manual dropdown) and activates the My Customers tab in their dashboard. Can be activated and deactivated without touching the database directly.

Daniel Pearce added to ADMIN_NOTIFY_LIST
daniel.pearce@teck.com added to mailer.py — Daniel now receives every admin notification alongside Stephen and Ken. Facilitator email previews fire to all three simultaneously.

Facilitator Confirmation Email Preview — All Admins
Test Lab "🔏 Facilitator NDA & Acceptance Confirmation" button now sends the George Kijurina preview to Stephen, Ken, and Daniel at once (marked [PREVIEW], nothing goes to George).

Integrity Pass — Co-Pilot Claims

Removed "invoices" and "BAS questions" from every Co-Pilot description across 12 files. The Co-Pilot only claims what it delivers: quotes, customer replies, payment chaser letters, supplier emails, WHS compliance, and vault-aware advice. Files updated: associate_welcome.html, facilitator-proposal-george-kijurina.html, welcome.html, referral_invite.html, index.html (3 locations), bio.html, copilot_teaser.html, procedures.html, accountants.html (2 locations).

Name Correction

Josh Le Cudennec — correct spelling confirmed and applied globally: associates table (DB), super_admin_progress_report.html, CHANGELOG.md. Previous entry "Josh Lecudennec" (one word) retired.

---

[2.9.8] — 2026-06-04 — Phase 24: Facilitator System — My Customers Dashboard + NDA Document

Overview

Groundwork for the Tradies Bio® Facilitator network — beginning with George Kijurina (Facilitator Code: GK), onboarded 3 June 2026 at the St George Club. This phase delivers the formal acceptance document, a privacy-first customer dashboard, and the database architecture to support a full facilitator network.

What Was Built

Confidentiality & Acceptance Agreement (/static/docs/facilitator-nda-george-kijurina.html)
A formal NDA and acceptance document for George Kijurina, modelled on the eBikeFamilySafe Confidentiality Understanding format — warm, clear, non-legalistic. Three-step process: read → enter details → reply to Stephen's email. Covers confidentiality of business model, commission structure, pricing, and growth plans; commission conditionality on subscription revenue; the 80-tradie group decision threshold; no ownership or IP rights; two-year duration. Includes a dedicated Privacy section explaining exactly what a facilitator can and cannot see on the platform — vault documents are never accessible, by design.

Facilitator Flag — Database Schema
Two new columns added to the users table via Alembic migration (ff01234567ab):
- is_facilitator (boolean, default false) — unlocks the My Customers tab
- linked_associate_id (FK → associates) — links the user's tradie account to their Associate record

My Customers Dashboard Tab (/dashboard/my-customers)
Visible only when is_facilitator = true and linked_associate_id is set. Shows every tradie referred by that facilitator's Associate code. Data displayed per tradie: business name, trade type, service area, ABN, phone (tap-to-call), email, and a link to their public bio page. Vault documents are inaccessible at the route level — not suppressed in a template, never queried. Privacy notice displayed at the top of every visit. Referral link card at the bottom so the facilitator can share their link.

Dashboard Home Card
A "My Customers 🚀" card appears in the dashboard card grid for facilitator accounts only — dark background, orange border, clearly labelled "Facilitator View". Invisible to all non-facilitator tradies.

Privacy Design

The facilitator data boundary is enforced at the route level, not the template level. The my_customers route queries only User records (public-profile fields). It never touches the Document model. A facilitator cannot reach vault data through any URL — there is no route that would expose it. This is stated explicitly in both the NDA document and the dashboard privacy notice.

Admin Activation

To activate My Customers for a facilitator: set is_facilitator = true and linked_associate_id = <associate.id> on their User record via the admin panel or direct DB update. No code change required — the UI unlocks automatically.

---

[2.9.7] — 2026-06-01 — Phase 23: Strategic Branding — @tradiesbio.aispeaking — YouTube & Instagram Voice + Video Launch

The Strategic Move

On 1 June 2026, Tradies Bio® secured and launched two dedicated social media channels under the handle @tradiesbio.aispeaking — on both YouTube and Instagram. This marks the beginning of a new phase: putting the Tradies Bio® AI Co-Pilot in front of every tradie in Australia, not through advertising, but through demonstration.

The premise is simple and powerful: show a tradie speaking into their phone and the work getting done. No typing. No searching. No admin at the kitchen table. Just a voice command — and the result appears.

---

The Brand — @tradiesbio.aispeaking

The handle was chosen deliberately. Every word carries weight:

• tradiesbio — the registered trademark (No. 2408794), the trusted name, the legal foundation
• ai — the technology at the core of the Co-Pilot; search-optimised, instantly understood
• speaking — the defining behaviour of the platform: voice as the interface, not a keyboard

The brand promise behind every piece of content on these channels:

"The trade is the brand. Your voice is the tool."

---

The Platform Strategy

YouTube (@tradiesbio.aispeaking)
The home for depth and discovery. Tutorial videos, full Co-Pilot walkthroughs, and YouTube Shorts (60 seconds) cross-posted from Instagram. SEO-optimised for tradies searching "AI for tradespeople Australia" and "Siri tradie shortcut." The educational anchor lives here.

Instagram (@tradiesbio.aispeaking)
The home for reach and virality. Reels of 15–60 seconds. The "10-Second Tradie" content series. Stories for behind-the-scenes. Every post links to tradiesbio.au for direct sign-up. Early engagement from the admin team signals to the algorithm that this content matters.

---

The Content Series — "The 10-Second Tradie"

Each episode demonstrates one voice command and one real outcome. No jargon. No explanation. A tradie speaks — and the result appears on screen in real time.

Episode	Voice Command	What the Viewer Sees
1 — The SWMS	"Hey Siri, Tradie SWMS"	SWMS builder opens instantly on site
2 — The Quote	"Hey Siri, Tradie Quote"	Co-Pilot drafts a professional quote in 60 seconds
3 — The Chase	"Hey Siri, Tradie Money"	Unpaid invoice followed up professionally
4 — The Supplier	Voice: "Order cement from Boral"	Full supplier order email drafted instantly
5 — The Ute Keys	Tradie, end of day, keys out of ute	Walks inside. Work done. Family time.

Android tradies use Google Assistant equivalents. Same outcome. Same ten seconds. Different phone.

---

The Vision — Admin Done During the Day

The purpose of this entire voice and video strategy is captured in a single sentence:

When the ute gets home and the keys come out — it's family time. All admin done and dusted.

Tradies Bio® AI Co-Pilot, combined with Apple Shortcuts (iPhone) and Google Assistant (Android), gives every tradie the ability to direct and control their business from the job site — while on the tools, in the ute, or between tasks. Quotes are sent. Invoices are chased. Supplier orders are placed. SWMS documents are opened. All of it done by voice, during working hours, without sitting at a desk.

This is not a future vision. It is live today, on tradiesbio.au, free for every licenced tradie with an active ABN.

---

How to Film the Videos — The Procedure

No camera crew is required. One iPhone. Built-in screen recording. Ten minutes.

1. Settings → Control Centre → add Screen Recording. Swipe down, tap record. The phone captures everything including Siri activating.
2. Say the command clearly and calmly: "Hey Siri, Tradie SWMS." Let the phone respond. That pause — and the result — is the content.
3. Optionally: prop a second phone to film the first phone in hand. Combine as picture-in-picture.
4. Post with the caption formula: "A tradie shouldn't have to stop working to do the paperwork. [Command] → [Result]. No typing. No searching. Just speak. tradiesbio.au"

---

Strategic Report Distributed

A full strategic report — eight sections, colour-coded action steps, brand assessment, production procedure, and first five videos to produce immediately — was sent on 1 June 2026 to:

• Daniel Pearce — Super Administrator, Kamloops BC
• Ken Hall — Administrator
• Josh Le Cudennec — Facilitator (IT Lead)
• Phil Sullivan — Adviser
• Stephen Pearce — Founder (CC)

---

Instagram QR Code — @tradiesbio.aispeaking

The official Instagram profile QR code for @tradiesbio.aispeaking is saved at:
/static/branding/tradiesbio-aispeaking-instagram-qr.jpeg

Scan to follow. Share with every tradie you know.

---

Recorded by Stephen Pearce — Founder, Tradies Bio® — 1 June 2026

---

[2.9.6] — 2026-06-01 — Vision Extended: The Facilitators, the Foundation, and the Story Behind It All

Foundational Statement — Recorded for the Record

Written 1 June 2026 — Stephen Pearce, Founder — Tradies Bio®
Updating a foundational document nearly 2½ years in the making — from 1 November 2023, when this idea began.

---

A Heading from the Founder

This is a love story. And it is an amazing journey.

I retired at 67 years of age. I had earned it. And then — despite opposition from places I never expected, from directions I never anticipated — I came out of retirement.

Not because I had to. Because I could not leave this alone.

What followed has been one of the most remarkable chapters of my life: learning things I never imagined I would learn, creating an opportunity that did not exist, and sharing it with the people I trust most. Trusted others who saw what I saw, believed what I believed, and said yes.

Tradies Bio® is the result. It is not just a platform. It is what happens when you refuse to accept that the best chapters are behind you.

---

The Original Vision — 2 May 2026

Carried forward here because it is the root of everything that follows.

Tradies Bio® is not a marketing system. It is not a CRM. It is not another agency asking for a monthly retainer.

It is a foundation — and the deeper the foundation, the higher the building.

The goal is to give every tradie in Australia the tools to:

• Be found — professionally, credibly, on their own terms
• Stay compliant — with every licence and insurance tracked and reminded automatically
• Never miss a lead — the AI Co-Pilot handles enquiry replies while they're on the tools
• Build their reputation — through authentic Google reviews, NFC-enabled customer handoffs, and a bio page that works 24 hours a day
• Recapture their time — for the people who matter, not for admin that doesn't
• Build genuine business wealth — so that one day, they can step off the tools, sell their business as a going concern, and retire on what they built

Tradies Bio® has strategies for all of this. Some are built. More are coming.

But the most important thing — the thing that makes this different from every agency and every platform that came before — is this:

Tradies Bio® is on the tradie's side. Full stop.

— Stephen Pearce, Founder — Tradies Bio® — 2 May 2026

---

The Vision Extended — 1 June 2026

The foundation is set. Now the vision grows.

The Facilitators — Ten People Who Build Other People's Businesses

I see ten people. Not employees. Not contractors. Not salespeople.

I see ten Founding Associates and Business Facilitators — each one building their own group of customers, their own network, their own practice. Each one starting, perhaps, as a side hustle with no guarantees. That is honest. That is real. Most things worth doing begin that way.

What I see for them — over time, with commitment and care — is this:

• Their own portfolio of tradies whom they personally support
• A 30% share of the subscription income derived from every tradie in their group — a genuine stake in what they help build
• Growing confidence in a consultative and mentoring role
• A profession — not just a task — built on the understanding that building another person's business is their business

This is not a commission structure. It is a philosophy. The facilitator who understands that their success lives inside the success of the tradies they serve — that person will build something lasting.

I believe in this model because I have lived it. And the story of how I came to live it is worth telling.

---

The Story — Kalamazoo, a Lost Licence, and a Cargo Plane to New Zealand

Many years ago, I was a sales representative and business consultant for a company called Kalamazoo — a business that sold manual business systems. Asset registers. Receipts. Real, physical, hands-on business tools installed into real businesses. It was meaningful work, and I was good at it.

Then I lost my licence.

I was driving to Queensland to visit my mother, June Josephine. Between Sydney and the Gold Coast — between Sydney and Miami Beach — I was booked by police twice on the same day. Two bookings. One drive. And the moment I told my employer that I had lost my licence, I lost everything that came with it: the car, the job, the income. All of it, in a single conversation.

I will not pretend that was an easy time.

At home were my two young children — Daniel, aged 10, and Rebecca, aged 7 — in the care of Nelly, our housekeeper. I recall those moments the way you recall the things that mark you: completely, and forever. Daniel and Rebecca will have their own memories of that time. That is theirs to carry. What I carry is the knowledge that I showed up anyway — broken as I was — because there was no other option that I was willing to take.

I have never given up. I have never stopped showing up. Even when it looked dark. Even when it looked bad. Even when I was, by any honest measure, broken. This is not a boast. It is a record. Because the facilitators who read this document deserve to know that the person who built this platform has stood where they may one day stand — and kept moving.

But a friend — a man I had met only once, who lived in New Zealand — heard what had happened. And he said: "Come to me. Let's do a week together."

At 2 o'clock in the morning, I boarded a DHL cargo plane — not a passenger flight, a working aircraft carrying mail and parcels — with two pilots and the kind of silence that sits between a person and a very large decision. I arrived in New Zealand at approximately 3 am.

My friend was, at the time, around the age I am now. I turn 72 on 7 June 2026. He took me under his wing. He took me out hunting. He spent time with me — real time, unhurried time. And he showed me something quietly remarkable: he had built a small consulting practice helping the people in his local community navigate GST — goods and services tax. Simple, practical, grounded help. Exactly what people needed.

That was the week I became a consultant.

I flew back to Australia with something I had not arrived with: a direction. And I have not stopped learning since that point.

---

Daniel, Rebecca — Look at You Now

Daniel and Rebecca are now adults, married, building their own families. I am their father and I am their greatest fan. I am enormously and unreservedly proud of both of you — proud of the families you are building, proud of the people you have become, proud of the way you show up for each other and for the people around you.

Daniel — you live in Kamloops, Canada. You called me one day from there and you said: "Dad, you must check out ChatGPT."

I could not even spell AI at the time.

But I listened. And not long after that call, I sat on a train — from Engadine Station to Circular Quay — and I wrote a business plan. The whole journey. The whole idea. By the time the train pulled into the city, something was on the page that had not existed when I boarded.

That was the beginning of Tradies Bio®.

AI did not build this. But AI opened a door I did not know was there. And Daniel — you handed me the key.

---

To Our Facilitators — This Is Your Story Too

Every facilitator who joins the Tradies Bio® family is, in some sense, standing at a similar crossroads. Perhaps not as dramatic. Perhaps not at 2 am on a cargo plane. But a crossroads nonetheless — between what is familiar and what is possible.

The encouragement I want to leave with you is this: you will be successful at whatever you do — if you do it with integrity, if you do it in the service of someone else's genuine need, and if you do not stop.

Consulting is not a credential. It is not a certificate on a wall. It is a decision — made again each morning — that your knowledge, your experience, and your time are worth investing in another person's future.

That decision compounds.

---

The Ute Keys Come Out — and It Is Family Time

Here is what Tradies Bio® is actually for. Not the technology. Not the features. Not the AI.

This:

A tradie pulls up at home at the end of the day. He turns off the engine. He takes the keys out of the ute. And he walks inside — because the work is done. The quotes are sent. The leads are followed up. The enquiries are replied to. The admin is finished. The Co-Pilot handled it while he was on the tools.

Before Tradies Bio®, that tradie walked in the door and the second shift began. Quoting. Following up money. Responding to enquiries. Preparing proposals. Sending emails. After a full day on the tools — another two hours at the kitchen table. Tired. Stressed. Present in body, absent in mind.

That was the reality for tradespeople across Australia — not because they were disorganised or weak, but because no one had built a system that worked the way they work.

Tradies Bio® has come along to change that.

When the keys come out of the ute — it is family time. That is the promise. That is the product. Everything else is how we keep it.

---

The Driving Force — Faith

I take no credit for any of this. None.

The ideas, the timing, the people who have come alongside, the open doors — I do not attribute these to my own cleverness. At the centre of my life, and at the centre of this venture, is my faith in Jesus Christ. That is my rock. That is my driving force. That is the anchor that held when the licence was gone, when the job was gone, when the income was gone, and two young children were at home with Nelly.

I read the Scriptures every day. Not as ritual. As nourishment. And I have never learned more quickly than when I am in them.

Rebecca — you will understand this perfectly. You have heard my voice messages. You know the ones. And the scripture that comes to mind as I write this is the Good Samaritan — the one who stopped when the crowd walked past. The one who was not in the crowd.

That is the standard. Not to be in the crowd. To stop. To help. To be genuinely useful to the person in front of you.

That is what a facilitator is. That is what Tradies Bio® is.

To our facilitators, to my family, to those who follow this document in years to come — I leave you with an open Bible. Proverbs 3 and Proverbs 4. Read them slowly. Read them when you are beginning something. Read them when you are afraid. Read them when someone tells you it cannot be done.

Daniel — ask Rebecca. Rebecca — ask Daniel. Love from Dad.

---

Win — Win — Win

Tradies Bio® is built to be a win for the tradie, a win for the facilitator, and a win for the platform. Not two of the three. All three.

The tradie wins because they have tools, support, and a professional presence that used to cost them thousands and now costs them nothing — and because when the keys come out of the ute, the work is finished.

The facilitator wins because they have a practice, a purpose, an income, and the deep satisfaction of knowing that the people in their care are growing.

The platform wins because when both of those are true, it sustains itself — and grows.

This is the model. This has been the model from 1 November 2023, when the first idea was written down on a train between Engadine and Circular Quay. Nearly two and a half years later, the foundation is in the ground. The building is going up.

— Stephen Pearce, Founder — Tradies Bio® — 1 June 2026

---

[2.9.5] — 2026-05-31 — App Store Decision: Not Now, Not Yet, and Here Is Why

Strategic Note — Recorded for the Record

Decision confirmed 31 May 2026 — Stephen Pearce, Founder

---

The Decision

Tradies Bio® will not be submitted to the Apple App Store or the Google Play Store at this time.

The platform operates as a Progressive Web App (PWA) — tradies access it through any web browser, and on iPhone or Android they can tap "Add to Home Screen" to place the Tradies Bio® icon directly on their phone. It looks and behaves like a native app. No App Store required.

This decision is confirmed. It is not a default — it is a choice. And every choice deserves an explanation.

---

Why Not the App Store?

1. Cost is not justified at this stage.
Apple charges $149 USD per year for the privilege of listing on the App Store. Google charges $25 USD once. Beyond the fees, submission requires ongoing maintenance, review cycles, compliance with platform policies, and — for in-app payments — Apple's 30% commission on any revenue processed through their system. These costs are a weight we do not need to carry before we have signed our first paying customer.

2. Discovery is not our strategy.
The App Store is valuable when strangers are searching for your product. That is not our growth model. Tradies Bio® grows through person-to-person contact — our Founding Associates and Business Facilitators introduce the platform directly to tradies in their own networks. A tradie does not need to find us in a search result. They are introduced by someone they already trust. That introduction is worth more than any ranking algorithm.

3. Our distribution channels are personal, not digital.
Our Associates — the Mighty Seven, and those who follow — each carry a personal target of 100 tradies. They reach those tradies face to face, through trade events, word of mouth, and professional referrals. Accountants, bookkeepers, industry contacts — these are the channels that will build this business. The App Store does not open those doors.

4. The PWA is already working.
Tradies Bio® is live at tradiesbio.au. It works on every device. It can be installed on a phone home screen in 30 seconds. The mobile app is built and ready — it is not going anywhere. If the strategy changes in 2027, or at the review dates of 30 June 2026 and 1 January 2027, the technical work is already done. Submitting to the App Store at that point would be a single decision, not a rebuild.

---

A Note for Daniel, and for Those Who Follow

This section is written deliberately — not as a technical record, but as a lesson in how decisions are made.

Daniel — you will make hundreds of decisions in building a business. Most of them will not be in a boardroom. They will be at 2am, or between calls, or when someone asks "why aren't you on the App Store yet?" and expects a short answer.

Here is what I want you to understand: a decision is only as good as the reasoning behind it. Not the outcome — the reasoning. The outcome is not always in your control. The reasoning always is.

When we decided not to go to the App Store today, it was not because we could not do it. We could. The technical work is done. It was because — at this moment, at this stage, with this growth model — it does not serve us. The cost is real. The benefit is not.

That is the discipline of a good decision: being honest about what you actually need, not what sounds impressive.

We are not on the App Store because we are in rooms with people. We are shaking hands. We are explaining the platform face to face. We are building trust, not traffic. And when the time comes — if the time comes — we will list the app, and we will have a user base already waiting.

Make decisions for the right reasons. Write them down. Own them. And when you revisit them — which you always should — judge them by the reasoning of the day, not the outcome of tomorrow.

— Stephen Pearce, Founder, Tradies Bio®

---

[2.9.4] — 2026-05-29 — Scaling to 1,000 Customers: Capacity Report & Growth Model

Strategic Note — Recorded for the Record

Platform infrastructure reviewed and confirmed fit for purpose — 29 May 2026

Tradies Bio® is hosted on Replit, which serves as both the development environment and the production deployment platform. This entry records the capacity assessment conducted today and confirms the growth model that will carry the platform from zero customers to 1,000 and beyond.

---

Replit Capacity Assessment

Replit is not simply a code editor — it is a managed cloud platform that handles the database (PostgreSQL), object storage (vault documents and logos), SSL certificates, domain routing, and deployment infrastructure. For a national Australian platform targeting licensed tradespeople, it is more than adequate.

Key findings:

• 1,000 registered tradies does not mean 1,000 simultaneous users. Realistic peak concurrency for a platform of this type is 20–50 users at any one time. Current infrastructure handles this comfortably.
• Storage per tradie: approximately 28 MB (logo 2 MB + up to 5 vault documents at 5 MB each + database records). At 1,000 tradies: ~28 GB total object storage — well within Replit's managed storage capacity.
• Database: PostgreSQL can handle tens of millions of rows. 1,000 tradie records is a negligible load.
• Compute: The app runs on Gunicorn (Python/Flask). Two workers is sufficient to approximately 200–300 active tradies. Workers can be increased with a single config change. Autoscale deployment (available on Replit) handles 500–1,000+ tradies automatically.
• Infrastructure cost at 1,000 tradies: estimated $50–$200 AUD per month — a fraction of the $30,000/month potential revenue at $30/month per tradie.

Scaling milestones — no action required today:

Milestone	Action
0–200 tradies	No changes — current setup is fine
200–500 tradies	Increase Gunicorn workers from 2 to 6 (minutes to implement)
500–1,000 tradies	Switch to Autoscale deployment (platform already stateless — clean transition)
1,000+ tradies	Review database plan and object storage tier

Verdict: Replit can comfortably support Tradies Bio® to 1,000 tradies and significantly beyond. It is not the scaling risk. The platform is pioneering — we have not yet onboarded our first paying customer — and the infrastructure headroom is substantial.

---

The 10 Trusted Referrers — Growth Model Confirmed

The growth strategy is built on a simple, symmetrical model: 10 trusted people, each responsible for 100 tradies. 10 × 100 = 1,000.

This spreads the load across a trusted network, increases the capacity to reach tradies quickly, and creates a personal accountability for each referrer — every tradie they bring in is registered under their name from day one. When the platform moves from free to a subscription model, each referrer earns commission on the tradies they personally referred.

Current roster — 7 of 10 slots filled (alphabetical order):

1. Brad Carter (BC)
2. Daniel Pearce (DP)
3. Josh Le Cudennec (JL)
4. Ken Hall (KH)
5. Phil Sullivan (PS)
6. Stephen Pearce (SP)
7. Steve Wells (SW)

3 slots remaining. The next three must be chosen with great care. They must be of the same calibre as the Mighty Seven — trusted, motivated, well-connected in the trades industry, and aligned with the values and purpose of Tradies Bio®. Quality over speed. The wrong person in a referrer slot is worse than an empty slot.

What each referrer carries:
- A personal target of 100 tradies brought onto the platform under their name
- A stake in the future subscription revenue from those 100 tradies
- A responsibility to represent Tradies Bio® with integrity — every tradie they bring in is a reflection of them

The load is shared. The benefit is shared. The growth is shared.

---

[2.9.3] — 2026-05-29 — Strategic Progress Report Email + Test Lab Super Admin Section

Added

Strategic Progress Report email — Super Admin Only
- New email template emails/super_admin_progress_report.html — full branded strategic briefing
- Covers: 1,000-tradie target · $30,000/month projection at $30/month · The Mighty Seven roster table · three entry channels (direct, Facebook, Concierge) · 3 slots remaining · virtual meeting request · super admin dashboard briefing
- Recipients: Ken Hall (knhall6@gmail.com), Daniel Pearce (daniel.pearce@teck.com) — CC: Stephen Pearce
- New send_super_admin_progress_report() function added to mailer.py

Test Lab — Super Admin Strategic Emails section
- New section visible only to Super Admin users at /admin/test-lab
- Orange-bordered card with confirmation dialog before sending — "This is a LIVE send. Are you ready?"
- Fire the strategic progress report to Ken & Daniel in one tap, anytime

---

[2.9.2] — 2026-05-29 — Associates Roster Built to 7 of 10

Changed

• Josh Le Cudennec — surname confirmed from email (joshlecude@gmail.com); updated from voice-to-text error; email saved to associates record
• Steve Wells added as Associate #6 — initials SW, referral code SW
• Brad Carter added as Associate #7 — initials BC, referral code BC; 7 of 10 referrer slots now filled
• Scoreboard now shows: Brad Carter (BC), Daniel Pearce (DP), Josh Le Cudennec (JL), Ken Hall (KH), Phil Sullivan (PS), Stephen Pearce (SP), Steve Wells (SW) — alphabetical, each targeting 100 tradies; 3 slots remaining

---

[2.9.1] — 2026-05-29 — 10 Trusted Referrers · Road to 1,000 Scoreboard

Why We Built This

Tradies Bio® growth is built on 10 trusted people — admins and associates — each responsible for bringing in 100 tradies. 10 × 100 = 1,000. When the platform moves from free to a subscription model, each referrer shares in the income from their 100 tradies. This release locks in that model visually and structurally.

Added

Scoreboard redesign — per-person 100-tradie target
- Each referrer now shows their personal progress toward their 100-tradie target (e.g. 23/100) with a colour-matched mini progress bar — replacing the old "% of total" column
- Scoreboard header now shows the referrer slot count: 5 of 10 referrers active + a colour-coded pill showing slots remaining (green / amber / red)
- Footer reads: 5/10 referrers · 100 each · 1,000 total target
- Scoreboard column heading updated from "Share" → "→ 100 target"
- Scoreboard remains visible to Super Admin users only (Stephen, Ken, Daniel)

Associates alphabetical order throughout
- Dashboard scoreboard now sorted A → Z by name (was sorted by referral count descending)
- Matches Stephen's stated preference: symmetry + alpha order

Phil Sullivan added as Referral Associate #5
- Added to associates table: Phil Sullivan (PS, referral code PS)
- 5 of 10 referrer slots now filled: Daniel Pearce, Josh (JL), Ken Hall, Phil Sullivan, Stephen Pearce

10-slot cap on Associates admin page
- Visual slot indicator at top of page: 10 orange/grey squares showing filled vs available slots
- Create form title now reads "Add a New Referral Associate (slot X of 10)"
- When all 10 slots are filled: create form is greyed out with a lock notice; no new associate can be added until one is deactivated

Super Admin confirmed
- Stephen Pearce, Ken Hall, and Daniel Pearce are all Super Admin — any one can step up if needed; no hierarchy among supers
- Phil Sullivan and Steve Wells remain standard admins

Model

• 10 referrers maximum — admins and associates are the same pool
• 100 tradies each — personal target per referrer
• 1,000 total — platform milestone for subscription launch review
• Commission structure (30% per referrer on their tradies' subscriptions) activates when free → subscription transition occurs — review September 2026 / January 2027

---

[2.9.0] — 2026-05-29 — Session Cookie Fix + Test Lab Reliability

Why We Built This

The Tradies Bio® AI Co-Pilot was storing up to 20 conversation turns directly in the browser session cookie. Each AI response can reach 1,000 characters, pushing the cookie to 4,094 bytes — one byte above the browser's hard limit of 4,093 bytes. Browsers silently discard cookies that exceed this limit, which meant after a few Co-Pilot messages the session was dropped entirely. Without a valid session, Flask-WTF's CSRF protection rejected every subsequent form submission with a 400 error — including the Test Lab QuickStart simulation button. This is why the simulation appeared not to fire.

Fixed

Session cookie bloat — Co-Pilot history moved to database
- Created new copilot_sessions table (user_id, history JSON, updated_at) to store conversation turns server-side
- All three Co-Pilot routes (/dashboard/copilot, /dashboard/copilot/chat, /dashboard/copilot/clear) now read/write conversation history from the database — zero session cookie usage
- Session cookie is now ~300 bytes regardless of how many Co-Pilot messages have been exchanged
- Conversation history persists across browser sessions (20-turn window maintained)
- Alembic migration bfe0c68fc3e0 applied

Production migration idempotency fix
- Migration dfe624b0aaf7 (add_clients_table) now checks whether the clients table already exists before attempting to create it — eliminates the startup warning on the production database

MAIL_USERNAME whitespace strip
- app/__init__.py now strips leading/trailing whitespace from MAIL_USERNAME env var on startup — prevents SMTP authentication failures from env var typos

/fb route fixed — now sends tradies directly to QuickStart signup
- /fb was redirecting to the Facebook community landing page (/facebook) instead of the QuickStart signup form — tradies clicking the link from a Facebook post were landing on a marketing page, not the signup form
- /fb now does a 301 redirect to /quickstart?ref=facebook — identical behaviour to /qs, correctly tagging the signup source as facebook
- The Facebook community page remains accessible at /facebook for direct links

Impact

Test Lab QuickStart simulation (Google Sheets + Admin Alert + Activation Email) will now execute reliably. The three-step simulation result panel should show green ticks after each run. The /fb link shared on Facebook now takes tradies straight to the signup form.

---

[2.8.0] — 2026-05-29 — Email Deliverability — Consistent Sender Identity Across All Outbound Emails

Why We Built This

Outbound emails from Tradies Bio® were using three different From addresses (info@, admin@, and stephenp@) with no display name and no Reply-To header on most messages. That inconsistency is a primary spam signal — when the same domain sends from multiple addresses, filters penalise it. Every email now carries a single, consistent identity.

Changed

Unified sender identity across every outbound email
- All 30+ Message() calls across mailer.py, admin.py, auth.py, public.py, copilot.py, swms.py, accountants.py, and quotes.py now use a named sender: Stephen Pearce — Tradies Bio® <stephenp@tradiesbio.au>
- No more info@tradiesbio.au or admin@tradiesbio.au From addresses — unified to stephenp@tradiesbio.au
- MAIL_DEFAULT_SENDER app config default updated from info@tradiesbio.au to stephenp@tradiesbio.au
- _sender() helper in mailer.py returns the named tuple ("Stephen Pearce — Tradies Bio®", addr) for all sends
- REPLY_TO = "stephenp@tradiesbio.au" constant added to mailer.py

Reply-To headers added to all tradie-facing emails
- Welcome, onboarding, concierge invite, GBP support, password reset, QuickStart welcome, platform updates, associate welcome, SWMS delivery, quotes, quote nudges, accountant autoresponse — all now carry Reply-To: stephenp@tradiesbio.au
- Emails where replies should go to the tradie (accountant referral, credentials pack, supplier enquiry, enquiry notification) retain their existing reply_to=tradie.email or reply_to=customer_email

Email footer — Facebook follower count corrected
- base_email.html footer updated from 2,500 → 2,100 followers

CRM capture gap fixed — Concierge pre-registration now writes to Google Sheets immediately
- Previously, a Concierge-invited tradie was only written to Google Sheets when they claimed their account (set their password). If they never activated, they were invisible to the Google Sheets CRM.
- append_signup now fires at the moment Stephen creates the Concierge profile — regardless of whether the tradie ever claims it
- Full CRM capture confirmed across all entry points — see audit below

CRM Capture Audit — All Entry Points

Entry Point	Google Sheets	Prospect Register	Notes
Regular signup /signup	✅ Immediately on submit	— (by design)	Admin alert fires to Stephen + Ken
QuickStart /qs, /fb	✅ Immediately on submit	✅ Auto-listed	Tagged with signup_source (facebook / associate / quickstart)
Concierge (Stephen creates)	✅ Immediately on creation (fixed)	✅ Auto-listed	Was only writing on claim — now writes on creation
Concierge (tradie claims)	✅ Also at claim (unchanged)	Already listed	Duplicate-safe — second write doesn't harm the sheet

---

[2.7.0] — 2026-05-29 — Tradies QuickStart — Friction-Free Public Signup + Facebook Campaign

Why We Built This

The original signup flow required a tradie to create a password, fill in a full profile, and navigate the dashboard before seeing any value. That friction was costing us signups.

Tradies QuickStart removes that barrier entirely. A tradie enters four things — business name, ABN, mobile, and email — and within seconds they receive a branded activation email with a direct link to set their password and access the full Tradies Bio® platform. No password upfront. No long form. No confusion.

This is the entry point for our Facebook community campaign and associate referral network. Every signup via QuickStart is tagged by source so we can track exactly where our growth is coming from.

Added

QuickStart Signup Flow (/quickstart, alias /qs)
- New public signup route — 4 fields only: business name, ABN, mobile, email (confirmed twice)
- Live ABR verification on submit — checks ABN is active and captures the registered entity name
- Duplicate checks: existing email or ABN redirects to login with a clear message
- Creates an unclaimed profile (is_claimed=False) with a 48-hour activation token
- Branded activation email fires immediately — tradie clicks the link, sets their password, and lands in their full dashboard
- copilot_enabled=True set on creation — tradie has full Co-Pilot access from day one
- Rate-limited to 30 submissions per hour per IP

Admin Alerts — Stephen + Ken on Every QuickStart Signup
- send_admin_signup_alert() fires to ADMIN_NOTIFY_LIST (stephenp@tradiesbio.au + knhall6@gmail.com) on every QuickStart submission
- Alert includes business name, ABN, mobile, email, and signup source

Signup Source Tracking
- New signup_source column on the users table (Alembic migration 5457b3ddc94d)
- Tagged automatically: facebook (via /facebook?ref=facebook), associate (via ref=asc_*), or quickstart (direct)
- Admin tradie list shows 📘 Facebook, ⚡ QuickStart, 🤝 Associate badges on each tradie card
- New stat cards on admin dashboard: "From Facebook" and "Via QuickStart" counts
- Filter dropdown: "📘 From Facebook" and "⚡ Via QuickStart" options

Facebook Community Landing Page (/facebook, alias /fb)
- Dedicated campaign page for the 2,100+ Facebook community members
- Personal message from Stephen Pearce — Founder
- Five benefit panels: Bio page, Compliance Vault, AI Co-Pilot, SWMS — Built in 60 Seconds, Google Reviews
- Single CTA → /quickstart?ref=facebook — all signups from this page tagged facebook
- 100% Free badge, 2-minute setup stat, $0 cost — front and centre

Google Sheets Signup Register — QuickStart Captured
- Every QuickStart signup now appends a row to the Tradies Bio® Signups Google Sheet, matching the regular signup flow
- Row includes: date, business name, email, phone, ABN, trade type, ABR-verified name
- Source field distinguishes QuickStart / Facebook / Associate entries

Test Lab — QuickStart Welcome Email
- New ⚡ QuickStart Welcome Email card added to /admin/test-lab
- Fire the exact activation email a tradie receives from the Facebook campaign or tradiesbio.au/qs — straight to your inbox for copy and layout review

Automatic Database Migration on Startup
- run.py now calls flask_migrate.upgrade() on every app startup
- Production database stays in sync automatically on every publish — no manual flask db upgrade commands required

---

[2.6.3] — 2026-05-26 — Concierge Claim — Welcome Email + Admin Alert + Google Sheets

Added

• When a concierge-invited tradie claims their profile (sets password and logs in for the first time), three things now fire automatically:
• Welcome email sent to the tradie
• Admin alert sent to Stephen + Ken Hall
• Row appended to the Tradies Bio® Signups Google Sheet
• Removed stale HubSpot import from auth.py (HubSpot fully removed from codebase)

---

[2.6.2] — 2026-05-26 — Google Sheets Signup Register Live

Added

• Every new tradie signup now automatically appends a row to the Tradies Bio® Signups Google Sheet (Date, Business Name, Full Name, Email, Phone, ABN, Trade Type, ABR Verified Name)
• Admin Test Lab updated: "Add Test Row" button fires a live Google Sheets append for testing without creating a real account
• Full signup simulation updated: Step 1 is now Google Sheets (replaces HubSpot)

Removed

• HubSpot CRM integration removed from signup flow and profile updates — HubSpot push no longer fires on new tradie registration

---

[2.6.1] — 2026-05-25 — Platform Philosophy, Credentials Disclaimer & Internal Due Diligence Framework

Classification: Administrative & Philosophy Record — For Investors, Partners & Stakeholders

By Stephen Pearce — Founder, Tradies Bio®

---

The Tradies Bio® Philosophy — Recorded 25 May 2026

Tradies Bio® is built on a simple belief: a tradie who presents themselves professionally, keeps their credentials current, and takes their business seriously will win more work, build more trust, and grow a better business. Our job is to make that easy. Not to police. Not to punish. To support.

This entry records the platform's philosophy on credentials, due diligence, and the responsibility that comes with operating a platform that bears a registered trademark and is connected — indirectly — to the professional reputations of every tradie who uses it.

---

Credentials — What Tradies Bio® Does and Does Not Claim

As of 25 May 2026, the Terms of Service (Section 6, effective today) have been updated with a formal disclaimer. In plain terms:

• Tradies Bio® does not independently verify any licence, insurance, qualification, or document uploaded by a tradie.
• Everything displayed on a tradie's public bio is entered by the tradie themselves. If they say they hold a current trade licence, a public liability policy, and a Working With Children check — that is their declaration, not ours.
• If they have declared it, that is on them. Tradies Bio® carries no liability for the accuracy of tradie-supplied information.
• Any person relying on a tradie's public profile does so at their own risk.

This is the correct and honest position for a platform of this kind. It mirrors the approach taken by hipages, ServiceSeeking, and Airtasker — none of whom independently verify credentials either.

---

What Tradies Bio® Is Doing — Encouragement, Not Enforcement

The platform is not designed to be a handbrake. It is designed to raise the standard of professional presentation across the Australian trades industry — one tradie at a time, voluntarily and in their own interest. Every tool on the platform points in this direction:

Tool	What it does
Compliance Vault	A tradie's own secure home — upload your trade licence, public liability insurance, WWC check, WHS certificates. It is yours. It stays yours.
Dashboard status banner	Now reads: "Profile active — keep adding to your vault to build your professional reputation." A call to action. An encouragement. Not a warning.
Accountant & Business Advisor panel	Added to every tradie's sidebar — a direct cross-referral channel to accounting and business advisory professionals.
Credentials Pack	One tap from the vault sends a professionally branded bundle of all uploaded documents to any recipient — client, site manager, accountant, or prospective employer.
Blog — Tradies Bio® AI Co-Pilot	Stephen Pearce is writing blog posts that encourage tradies to take specific professional actions — including seeing their accountant before 30 June 2026 (end of financial year) and every 12 weeks thereafter. This is part of the platform's commitment to actively improving tradie business outcomes, not just hosting a profile.

---

Internal Due Diligence — Soft, Not Public

Tradies Bio® will, over time, conduct its own quiet internal due diligence across the tradie base. This is not a public verification scheme. It is not penalising. It is simply good stewardship of a platform that carries a registered trademark and a founder's name.

This internal process will include:

• Getting to know tradies — as the platform grows, Stephen Pearce and the administration team will build direct relationships with tradies on the platform. Trust is earned through interaction, not just a form.
• HubSpot CRM cross-referencing — every tradie who registers is automatically synced to HubSpot. Over time, the CRM will record engagement, communication history, and any due diligence notes. This is an internal record, never visible to other tradies or the public.
• Google Business Profile cross-checking — tradies who link their Google Business Profile provide an independent signal: reviews, trading history, and a business address on Google Maps. A tradie with a verified GBP listing, a trading history, and customer reviews is a tradie with a publicly verifiable track record. Tradies Bio® will use this signal as a soft credibility indicator internally.
• Indirect crosschecking — Stephen Pearce, through his own professional network, business experience, and industry knowledge, will apply judgement to accounts that raise questions. This is not algorithmic. It is the kind of due diligence a responsible founder exercises.

This framework is recorded here as a commitment, not a policy document. It will evolve. It will not be published. It is how Tradies Bio® will maintain the integrity of the platform without becoming a bureaucracy.

---

Why This Matters

Stephen Pearce's name is indirectly attached to every tradie on Tradies Bio®. The platform is a registered trademark. The tagline — Building Your Business Is Our Business — is a promise. A tradie who shares their Tradies Bio® profile is sharing something that carries the Tradies Bio® brand alongside it.

That is a responsibility taken seriously. The T&Cs disclaimer protects the platform legally. The encouragement tools — vault, blog, accountant referral, credentials pack — raise the standard in practice. And the soft internal due diligence framework ensures that as the platform grows, it does so with integrity.

This is not compliance theatre. This is how a founder who cares about their name, their trademark, and the tradies they serve runs a platform.

— Stephen Pearce, Founder, Tradies Bio®, 25 May 2026

---

[2.6.0] — 2026-05-25 — Dashboard Revamp, Accountant Referral Network & Platform Improvements

Classification: Strategic Platform Release — Administration Record

By Stephen Pearce — Founder, Tradies Bio®

---

Today, 25 May 2026, Tradies Bio® delivered a significant round of improvements focused on three priorities: making the tradie dashboard simpler and more powerful, opening a direct referral channel to accountants and business advisors, and tightening the platform's content governance so that tradies always see the right information — no more, no less. Ten improvements were delivered and are recorded below.

Note: Stephen Pearce is meeting with accountant and business advisor Julie Norris on Wednesday. This meeting is recorded here as part of the Tradies Bio® commercial development timeline.

---

Ten Improvements — 25 May 2026

#	Improvement	Benefit
1	Dashboard sidebar revamp — simplified structure, cleaner section headings, best-practice mobile layout	Tradies can navigate the platform in seconds, not minutes. Less clutter, more clarity.
2	Accountant & Business Advisor panel — new blue heading and cross-marketing strip in the dashboard sidebar	Opens a direct referral channel between Tradies Bio® and the accounting profession — a major commercial opportunity
3	Referral strip redesign — blue gradient, "FREE*" bolded, T&Cs footnote, modal header updated to match brand	Makes the referral proposition clearer and more persuasive for tradies sharing their bio page
4	Credentials Pack — one-tap email from the Compliance Vault that sends a tradie's full business credentials to any recipient	Tradies can send a professional credentials package to a client, accountant, or site manager in seconds — a genuine competitive advantage
5	Blog editor title field — auto-expanding textarea replaces the cramped single-line input; full title always visible on mobile	Stephen can now read and edit the full title on his iPhone without the text being cut off
6	Blog hero image upload from phone — photo upload added directly inside the blog editor	Stephen can photograph a job site or resource on his iPhone and publish it to the blog without a desktop
7	Blog iOS keyboard fix — removed URL popup that interfered with the title and field input on iPhone	Cleaner, faster editing on iOS — no more autocorrect and URL suggestions hijacking the title field
8	Compliance checker improvements — fuzzy keyword matching for WWC and WTC licences, duplicate document warnings	Tradies are warned before they accidentally upload the same document twice, and the checker correctly identifies Working With Children and Working With Children Check documents
9	Resources section — read-only for tradies — Blog and Conversations links now appear in every tradie's sidebar	Tradies can read the content Tradies Bio® publishes — educational, trust-building, and adds perceived value to membership
10	Blog Editor — admin-only access preserved — tradies see the blog but cannot write, edit, or publish	Content governance is protected. Stephen controls what is published on Tradies Bio®.

---

Accountant & Business Advisor Integration — Context

The connection between Tradies Bio® and the accounting profession is not incidental — it is strategic. Tradies who are ABN-verified, licence-compliant, and using Tradies Bio® professionally are exactly the kind of clients that good accountants want. The referral strip and Credentials Pack together give tradies the tools to present themselves professionally and give accountants a reason to recommend Tradies Bio® to every trade client they service.

This positions Tradies Bio® at the intersection of two large professional networks — tradespeople and their trusted advisors — which is a distribution advantage that no competitor currently holds.

Julie Norris — accountant and business advisor — is being briefed by Stephen Pearce on Wednesday. This meeting is part of the broader strategy to build the accountant referral network ahead of the 30 June 2026 launch.

---

Full platform history: tradiesbio.au/changelog

---

[2.5.1] — 2026-05-23 — Platform Record: Cost Analysis, Replit Acknowledgement & Administration Team

Classification: Administrative Record — For Investors, Partners & Stakeholders

By Stephen Pearce — Founder, Tradies Bio®

---

Platform Cost — Analysis & Record

Recorded in response to Daniel Pearce's independent assessment, 23 May 2026.

Daniel Pearce, Software Engineer, Kamloops, British Columbia, Canada — and Super Administrator of Tradies Bio® — independently assessed the platform and estimated the cost to commission an equivalent build from a professional software development agency at $40,000 AUD. His assessment was made as a qualified software engineer reviewing the platform's scope, complexity, and feature set.

That estimate is conservative. A full breakdown of what has been built, with industry agency cost ranges:

Component	Industry Agency Cost (AUD)
Flask web application — 22 phases, full feature set	$30,000 — $60,000
PostgreSQL database — design, migrations, relationships	$8,000 — $15,000
AI Co-Pilot — purpose-built, voice input (en-AU), 24/7	$20,000 — $40,000
Progressive Web App (PWA) — offline, home screen install, service worker	$10,000 — $20,000
Stripe payments integration	$5,000 — $10,000
HubSpot CRM integration — auto-sync on every signup	$5,000 — $10,000
ABN verification — live ABR government API	$3,000 — $6,000
Compliance Vault — secure upload, expiry badge alerts	$8,000 — $15,000
SWMS Builder — WHS Act 2011 compliant	$8,000 — $15,000
Business Risk Register & Safety Risk Register	$8,000 — $15,000
Email automation — welcome, referral, alerts, BCC	$5,000 — $10,000
Admin panel — tradie list, comms register, procedures manual	$8,000 — $15,000
NFC / QR code / vCard share system	$3,000 — $6,000
Native iOS & Android mobile app — Expo SDK 54 / React Native	$40,000 — $80,000
Total industry estimate	$161,000 — $317,000

Actual cost to date: Replit subscription only.

This cost-benefit analysis is recorded here as the authoritative record for any commercial, investment, or partnership conversation that references the Tradies Bio® development history.

---

⭐ Special Acknowledgement — Replit

Tradies Bio® was built entirely on Replit.

Replit is an AI-powered software development platform that gave Stephen Pearce — a non-traditional developer — the tools, the environment, and the AI assistance to design, build, test, and deploy a production-grade web platform with a registered trademark, live payment systems, government API integrations, and a Progressive Web App.

This acknowledgement is recorded here permanently in the Tradies Bio® changelog, and is displayed in the footer of every page at tradiesbio.au — the Replit logo and link appear on every page, every day.

Replit deserves full credit for making Tradies Bio® possible. Without Replit, this platform does not exist.

"Replit gave me the opportunity, the tools, and the confidence to build something I believed in. Nearly three years. One subscription. One platform. This is what Replit makes possible."
— Stephen Pearce, Founder, Tradies Bio®

Tradies Bio® acknowledges Replit publicly and in perpetuity as the platform on which it was built.

---

Administration Team — Recorded 23 May 2026

The following individuals are acknowledged as the founding administration team of Tradies Bio®, recorded here on 23 May 2026.

Name	Role	Notes
Stephen Pearce	Founder & Super Administrator	stephenp@tradiesbio.au — Australia
Daniel Pearce	Super Administrator	Software Engineer — Kamloops, British Columbia, Canada
Ken Hall	Administrator	knhall6@gmail.com — Australia
Phil Sullivan	Administrator & IT Adviser	Australia
Steve Wells	Administrator	Australia

Stephen Pearce thanks each member of this team for their support, their time, and their belief in what Tradies Bio® is building. We are pioneering this together.

Ken Hall, Phil Sullivan, and Daniel Pearce — your contribution to this platform is recorded here permanently. Thank you.

---

Terms of Service

A Terms of Service page was added to tradiesbio.au on 23 May 2026, accessible at /terms. Key protections recorded:

• Tradies Bio® is a registered trademark — TM No. 2408794, IP Australia. The name, brand, and T-mark are protected.
• All content, copy, code structure, feature design, and platform elements are protected by copyright.
• Scraping, cloning, reproducing, or commercially exploiting any part of the platform is explicitly prohibited.
• The platform is governed by the laws of New South Wales, Australia.

---

[2.5.0] — 2026-05-23 — Mobile App, PWA Milestone & Platform Improvements

Classification: Major Strategic Milestone — Mobile Presence Achieved

By Stephen Pearce — Founder, Tradies Bio®

Today, 23 May 2026, Tradies Bio® crossed a milestone that most software platforms take years and hundreds of thousands of dollars to reach. The platform is now a fully operational Progressive Web App — working like a native phone app on iPhone and Android — and a native iOS mobile app was built and successfully tested in production. This entry records what was achieved, the strategic decision made, and every improvement delivered on this date. This is the authoritative record for investors, partners, and the administration team.

---

The Mobile Milestone — In Plain Terms

Any tradie who visits tradiesbio.au on their iPhone or Android phone can now:

1. Open Safari (iPhone) or Chrome (Android)
2. Log in as normal
3. Tap Share → Add to Home Screen
4. Tap Add

From that moment, Tradies Bio® sits on their home screen as a permanent icon — orange TB mark, full name. When they tap it, the platform opens full screen with no browser bar, no URL, no Safari buttons. It looks, feels, and behaves exactly like a professionally built app from the App Store. Every feature — AI Co-Pilot, Compliance Vault, Enquiries, SWMS Builder, Public Bio — is available.

This is a PWA: Progressive Web App. It is not a workaround. It is a deliberate, modern web standard used by major platforms worldwide. It works on every iPhone and every Android phone, with no App Store visit required, no download, no waiting.

---

Native iOS App — Built and Tested 23 May 2026

A native iOS and Android mobile app was built using React Native and Expo SDK 54. Stephen Pearce logged into his full Pioneer Pearce dashboard on his iPhone at 3:05 PM today — the first successful iOS login to Tradies Bio®. The app mirrors the full website: AI Co-Pilot, Enquiries, Compliance Vault, SWMS Builder, dashboard stats — everything. Every change made to the website appears in the app automatically. One platform, maintained once, works everywhere.

Estimated industry cost to commission this from an Australian development agency:

• Design and scoping: $20,000 — $40,000
• iOS development: $40,000 — $80,000
• Android development: $40,000 — $80,000
• Backend integration: $20,000 — $40,000
• Testing and launch: $10,000 — $20,000
• Total industry estimate: $130,000 — $260,000

Actual additional cost: $0.

Phil Sullivan (IT advisor) was briefed and provided with Expo Go access instructions.

---

App Store Decision — Decided and Recorded 23 May 2026

Decision: Not proceeding with Apple Developer Program or Google Play Developer registration at this stage.

Costs if and when we proceed:
- Apple App Store: $149 AUD per year (annual renewal, developer.apple.com)
- Google Play Store: $35 USD once only, never renewed (play.google.com/console)
- Total first year both stores: approximately $205 AUD

Why we are not proceeding now:

The PWA already delivers the full app experience on iPhone and Android at zero cost. The only thing the App Store adds is searchability — tradies finding the platform by searching "Tradies Bio" in the App Store. At pre-launch stage with 38 days to the 30 June 2026 go-live, App Store submission timelines introduce unnecessary risk. The codebase is fully ready and the option remains open permanently.

Review date: 30 June 2026.
Advisor: Phil Sullivan — to provide direction on next best step at that review.

---

Added

• PWA — Progressive Web App confirmed and documented. Full Add to Home Screen capability on iPhone (Safari) and Android (Chrome). Tradies get a permanent app icon on their phone home screen in three taps from the moment they sign up. No App Store required.

• Welcome email — Add to Home Screen instructions added. Every new tradie signup now receives step-by-step iPhone and Android instructions as part of their welcome email, in a dedicated "Put Tradies Bio® on Your Phone" section with separate iPhone and Android instruction cards.

• Referral system — full popup modal built on every tradie's public Bio page. The "Refer a Tradie" button now opens a professional modal with: a dark charcoal header, an AI Co-Pilot callout ("their secret weapon — the tool their competitors don't have yet"), three simple fields (your name, mate's name, mate's email), and a Send Invitation button. On submission, a fully branded invitation email is sent to the referred tradie. Stephen is BCC'd on every referral automatically. The referral copy on the Bio page was updated to lead with the AI.

• Facebook CTA on every outbound email — a permanent "Follow Tradies Bio® on Facebook" block added to the base email template. Appears on every single outbound email: welcome, onboarding, GBP group emails, monthly check-in, enquiry notification, referral invitation. Blue (#1877F2) design consistent with reports styling. Copy: "You are part of something being built from the ground up." Mentions 2,500+ followers and invites every tradie to follow and share the journey.

• Referral invitation email template created. Fully branded, leads with the AI Co-Pilot as the headline feature, covers digital profile, Compliance Vault, and free signup. Direct link to tradiesbio.au/join.

Fixed

• SWMS email — "Network error" on Send PDF Now resolved. The email route was creating a fresh mail connection without credentials instead of using the platform's configured mail instance. Fixed to use the correct mail instance — the same one used for all other platform emails. Error handling in the Send PDF button also improved to surface the real server message instead of the generic "Network error."

---

Strategic Note — This is How Tradies Bio® Was Built

The mobile milestone achieved today at zero additional cost is the clearest demonstration of what the Tradies Bio® development approach delivers. A platform with a native app experience, AI Co-Pilot, full compliance vault, CRM integration, ABN verification, voice input, SWMS builder with digital signatures, referral system, and email automation — built by one founder, without an agency, without a development team, without a six-figure budget. This is recorded here as context for any commercial conversation, investor review, or partnership discussion that references the platform's history.

Stephen Pearce
Founder — Tradies Bio®
23 May 2026

---

[2.4.0] — 2026-05-22 — SWMS Digital Signatures & Voice Shortcut

Classification: Major Improvement — SWMS Evolution & Strategic Platform Advancement

This release is a deliberate, strategic upgrade to the SWMS feature — not a cosmetic change. It solves two real problems that tradies face on site: (1) collecting legally valid signatures without paper, and (2) opening the SWMS builder instantly when your hands are occupied. These two additions make the Tradies Bio® SWMS builder the most practical, site-ready compliance tool available to Australian tradespeople.

Added

• Digital Signature Pad — Section 13 of the SWMS — A new section added at the bottom of every SWMS document allowing workers and supervisors to sign directly on a mobile screen using their finger. Each signature pad captures:
• Full name and role/trade input fields per signatory
• HTML5 Canvas drawing area — works with any finger, stylus, or thumb (built for tradies, not graphic designers)
• "Save Signature" button — the moment it is tapped, the exact date and time (to the minute, Australian format) is permanently locked beside the signature. It cannot be changed after saving.
• "Re-sign" option — if a mistake is made before saving, the pad can be cleared and redrawn
• "Add Another Signature" button — unlimited signature pads can be added for multi-worker sites. Each is independent with its own name, role, and timestamp.
• Print-ready — saved signatures render as PNG images when the SWMS is printed or saved as PDF. The canvas drawing area is automatically hidden on print; only the saved image and timestamp appear. Compliant with Australian WHS documentation requirements.

• No server required — signatures are client-side only. The SWMS remains a zero-dependency, offline-capable document builder.

• Voice Shortcut — "Hey Siri, Tradies Bio SWMS" — A new feature strip at the top of the SWMS page (screen-only, does not print) guides tradies through a 3-step Apple Shortcut setup that binds the phrase "Hey Siri, Tradies Bio SWMS" to instantly open tradiesbio.au/dashboard/swms. Built specifically for tradies who have fat fingers, full hands, and no patience for typing on site. The phonetic trigger "SWMS" (pronounced "swim-s" or however the tradie says it) is recorded in Siri by the tradie themselves — it works regardless of pronunciation because they record it in their own voice. Once set up, the entire SWMS builder is one voice command away. This is not a gimmick — it removes a genuine friction point that would otherwise stop a tradie from using the tool on a job site.

• Landing page features — Two new feature tiles added to the "Everything Your Business Needs" section on the public landing page:

• "Digital SWMS with Finger Signatures" — plain English explanation of the on-site signing workflow
• "Hey Siri, Tradies Bio SWMS" — the voice shortcut explained as a tradie benefit, not a tech feature

Strategic Context

The SWMS builder began as a paper-replacement tool. With this release it becomes a fully digital on-site compliance workflow: the tradie builds the document in the dashboard, workers sign it in Section 13, the date and time are locked, and the PDF is generated — all without a printer, a pen, or a clipboard. The voice shortcut closes the last gap: getting the tool open when you are mid-task on site.

---

[2.3.0] — 2026-05-21 — Accountants & Business Advisors

Added

• Accountants & Business Advisors page — a dedicated public landing page at /accountants (also accessible via /accountant) built specifically for the tax accountants and business advisors who work with licenced tradespeople. The page explains what Tradies Bio® provides to their tradie clients, how the Business Risk Register connects directly to tax strategy conversations (Small Business CGT Concessions), and why every tradie should bring this document to their accountant once a year at tax time. Accountants can submit their details via a simple form and receive an immediate automated email with the full Tradies Bio® platform overview — plus an internal alert fires to Stephen and Ken so warm leads get a personal follow-up. The page is publicly accessible with no login required and is designed to be shared directly with accounting practices.

• Automated accountant email response — when an accountant or business advisor submits their details via the /accountants page, two emails fire automatically: (1) a full branded pitch email to the accountant covering every platform feature, the risk register, the CGT concessions opportunity, and free access for their licenced tradie clients; (2) an internal admin alert to Stephen and Ken identifying the enquiry as a warm lead. No manual follow-up needed to get the full story in front of an accountant within seconds of them clicking.

• Accountant referral strip — a sky-blue instruction strip added to the top of both the Business Risk Register and the Safety & WHS Risk Register. Every tradie who opens either register now sees, before anything else: "Take this to your accountant and business advisor." The strip links directly to the /accountants page. This is the bridge — every register session is now a prompt to have the conversation with their financial advisor.

• "Speak to your Accountant and Business Advisor" panel in the Business Risk Register — a collapsible section below the score summary strip explaining in plain tradie language: why identifying business risks matters; how a risk register functions as a due diligence document for banks, buyers, and insurers; the Small Business CGT Concessions (15-year exemption and active asset reduction) and why starting the conversation at 35 instead of 54 changes everything; the recommendation to review the register with their accountant every year at tax time; and three specific questions to ask their advisor. The accountant CTA at the bottom links to /accountants.

Platform Pricing Language — "Permanently Free" Removed

The words "permanently free" have been removed from all user-facing pages and replaced with "free" or "free for licenced tradies with an active ABN."

Why: Tradies Bio® is free today for every licenced tradie with a current trade licence and a valid ABN. That commitment is genuine and it is the right way to build trust and market share going into the 30 June 2026 launch. However, the word "permanently" would close the door on a future pricing decision — a subscription tier, a premium feature, or a partnership model — that the business may reasonably choose to offer one day. Removing "permanently" does not reduce the current offer by a single dollar. It simply does not make a promise on behalf of a future business that has not yet been faced with those choices. The platform says what it does today. The future says what it does then.

Strategic Philosophy — The Win-Win Partnership with Accountants and Business Advisors

Tradies Bio® is not a Xero. It is not a MYOB. It is not a job costing package or an accounting system. Those tools have their place — and the right accountant will already have them covered for each client.

What Tradies Bio® is: a marketing and business-building platform, free for every licenced tradie with an active ABN. It gives every tradie the tools to be found, to be trusted, and to convert that trust into calls, jobs, and long-term customers — without an agency, without a monthly retainer, without technical knowledge. The Tradies Bio® AI Co-Pilot handles administration on the job, during the working day, so that when the tradie parks the ute, puts the keys down, and walks through the front door — the quotes are done, the emails are sent, the follow-ups are out. The administration is finished. It is family time. No more after-hours quoting. No more chasing money at 9pm. Time recaptured.

The long game: Every trade business is an asset. Most tradies don't realise this until it is too late to do anything about it. A business that is documented, structured, and run properly — with licences current, insurance filed, risks identified, mitigations in place — is a business worth selling. And in Australia, a business worth selling can be a business sold tax-free under the Small Business CGT Concessions, provided the structure was set up correctly and the conversations with a business taxation accountant happened early and regularly.

The three-way win — tradie, accountant, Tradies Bio®:

Tradies Bio® makes the documents. The accountant makes the strategy. Every time a tradie opens their risk register, their compliance vault, or their business tools on Tradies Bio® — Tradies Bio® directs them back to their own taxation and business advisor. Not a generic suggestion. A specific, direct recommendation to work with the advisor they already know and trust.

The tradie wins: professional tools, AI Co-Pilot, documented business, family time recaptured.

The accountant wins: better-prepared clients who arrive with documents already in order; an annual risk register review that drives a high-value strategic conversation every tax season; the Small Business CGT Concessions conversation starting earlier — when it still counts; and a platform that names the accountant's role at every step and sends every tradie back to their own advisor.

Tradies Bio® wins: by doing right by everyone in the network. The accountant who refers a tradie is giving that tradie a tool that makes them a better business owner and a better client. Tradies Bio® is a safe pair of hands — never competing with accounting or advisory practices, never reaching into a client relationship that belongs to someone else. When an accountant asks their tradie client "are you on Tradies Bio®?" — that question is the marketing. That introduction is the growth strategy.

This is recorded here as a founding principle of the Tradies Bio® platform. It is not a marketing phrase. It is the way the business is built.

---

[2.2.0] — 2026-05-21

Added

• Business Risk Register — a comprehensive business-risk management tool, accessible directly under My Business in the dashboard sidebar (below Share My Bio). Covers 15 risk categories listed in alphabetical order: Cash Flow & Financial Risks · Client & Stakeholder Communication · Compliance — Laws & Regulatory · Compliance — Licences & Registrations · Equipment & Vehicle Maintenance · Health, Safety & WHS · Insurance · Knowledge Management & Training · Legal & Contractual · Operational — Suppliers & Subcontractors · Penalties & Fines · Personnel & Staff · Reputational · Risk to Others — Third Party / Public Liability · Technology & Data Security. Each risk records pre-mitigation likelihood × consequence rating, controls already in place, a required mitigation action with assigned owner, a user-set post-mitigation residual rating, status (Open / In Progress / Closed), and a review date. 15 pre-seeded starter risks aligned to Australian trade business realities are available at one click. Identifying a risk is step one — having an active mitigation strategy for every identified risk is what protects the business, its people, and its clients.
• Safety & WHS Risk Register — a workplace hazard management register modelled on the NSW WHS Act 2011 and NSW SafeWork requirements, accessible under NSW Safety Pack → S — Safety in the dashboard sidebar alongside the SWMS Builder. Covers 12 WHS hazard categories listed in alphabetical order: Confined Spaces · Electrical Hazards · Environmental Conditions · Falls from Height · Fire & Emergency · Hazardous Substances · Manual Handling & Ergonomics · Mental Health & Psychosocial · Plant, Equipment & Tools · Subcontractor & Visitor Safety · Traffic & Vehicle Movement · Working Near Utilities. Every hazard records: pre-mitigation likelihood × consequence rating (E / H / M / L), controls already in place, a required mitigation action, a responsible owner, and a user-set residual rating after controls are applied. 12 pre-seeded starter risks covering the most common hazards in Australian trade work are available at one click. Risk assessment alone is not enough — a documented mitigation strategy for every identified hazard is what turns a safety register into a living tool, not a compliance checkbox.
• Risk matrix — both registers use a standard 4×4 likelihood × consequence matrix (Low / Medium / High / Extreme on each axis) producing automatic E / H / M / L ratings, colour-coded red / orange / yellow / green throughout both registers and all printed documents. Pre-mitigation and post-mitigation residual ratings are displayed side-by-side on every risk card so the risk-reduction story is visible at a glance.
• Tradies Bio® standard colour palette applied to risk register report pages — all risk register pages now use the platform-standard sky-blue / orange / charcoal design system, consistent with the Tradies Bio® changelog and the established platform visual standard.

---

Platform Milestone — Systems Integration Day — 20 May 2026

By Stephen Pearce — Founder, Tradies Bio®

---

A Turning Point

Today is a turning point for Tradies Bio®. Not because of a single feature — but because of what happens when the right systems are wired together and working as one. Every thread we have been pulling on individually came together today: the CRM confirmed, the voice interface confirmed, the video showcase added, the platform hardened and verified end-to-end.

This entry records every change made on 20 May 2026, the reasoning behind each, and the benefit to the platform and to every tradie who joins it.

---

HubSpot CRM — End-to-End Confirmed ✅

What changed: The full signup-to-CRM pipeline was tested, verified, and confirmed working end-to-end against the correct HubSpot portal (443181696 — TradiesBIO, Stephen's account).

How it works:

Every time a tradie completes the Tradies Bio® signup form, the platform automatically:

1. Re-verifies their ABN against the Australian Business Register (server-side — cannot be bypassed)
2. Creates a contact record in HubSpot 443181696 with: business name, email, phone, trade type, ABN and ABR-verified entity name, Bio page URL, lead status NEW, and signup timestamp
3. Fires an admin alert email to Stephen Pearce (stephenp@tradiesbio.au) and Ken Hall (knhall6@gmail.com) with full tradie details
4. Sends a welcome email to the tradie with their Bio link, three setup steps, AI Co-Pilot introduction, and Facebook follow prompt

All four steps confirmed firing correctly and landing as intended. HubSpot portal ID 443181696 confirmed as the authoritative account (TradiesBIO — logged in as Stephen Pearce).

What was also fixed today:

• The /admin/hubspot-test endpoint was upgraded. It now calls HubSpot's /integrations/v1/me endpoint to verify which portal the current token belongs to — returning a clear ✅ CORRECT or ❌ WRONG PORTAL result. This means any future token issue will be diagnosed in seconds, not hours.
• The old incorrect portal ID (40015887 — a legacy account) was removed from all references. Only 443181696 is used throughout the codebase.

The benefit: Every tradie who joins Tradies Bio® from this moment forward is automatically in the CRM on the day they sign up — with their verified ABN, trade type, and lead status. No manual entry. No missed contacts. The admin team is notified immediately. The tradie is welcomed immediately. The system runs itself.

---

Voice Assistant Integration — "Hey Siri, Tradies Bio®" / "Hey Google, Tradies Bio®"

What changed: Tradies Bio® introduced a formal voice shortcut system that allows any tradie to open their Co-Pilot hands-free — directly from their phone, while on the tools, without unlocking their screen.

How it works — iPhone (Siri):

1. The tradie goes to Edit Profile → Voice Key Setup
2. They tap "Create My Siri Key" — this opens iOS Shortcuts automatically
3. They record their own phrase: "Hey Siri, Tradies Bio®"
4. From that moment on, saying "Hey Siri, Tradies Bio®" anywhere — on site, in the ute, hands covered in plaster — opens their Tradies Bio® Co-Pilot instantly

How it works — Android (Google Assistant):

1. The same setup path applies
2. The tradie records: "Hey Google, Tradies Bio®" as their trigger phrase
3. Google Assistant opens the Co-Pilot page on their device

Why the exact phrase matters:

The trigger phrase was deliberately standardised as "Hey Siri, Tradies Bio®" (not "Co-Pilot", not "Tradies" alone). This matters because Apple's native assistant is also called Co-Pilot in some Microsoft integrations — an ambiguous phrase could trigger the wrong app. "Tradies Bio®" is the brand name and is unambiguous on every device.

What was updated across the platform:

• Edit Profile voice section retitled: "Voice Key Setup — Hey Siri / Hey Google" with plain-English explanation (no technical jargon, no mention of "API")
• The setup button renamed: "Create My Siri Key" — one tap, opens iOS Shortcuts directly
• Landing page voice card updated: "Voice-Ready — 'Hey Siri, Tradies Bio®'"
• Admin Procedures Manual updated: Siri section rewritten with the correct call sign, benefit explanation, and step-by-step setup
• Microsoft Copilot naming conflict warning retained — important context for tradies who use Microsoft apps

The benefit: A tradie standing on a roof, operating machinery, or driving between jobs can speak two words and have their Co-Pilot open. They can dictate a supplier order, chase a payment, or draft a review request — without stopping work. This is the hands-free office we promised.

---

Video Showcase — Every Tradie Can Now Show Their Work

What was added: Every tradie's public Bio page now includes a dedicated video section, allowing them to embed a video that showcases their work, their business, their personality, or their trade.

How it works:

• Tradie goes to Edit Profile → Video
• They paste a YouTube or Vimeo link to a video they have already filmed or filmed with their phone
• The video embeds on their public Bio page immediately, visible to every customer who visits their page

What kind of videos tradies are using this for:

• A 60-second tour of completed jobs — kitchen renovation, bathroom retile, new switchboard
• A "meet the tradie" introduction — face to camera, who they are, what they do, where they work
• A timelapse of a full-day job from start to clean-up
• Customer testimonial filmed on a phone at the end of a job
• A walk-through of their truck or tools — showing the quality of their equipment

Why this changes everything for a tradie:

A photo and a star rating tell a customer something. A video tells them everything. They hear the tradie's voice. They see the standard of their work. They see how the job site looks when it is finished. That is not a profile — that is a sales presentation. And it runs 24 hours a day on the tradie's Bio page without the tradie doing anything after the initial upload.

The competitive position: Neither Blinq nor Linktree offers a trade-specific video showcase embedded in a verified professional profile. A tradie's Tradies Bio® page with a video is not comparable to either competitor — it is a different category of tool entirely.

---

Platform Hardening — Domain and Branding Audit

What was cleaned up:

• Three instances of info@tradieshub.au (old/retired domain) in the Privacy Policy were corrected to info@tradiesbio.au
• The admin stale-account check was updated from the old email to stephenp@tradiesbio.au
• The bio card logo placeholder (a broken "?" image) was removed entirely — the Bio card now shows the tradie's name, trade, contact buttons, and enquiry form without a broken image element
• Edit Profile logo section renamed "Your Photo or Logo" with a clear note explaining where the image appears (quotes and invoices — not the public Bio card)

Why this matters: Every page a customer or a tradie sees is a brand touchpoint. A broken placeholder image, an old email address, or a wrong domain is not a minor detail — it is a signal about the care taken in building the platform. These were fixed before launch.

---

Competitive Analysis — Updated 20 May 2026

Supersedes the 18 May 2026 comparison. Updated to include Video Showcase.

Tradies Bio® vs Blinq vs Linktree — Full Feature Comparison

Feature	Tradies Bio®	Blinq	Linktree
Public Bio / profile page	✅	✅	✅
QR code	✅	✅	✅
NFC card (tap card to phone)	✅ Stephen provides each tradie a programmed NFC card	✅	❌
Google Review link on Bio	✅	❌	❌
Video showcase — embed work/intro video on Bio	✅ NEW — 20 May 2026	❌	❌
ABN verification — live ABR lookup	✅	❌	❌
Only verified Australian businesses admitted	✅	❌	❌
Customer enquiry / lead capture form	✅	❌	❌
Enquiries dashboard — manage leads	✅	❌	❌
Compliance Vault — licences, insurance, certs	✅	❌	❌
Tradies Bio® AI Co-Pilot	✅	❌	❌
Hands-free voice — "Hey Siri, Tradies Bio®"	✅	❌	❌
Supplier-aware — draft order emails by name	✅	❌	❌
Office BCC — keep admin in the loop	✅	❌	❌
Google Business Profile setup assistance	✅	❌	❌
HubSpot CRM — auto-sync every signup	✅	❌	❌
Built specifically for Australian tradespeople	✅	❌	❌
Phone-to-phone NFC tap	❌ Requires native app — not planned	✅	❌
Lock screen widget	❌ Requires native app — not planned	✅	❌
Apple/Google Wallet card	❌ Parked — review Sept 2026	✅	❌

The positioning — unchanged and strengthened:

Linktree and Blinq solve one question: how do I share my contact details?

Tradies Bio® solves the business: verified identity, lead capture, compliance management, AI assistance, video presence, voice access, and automatic CRM. That is not a feature comparison — it is a different category.

Every feature Blinq and Linktree offer that Tradies Bio® does not (phone-to-phone NFC, lock screen widget) requires a native app. That is a deliberate architecture choice — not a gap. The web platform is intentional. It works on every device, requires no app download, and cannot be deleted from a home screen by a customer update.

---

Summary — What 20 May 2026 Means for the Platform

System	Before today	After today
HubSpot CRM	Assumed working — unconfirmed	End-to-end confirmed ✅ — portal 443181696, contact push verified
Voice interface	Built but inconsistently described	Standardised — "Hey Siri, Tradies Bio®" everywhere, plain-English setup
Video showcase	Not available	Live — every tradie can embed their work video on their Bio page
Platform copy	Old domain references in Privacy Policy	All corrected — tradiesbio.au throughout
Bio card	Broken logo placeholder showing "?"	Removed — clean card, no broken elements
HubSpot test tool	Showed contact count only	Now shows portal ID with ✅/❌ — instant diagnosis

30 June 2026 launch is confirmed. The platform is ready.

---

Stephen Pearce
Founder — Tradies Bio®
20 May 2026

---

Competitor Review — Tradies Bio® vs Blinq vs Linktree — 18 May 2026

By Stephen Pearce — Founder, Tradies Bio®
Action: Review by administrators — 30 June 2026

---

Decision: No further features to be built in response to Blinq or Linktree

Tradies Bio® has reviewed its platform positioning against the two most visible competitors in the digital profile/card space — Blinq and Linktree. This entry records the assessment, confirms the strategic direction, and closes the question of competitor feature-chasing ahead of the 30 June 2026 launch.

---

What Blinq and Linktree Are

Linktree is a generic link-in-bio tool. It allows anyone — musicians, influencers, small businesses — to publish a page of links. It has no industry focus, no lead capture, no compliance, and no AI. Its audience is anyone with a social media presence.

Blinq is a digital business card platform. Its flagship feature is phone-to-phone NFC sharing — you tap your phone to another phone and your contact details transfer. It also offers lock screen widgets and Apple/Google Wallet cards. It is a horizontal product with no trade, compliance, or AI features.

---

The Honest Comparison

Feature	Tradies Bio®	Blinq	Linktree
Public Bio / profile page	✅	✅	✅
QR code	✅	✅	✅
NFC card (tap card to phone)	✅ Included — Stephen provides programmed NFC card to each tradie	✅	❌
Google Review link on Bio	✅	❌	❌
ABN verification — live ABR lookup	✅	❌	❌
Only verified Australian businesses admitted	✅	❌	❌
Customer enquiry / lead capture form	✅	❌	❌
Enquiries dashboard — manage leads	✅	❌	❌
Compliance Vault — licences, insurance, certs	✅	❌	❌
Tradies Bio® AI Co-Pilot	✅	❌	❌
Hands-free voice command on the tools	✅	❌	❌
Supplier-aware — draft order emails by name	✅	❌	❌
Office BCC — keep admin in the loop	✅	❌	❌
Google Business Profile setup assistance	✅	❌	❌
Built specifically for Australian trades	✅	❌	❌
Phone-to-phone NFC tap	❌ Requires native app — not planned	✅	❌
Lock screen widget	❌ Requires native app — not planned	✅	❌
Apple/Google Wallet card	❌ Parked — review Sept 2026	✅	❌

---

Why We Are Not Chasing Their Features

Phone-to-phone NFC tap requires a native iOS/Android app. It is not achievable in a web platform without significant investment. More importantly, Tradies Bio® already solves the same customer problem — the tradie gives their customer a programmed NFC card that opens their Bio page instantly in any browser on any smartphone. The outcome is identical. The card does not require the customer to have an app, a Blinq account, or a compatible phone model.

Lock screen widget also requires a native app. Not planned.

Apple/Google Wallet has been reviewed and parked. Review date: September 2026.

---

The Positioning Statement — Confirmed

Linktree and Blinq solve one question: how do I share my contact details?

Tradies Bio® solves a different set of problems that Blinq and Linktree cannot touch:

• Verified identity — only ABN-verified Australian businesses are admitted. Customers know they are dealing with a legitimate, registered trade business.
• Lead capture — customers can submit a job enquiry directly from the Bio page. No email app, no phone dialling.
• Compliance management — licences, insurance, and registrations stored and tracked with expiry alerts.
• Business operations — the Tradies Bio® AI Co-Pilot drafts quotes, chases payments, orders from suppliers, and replies to customers — hands-free while the tradie is on the tools.

We have plenty across our bow. The launch story is already strong.

---

Administrator Action Required — 30 June 2026

On or immediately after launch date (30 June 2026), the admin team (Stephen Pearce, Daniel Pearce, Ken Hall, Steve Wells, Phil Sullivan) to review:

1. Has the competitor landscape changed materially?
2. Are tradies requesting any features that Blinq or Linktree offer?
3. Does Apple/Google Wallet warrant moving from Parked to Active?
4. Confirm or update this positioning for the next planning cycle.

---

Strategic Decision — ChatGPT vs Gemma 4 — 14 May 2026

By Stephen Pearce — Founder, Tradies Bio®

---

AI Co-Pilot Engine Review — GPT-4o Confirmed, Gemma 4 Assessed

With the release of Google's Gemma 4 open-weights model, Tradies Bio® has reviewed its AI Co-Pilot engine decision. This entry records the assessment and confirms the current direction.

---

What Is Gemma 4?

Gemma 4 is Google's latest open-weights AI model — meaning the model weights are publicly released and can be run on your own infrastructure rather than consumed through a hosted API. This is technically distinct from GPT-4o, which is OpenAI's flagship hosted API model.

---

The Assessment

Factor	GPT-4o — Current Choice	Gemma 4
Business writing quality	Leads. Emails, quotes, and follow-ups read like a professional wrote them.	Very capable — optimised for speed and lean deployment, less depth in business writing.
Australian English and trade context	Deep real-world training. Handles ABN, GST, WHS, trade terminology, and Australian business culture naturally.	Competent but less depth in Australian-specific business language.
Plain English for tradies	Outstanding — warm, direct, human-sounding. The quality that makes tradies reach for the Co-Pilot again the next day.	Good, but GPT-4o still leads for this specific register.
Cost model	Pay per API call. Very small per conversation at current scale.	Potentially cheaper via Google AI Studio API, or free if self-hosted.
Hosting flexibility	OpenAI-hosted only.	Open weights — can be run on own infrastructure, which is a genuine future option at scale.
Name recognition with tradies	"ChatGPT" is the word the market knows. Trust is built in at zero cost.	"Gemma" is not yet a household name in the Australian trades.
Reliability	Rock solid. OpenAI has operated at production scale for years.	Solid but still maturing as a commercial offering.

---

The Reasoning

The writing quality is the product.

The Tradies Bio® AI Co-Pilot is only valuable if the output — the emails, the quotes, the supplier orders, the review requests — reads like something a professional wrote. GPT-4o consistently delivers that. It is warm, direct, and confident in a way that makes tradies trust the output and use it as-is. That quality is the foundation of Co-Pilot adoption.

Gemma 4's real advantage is for a different problem.

Gemma 4 is genuinely compelling for teams who need to reduce API costs at scale or who want to host their AI privately for data-sovereignty reasons. That is a real future consideration for Tradies Bio® if the platform reaches thousands of active daily Co-Pilot users and API costs become a meaningful line item. It is not the right trade-off today.

The architecture protects us.

The Tradies Bio® Co-Pilot was deliberately built so the AI engine is one interchangeable component. The tradie's data — vault, suppliers, profile, history — is completely separate. Switching from GPT-4o to Gemma 4 (or any other model) is a half-day task. We are not locked in. We are not at risk. This decision can be revisited at any time without disruption to tradies.

---

Decision

Stay with GPT-4o.

Confirmed review dates:
- 30 June 2026 — CONFIRMED — Full AI platform review. Assess GPT-4o performance across all active tradies: Co-Pilot usage rates, quality of output, cost per conversation, and whether any new model (Gemma 4, Claude, or other) has materially closed the gap in business writing quality for Australian tradies. Decision to stay or switch made at this date.
- 30 September 2026 — Pricing and commercial model review. AI cost contribution to platform operating costs assessed alongside subscription conversion rates.

---

This decision is documented not because it is permanent, but because it is deliberate. Every decision at Tradies Bio® is made with reasoning, recorded with clarity, and open to revision when the evidence changes.

Stephen Pearce
Founder — Tradies Bio®
14 May 2026

---

Brand Milestone — Clean T-Mark Adopted — 14 May 2026

By Stephen Pearce — Founder, Tradies Bio®

---

Official T-Mark — Clean, Original, Fully Protected

Effective 14 May 2026, Tradies Bio® adopts the clean geometric T-mark as the sole official logo mark across the entire platform.

The T-mark features:

• A bold geometric orange T with a swept flat crossbar extending right
• A curved interior cutaway that conveys forward movement and precision
• Fully transparent background — works on any surface, dark or light
• 100% original design — no similarity to any third-party registered mark

This decision was made deliberately to ensure Tradies Bio® builds its brand on a foundation that is entirely its own. No borrowed elements. No IP risk.

Applied across:

• Site-wide navigation header — every page of the platform
• All outgoing emails — welcome, enquiry notifications, admin alerts, Co-Pilot confirmations
• The public changelog — this record reflects the brand as it stands from this moment forward

---

Stephen Pearce
Founder — Tradies Bio®
14 May 2026

---

Partnership Milestone — Bunnings API Developer Application — 11–15 May 2026

By Stephen Pearce — Founder, Tradies Bio®

---

Bunnings PowerPass API — Developer Licence Application

Between 11 and 15 May 2026, Tradies Bio® will take a significant step forward in its value proposition for Australian tradespeople: a formal application for a Bunnings API Developer Licence (PowerPass integration).

This milestone marks the first major commercial partnership pursuit for the platform.

---

The Meeting

Stephen Pearce (Founder, Tradies Bio®) and Ken Hall will meet on site at Bunnings Kirrawee to introduce Tradies Bio® and present our intentions directly to the Bunnings team.

The meeting will serve two purposes:

1. Introduction — To put faces to the application and establish a working relationship with the Bunnings partnership team
2. Application — To formally lodge the request for API Developer access to the Bunnings PowerPass system

This is a face-to-face meeting by design. Tradies Bio® is a platform built on trust and relationships — and that is exactly how we intend to begin this one.

---

What We Are Proposing

The integration we are building would allow tradies on the Tradies Bio® platform to:

• Order directly from Bunnings through their existing PowerPass trade account, without leaving the Tradies Bio® platform
• Streamline materials purchasing — a tradie can go from job notes in their Co-Pilot to a Bunnings order in minutes
• Maintain their PowerPass benefits — trade pricing, account management, and purchase history all preserved

For Bunnings, this represents a direct channel to tens of thousands of registered Australian tradespeople through a platform built exclusively for the trades. Tradies Bio® is not a generic business tool — it is the platform these customers use every working day.

---

Why This Matters

The Tradies Bio® platform currently supports tradies with their digital presence, compliance documentation, AI assistance, and customer enquiries. A Bunnings PowerPass integration closes the loop on the commercial side of a tradie's working day — connecting the jobs they quote, the materials they need, and the supplier they trust most.

Bunnings is Australia's most trusted trade supplier. Tradies Bio® is building Australia's most trusted tradie platform. This partnership is a natural fit.

---

Timeline

Date	Action
11–15 May 2026	On-site meeting at Bunnings Kirrawee — Stephen Pearce and Ken Hall
11–15 May 2026	Formal API Developer Licence application lodged
TBC	Developer access granted and integration development begins
TBC	PowerPass ordering feature available to all Tradies Bio® members

---

Stephen Pearce
Founder — Tradies Bio®
May 2026

---

Founding Document — 2 May 2026

By Stephen Pearce — Founder, Tradies Bio®
Trademark Registration No. 2408794

---

The Story Behind Tradies Bio®

This platform exists because of a man named Steve Wells.

Steve is a civil trade-qualified plumber. Over a lifetime on the tools, he built a reputation the way every honest tradie does — through hard work, turning up on time, and doing the job right. Like most tradies, Steve never had a marketing team behind him. He had his skills, his word, and his reputation. That was his brand.

For years, businesses approached tradies like Steve with promises — more leads, better visibility, a stronger profile online. The fees were real. The results rarely were. Tradies are exhausted enough without being let down by people who don't understand what they actually do or what they actually need.

That injustice is what started Tradies Bio®. The idea is simple: the trade is the brand. A tradie doesn't need an agency. They need their credentials on display, their licences accessible, their reviews working for them, and a system that runs quietly in the background while they're on the tools.

Steve has believed in this from day one. So has Ken Hall, whose support — practical and personal — has never wavered. They both know the years that went into getting here. The conversations, the false starts, the versions that almost worked.

---

The Journey

Before Replit, there was Nurul.

Nurul was a contractor based in Bangladesh — a hard-working developer engaged at an agreed rate of $25 per hour, with a weekly cap of $300. Over two years, three websites were built. Real progress was made. Real lessons were learned — about communicating across time zones, across languages, across entirely different cultural contexts. Nurul worked with genuine dedication, but a tradie's world is specific. The language of licences and compliance, of utes and site managers, of White Cards and Public Liability — these are not things easily translated from the other side of the world.

In total, approximately $15,000 was invested in that chapter. It funded the foundations of the vision, even if the vision itself remained just out of reach.

That investment was not wasted. It taught exactly what Tradies Bio® needed to be.

---

2 May 2026 — The Window Opens

On 2 May 2026, Replit marked its 10-year anniversary. As part of that celebration, a 24-hour window was offered — and in that window, what had taken two years and $15,000 to partially build was built properly, from the ground up, in a single day.

In one day:
- A private compliance vault — the Under-Carriage — where every licence, insurance policy, and certification is stored securely and privately
- A professional public bio page, shareable by QR code, NFC sticker, or direct link
- A full enquiry CRM so no lead is ever missed
- The physical-to-digital sharing suite — print-ready QR codes, vCard downloads, NFC instructions
- The Tradies Bio® AI Co-Pilot — introduced and branded, ready to become the most powerful tool a tradie has ever had access to

What Nurul tried to build across two years, Replit made possible in 24 hours. That is not a criticism of Nurul — it is a testament to how much the tools have changed.

---

The People Behind This

Steve Wells and Ken Hall were there from the beginning. They understood the mission before there was a platform to show them.

Phill Sullivan — whose perspective operates at a high level — is someone whose involvement, when the time is right, will add an important dimension to where Tradies Bio® is heading.

My son, based in Kamloops, Canada, has been a constant source of support for both Tradies Bio® and a parallel project around e-bikes. His belief in what we are building means more than he probably knows.

To all of them: thank you. This is the foundation we are building on together.

---

The Vision

Tradies Bio® is not a marketing system. It is not a CRM. It is not another agency asking for a monthly retainer.

It is a foundation — and the deeper the foundation, the higher the building.

The goal is to give every tradie in Australia the tools to:

• Be found — professionally, credibly, on their own terms
• Stay compliant — with every licence and insurance tracked and reminded automatically
• Never miss a lead — the AI Co-Pilot handles enquiry replies while they're on the tools
• Build their reputation — through authentic Google reviews, NFC-enabled customer handoffs, and a bio page that works 24 hours a day
• Recapture their time — for the people who matter, not for admin that doesn't
• Build genuine business wealth — so that one day, they can step off the tools, sell their business as a going concern, and retire on what they built

Tradies Bio® has strategies for all of this. Some are built. More are coming.

But the most important thing — the thing that makes this different from every agency and every platform that came before — is this:

Tradies Bio® is on the tradie's side. Full stop.

---

Stephen Pearce
Founder — Tradies Bio®
2 May 2026

---

Founder's Note — 7 May 2026

By Stephen Pearce — Founder, Tradies Bio®

---

We Are Building Something Special

Every tool in this platform exists for one purpose.

Not a marketing metric. Not a conversion rate. Not a user acquisition target.

Every feature — the AI Co-Pilot, the NFC card moment, the Compliance Vault, the Google Review card, the supplier email, the public bio — every single one of them serves the same outcome: a tradie who works smarter, earns more, spends less time stressed, and gets home to their family in a better state of mind.

That is the measure. That is the only measure that matters.

---

The Heart of Why This Was Built

AI is in the hands of tradespeople now. Not at some future date. Right now.

And that changes everything — the way they think, the way they act, the way they interact with their business, their customers, their suppliers, and their families.

For generations, tradies have been underserved by the professional world. Accountants, lawyers, and financial planners have held the knowledge, and knowledge has always been power. That equation is shifting. Tradies Bio® puts AI access at every tradie's fingertips — and you do not even have to stop working to use it. You can be on the tools, making money, and just speak into Tradies Bio® and get answers. Draft a supplier order. Write a quote follow-up. Get plain-English advice on a business decision. Understand a contract clause. Know your rights.

Things that used to require a $300-an-hour professional can now happen in thirty seconds on a phone screen while the job is still running.

This is not a small thing. There has never been a better time in a lifetime to build a business. The tools exist. The access exists. The intelligence exists.

But it has to be built on integrity — not shortcuts. Offering genuine value to customers. Showing up. Doing the job right. Being the kind of tradie that earns a review because they deserve one.

Tradies Bio® is the platform for that tradie. The one who means business.

We have a great deal under the hood. Features planned, strategies mapped, capabilities that tradies have not yet imagined needing. And we have only just started.

---

The People Who Made This Possible

No platform is built alone. These are the people who stood beside this from the beginning:

Ken Hall — steadfast, practical, and personally invested. His support has never wavered and his presence in this project is felt at every step.

Steve Wells — the tradie whose story started everything. A civil trade-qualified plumber whose career is the living proof of why this platform had to be built. Steve was there before there was anything to show, and he has believed in it every single day since.

Mark Summit — whose insight and encouragement have been a genuine source of strength at the moments that mattered.

Daniel Pearce — my son. Based in Kamloops, Canada, and never more than a conversation away. His belief in what we are building means more than he probably knows — and that is the kind of fuel that keeps a founder moving on the hard days.

To all of them: this record exists so that when Tradies Bio® is what it is going to become, these names are in the foundation.

---

Stephen Pearce
Founder — Tradies Bio®
7 May 2026

---

Strategic Decision — 8 May 2026

By Stephen Pearce — Founder, Tradies Bio®

---

Why We Chose ChatGPT Over Google Gemini as Our AI Agent

This entry exists to record a deliberate, considered decision — not a default. When building the Tradies Bio® AI Co-Pilot, a choice had to be made about which AI engine would power it. The two leading candidates were ChatGPT (GPT-4o) by OpenAI, and Gemini by Google.

We chose ChatGPT. Here is why — and why it was the right call.

---

The Decision at a Glance

Factor	ChatGPT (GPT-4o) — Our Choice	Google Gemini
Track record	The most widely used AI in the world. Years of real-world use at scale.	Powerful, but newer to this type of practical business use.
Plain English writing	Outstanding. Emails, quotes, and follow-ups that read like a professional wrote them.	Very good — improving rapidly, but GPT-4o leads in business writing quality.
Australian context	Handles Australian English, ABN, GST, trade terminology, and local business culture naturally.	Capable, but GPT-4o has deeper real-world training data at this point in time.
Reliability	Rock solid. OpenAI has operated at production scale for years with minimal downtime.	Solid infrastructure, but publicly had more teething issues in its early commercial phase.
Name recognition	When an Australian tradie hears "AI," they think ChatGPT. That familiarity builds trust.	Growing fast, but ChatGPT is still the name the market recognises.
Cost model	Pay per use — charged per message sent. Very small per conversation.	Similar pay-per-use model at comparable rates.

---

The Reasoning

Tradies trust what they know.

The Tradies Bio® Co-Pilot is only valuable if tradies use it. Adoption matters as much as capability. When a tradie hears that their Co-Pilot runs on ChatGPT — the same AI their kids talk about, the same one they have seen on the news — it removes hesitation. They already believe it works. That is a marketing and trust advantage that cannot be underestimated at launch.

Plain English is everything in this business.

A tradie asks the Co-Pilot to chase a late invoice. The reply has to sound professional — not robotic, not corporate, not written by a machine. GPT-4o consistently produces emails and responses that sound human, warm, and direct. That quality is what makes tradies reach for the Co-Pilot again the next day. It is not a small thing.

The architecture makes switching painless if needed.

This is important for long-term confidence: the Tradies Bio® Co-Pilot is built so that the AI engine is one interchangeable component. The tradie's data — their vault, their suppliers, their profile — is completely separate. If Google Gemini pulls ahead in two years, the switch is a half-day task. Think of it as swapping the brand of globe in a light fitting. The house wiring, the switch on the wall, the fitting itself — none of that changes. This was a deliberate architectural choice made upfront. It means we are not locked in, and we are not at risk.

We are not closed to Gemini. We are open to the best.

This is not an anti-Google position. Google is a world-class company and Gemini will continue to improve. The decision to use ChatGPT today is based on where the tools stand right now — at launch, in May 2026, for an Australian tradie audience. If the landscape shifts, Tradies Bio® shifts with it. That flexibility is baked in.

---

What This Means for Tradies Bio®

The AI Co-Pilot is the most powerful feature in this platform. It is the one that changes how a tradie lives their working day. Choosing the right engine to power it — the one with the best writing, the deepest training, and the widest trust — was a strategic decision that affects every tradie who signs up.

GPT-4o was the right choice. It is the right choice today.

This decision is recorded here so that the reasoning is permanent, accessible, and understood by everyone who is part of building this platform.

---

Stephen Pearce
Founder — Tradies Bio®
8 May 2026

---

[2.1.0] — 2026-05-07

AI for the Tradie — The Future

---

Tradies Bio® AI Co-Pilot — Supplier Ordering (Send Direct)

The Co-Pilot can now send a trade order email directly to a saved supplier in one tap — no copy-paste, no switching apps.

How it works:
- The tradie taps 📧 Email a Supplier from the dashboard or Co-Pilot
- Co-Pilot asks what they need and drafts a professional trade order email automatically
- Below the reply, a Send to [Supplier] button appears for each saved supplier
- One tap fires the email — supplier receives it from hello@tradiesbio.au with Reply-To set to the tradie's own email, so the supplier's reply lands directly in the tradie's inbox
- Button confirms ✅ Sent, with a gold tip: "[Supplier] will reply directly to your email — check your inbox."
- If no suppliers are saved, a quiet prompt links to Edit Profile to add them

Supplier hint bar: When entering supplier mode, a orange-bordered notice confirms suppliers are ready and explains the one-tap flow before the tradie even types a word.

Supplier system prompt: Co-Pilot is aware of all saved suppliers (name + email) and references them by name when drafting order emails.

Email signature: Every supplier email includes the tradie's business name, phone number, and ABN — professional, complete, no extra effort from the tradie.

---

Saved Suppliers — Up to 3 per Tradie

Tradies can save up to three trade suppliers (name + email) in Edit Profile under My Suppliers. These are stored on the tradie's account and available to Co-Pilot across all sessions.

---

Google Business Profile — Strategic Decision

After careful consideration, the Google Business Profile (GBP) question has been removed from the tradie-facing dashboard entirely. Tradies are not asked about their GBP — this was determined to be too difficult and unreliable as a self-reported answer.

The admin approach instead: Stephen Pearce's team identifies each tradie's GBP status externally — via ABN lookup, their website, and a Google search — then records it via HubSpot. The GBP database fields (gbp_status, gbp_listing_url) are retained silently for admin use.

Phase 15 roadmap — Google Places API: Post-launch, Tradies Bio® will integrate the Google Places API to look up each tradie's GBP automatically using their business name and suburb (from their ABN and signup data). If a listing is found, the Google Review button on their public bio becomes a direct one-tap review link (using the Google Place ID), rather than a generic search. No tradie input required. This is a genuine conversion driver — more reviews, less friction.

---

HubSpot CRM — GBP Status Sync

HubSpot contact records are updated with a readable GBP status label whenever the admin sets a tradie's GBP status:
- Has GBP — Active — for tradies with a confirmed Google Business Profile
- No GBP — Setup Email Sent — for tradies without one, who have been sent the setup guide

Admin tradie list shows a 📍 GBP column for at-a-glance status visibility.

---

Launch Confirmed — 30 June 2026

Launch date confirmed by Stephen Pearce. Pilot tradie onboarding planned prior to launch to validate the full signup-to-dashboard flow in a real-world setting.

---

[2.0.0] — 2026-05-05

Added

• Platform Launch — 5 May 2026 — Tradies Bio® is officially open for business. The platform is live at tradiesbio.au, fully operational, and ready to onboard Australian tradies. This milestone marks the transition from development into the real world.
• Administrator Team Onboarded — Five administrators were granted access to the Tradies Bio® Admin Panel on 5 May 2026. The team comprises two Super Administrators — Stephen Pearce (Founder) and Daniel Pearce — and three Administrators: Steve Wells, Ken Hall, and Phil Sullivan. Each received a personally addressed invitation email with login instructions, a step-by-step guide to the Admin Panel, and a briefing on how Tradies Bio® compares to and surpasses competitors Treelink and Blinq. Admin access is via the private login at tradiesbio.au/auth.
• Free Tradie Access Launched — The free offering is live. Every Australian tradie who signs up before 1 January 2027 receives full platform access at no cost — Bio App, QR code, Compliance Vault, Enquiry Dashboard, and AI Co-Pilot — with no credit card required. The $9.99/month subscription activates from 1 January 2027 for those who choose to continue.
• First Tradie Supporters on the Platform — Two tradies who backed Tradies Bio® from the start are now live on the platform:
• Mac MS — Mobile Automotive Services — one of the first tradies to believe in the vision and come on board.
• Steve Wells — AWS Drains — the man whose story inspired this platform, now registered and live. Steve is a civil trade-qualified plumber whose career is the embodiment of everything Tradies Bio® was built to support.
• HubSpot CRM Integration — Code Complete — Every new tradie sign-up and profile update now automatically pushes a contact record to HubSpot CRM, mapping email, phone, business name, trade type, service area, ABN, public bio URL, and lifecycle stage. Integration is code-complete and activates the moment the HubSpot Private App token is configured.
• AI Co-Pilot — Model Corrected — The AI Co-Pilot was updated to use gpt-4o, replacing an invalid model reference. The Co-Pilot is fully operational for admin users and selectively enabled tradies, with a personalised system prompt built from each tradie's vault data, trade type, and service area.

---

[1.9.0] — 2026-05-05

Changed — Pricing Strategy: Free Entry to Market

Effective 5 May 2026 — reviewed 30 September 2026 — subscription activates 1 January 2027.

Tradies Bio® enters the market with a free-first strategy, directly competing with Linktree and Blinq for the Australian tradie audience. This decision reflects the reality that you cannot compete with "Free" by charging $350–$550 upfront. The free period is a deliberate land-grab — get tradies live, get them using the platform, and convert them to paid subscribers when the subscription model activates on 1 January 2027.

• Free tier introduced — All new registrations receive full platform access at no cost. No credit card. No setup fee. No lock-in. Every feature — Bio App, QR code, Compliance Vault, Enquiry Dashboard, AI Co-Pilot — included from day one.
• Subscription pricing confirmed for 1 January 2027 — $9.99/month. No setup fee. Cancel any time.
• Landing page pricing section updated — Removed all references to the $550 one-time setup fee and $15/month pricing. The new pricing card displays "FREE" as the hero, "Full access — no credit card required," "Everything above, free until 1 January 2027," then "$9.99/month" as the future subscription rate.
• "What's Included" section updated — Subtitle updated to remove "one setup fee" language. CTA button updated to "Get Started Free — No Card Needed."
• FAQ updated — Replaced the "Can I subscribe monthly and cancel?" FAQ with a plain-English "How does the pricing work?" question covering the free period and the January 2027 subscription activation.
• Registration flow updated — New accounts created with subscription_status = "free" to clearly distinguish free-tier members from future paid subscribers.
• Dashboard access updated — Free-tier members have full dashboard access. Subscription paywall will be re-enabled on 1 January 2027.

Strategic rationale: Linktree and Blinq cannot offer what Tradies Bio® offers — trade licence verification, compliance tracking, expiry alerts, and an AI Co-Pilot built for tradies. The free period is the entry wedge. Once tradies are live and dependent on the platform, the $9.99/month conversion in January 2027 becomes a retention play, not a sales play.

Review date: 30 September 2026. Pricing model, conversion rate, and subscription activation date to be reviewed.

---

[1.9.0] — 2026-05-22

Added

• SWMS Digital Signatures — Tap-to-Sign on Any Phone — Workers can now sign the Safe Work Method Statement directly on their phone screen using a finger. Section 13 of the SWMS builder features a full-screen digital signature pad powered by the SignaturePad.js library (v4.2, bundled locally — no CDN dependency). Each signature captures the worker's full name, role/trade, and a server-locked Australian timestamp (dd/mm/yyyy HH:MM) that cannot be altered after saving. Multiple workers supported — "Add Another Signature" adds a new pad for each crew member. Signatures persist to the database and restore automatically if the tab is closed and reopened. Print-ready — saved signature PNGs render cleanly when the SWMS is exported to PDF.
• Mobile-optimised signature canvas — DPR scaling for Retina/iPhone — Canvas sizing is now deferred via requestAnimationFrame so the pad always fills the correct width on first render on mobile (previously the offsetWidth could read zero before DOM layout completed on iOS). Device pixel ratio (DPR) scaling applies automatically — signatures on iPhone 14/15 and other high-DPI screens are crisp, not blurry. A ResizeObserver redraws the canvas on orientation change, preserving any strokes already drawn.
• Apple Shortcuts (Siri) integration — voice-activate the SWMS builder — Tradies can set up a one-time Apple Shortcut to open their SWMS builder with a single voice command: "Hey Siri, Tradies Bio SWMS". A secure 32-byte personal API token is generated from the SWMS page with a single tap, stored on the tradie's account. The Shortcut calls the Tradies Bio® API and deep-links directly into the active SWMS session — no typing, no unlocking, no searching through the app. Works hands-free in the truck, on the scaffold, or with gloves on.
• Shortcut API endpoint — GET /api/v1/shortcuts/active-swms?token=<token> — A token-authenticated JSON endpoint built specifically for Apple Shortcuts. Implemented in the Node.js API Server (TypeScript/Express) sharing the platform's PostgreSQL database. Returns the tradie's business name, the SWMS builder URL, and the deep link to their most recent active SWMS session with session label. Responds with clear, human-readable error messages for missing or invalid tokens.
• Siri strip and token panel on SWMS page — A dark navy instruction strip and a light blue token generator panel appear below the signature section (screen-only, hidden from print). One tap generates the personal token and displays the full Apple Shortcuts URL ready to copy.
• "On-Site Speed" section — public landing page — A new section between the dashboard feature list and the AI Co-Pilot section highlights the Tap-to-Sign and Siri Shortcut features side-by-side. The left card includes a live CSS/SVG mock of the signature pad interface showing exactly what signing looks like. Cards stack to single-column on mobile (responsive auto-fit grid). Both features flagged as included free in every account.

---

[1.8.0] — 2026-05-04

Added

• Tradies Bio® AI Co-Pilot — Landing Page Feature Section — A dedicated full-width section introduced on the public landing page, visually separated from all other content with a near-black background (#1a1a1a) and Safety Orange gradient borders top and bottom. The section carries a prominent NEW ribbon badge, the full Tradies Bio® AI Co-Pilot headline, and six capability cards: Auto-Reply to Enquiries, Compliance Coach, Voice-Activated Business Advisor, Quotes & Invoices & Follow-Ups, Business Strategy on Demand, and Always Getting Smarter. An animated orange pulse dot signals the Co-Pilot is live. CTA links directly to registration. Fully responsive — 3-column desktop, 2-column tablet, single-column mobile.
• AI Co-Pilot — What's Included checklist — The AI Co-Pilot is now listed as the final item in the "Everything Included — Nothing Hidden" pricing section, presented in a highlighted orange-tinted row with a NEW badge to visually separate it from the standard feature list.
• Welcome email — benefits-based language — All 23 feature descriptions in the outbound welcome email rewritten from feature statements to tradie-focused benefit statements. Language is direct, plain Australian English — written from the tradie's point of view, not the platform's. Examples: "Never turn up to a job with a lapsed licence" (Compliance Reminders), "Site manager wants your Public Liability cert right now? Open your phone, tap, done" (Document Download), "Job done — customer scans your QR and leaves a Google review in 30 seconds. More reviews. More trust. More work." (Google Review Button).

Changed

• Landing page structure — AI Co-Pilot section inserted between the pricing block and the FAQ section, creating a clear visual break and positioning the Co-Pilot as the platform's flagship capability above the fold of the FAQ.

---

[1.7.0] — 2026-05-04

Added

• Automated welcome email on payment — Every new tradie receives a professionally branded welcome email the moment their payment is confirmed. The email includes the official Tradies Bio® logo, a full 23-feature table written in plain Australian English, and a dedicated AI Co-Pilot featured section highlighting auto-reply, compliance coaching, and voice-activated business advice.
• Admin signup & payment alerts — Stephen Pearce (stephenp@tradieshub.au) and Ken Hall (knhall6@gmail.com) are now notified automatically by email every time a new tradie completes registration and again when payment is confirmed. Each alert includes the tradie's name, trade type, phone number, ABN, and the timestamp of signup.
• Google Workspace SMTP email system — Outbound email fully connected through stephenp@tradieshub.au via Google Workspace (smtp.gmail.com, port 587, TLS). All transactional emails — welcome, admin alerts, password reset, onboarding, GBP reminders, QR ready, monthly check-in — are now sent live. System tested and confirmed working 4 May 2026.
• Official Tradies Bio® logo in all emails — The registered trademark logo is displayed in the header of every outbound email template with a white background and a 3px Safety Orange bottom border, consistent with the brand style guide.
• Free-text document upload inputs — Insurance, Certification, and Other document categories in the Compliance Vault (Under-Carriage) now use datalist free-text inputs instead of fixed dropdowns. Tradies can type any document type not on the suggested list.
• Expanded certification list (21 types) — Asbestos Awareness, Chainsaw Operations, Confined Space Entry, CPR & First Aid, Dogging, Elevated Work Platform (EWP), Excavator Operations, Explosives Handling, First Aid, Forklift Operations, Height Safety, Rigging — Basic / Intermediate / Advanced, Scaffolding — Basic / Intermediate, Silica Dust Awareness, Skid Steer Operations, Traffic Control, Working at Heights.
• Expanded insurance list (9 types) — Contract Works, Cyber Liability, Management Liability, Marine Transit, Plant & Equipment, Professional Indemnity, Public & Products Liability, Tool & Equipment, Vehicle & Fleet.
• Expanded licence list (20 types) — Builders Licence, Crane & Hoist Licence, Demolition Licence, Electrical Contractor Licence, Electrician Licence, Gas Fitting Licence, High Risk Work Licence, Occupational Health & Safety, Pest Control Licence, Plant Operator Licence, Plumbing Contractor Licence, Plumbing Licence, Refrigeration & Air Conditioning Licence, Restricted Electrical Licence, Security Industry Licence, Supervisor Certificate, Water Plumbing Licence, White Card (Induction), Workplace Health & Safety, Working With Children Check (WWC).
• Branding SVG assets — Three production-ready SVG vector files created: icon mark (square), full horizontal lockup, and dark-background icon variant. Suitable for van wraps, decals, signage, and print.

Changed

• Brand colour standardised to #f75f07 — All eight email templates updated from #FF6600 to #f75f07, matching the official Safety Orange extracted directly from the Tradies Bio® logo file. Consistent across buttons, headings, borders, and highlights.

Fixed

• Vault upload JavaScript — Pre-fill logic updated to use .value assignment compatible with datalist free-text inputs, replacing the previous select-option loop that broke when dropdowns were converted.

---

[1.6.0] — 2026-05-02

Added

• Tradies Bio® AI Co-Pilot — The AI Co-Pilot is introduced and branded across the platform. The dashboard now features a dedicated card explaining the three core capabilities coming to every tradie: Auto Reply to Enquiries (event-triggered, no effort required), Compliance Coach (vault-aware, checks credentials against job types, fires expiry alerts), and Voice-Activated Business Advisor (hands-free, plain Australian English, in the ute or on the tools). The name Tradies Bio® AI Co-Pilot is the consistent brand used throughout the app going forward.
• Administrator role (RBAC) — A new is_admin flag on the User model restricts the Changelog page to administrators only. Non-admin users do not see the Changelog link in navigation and receive a 403 page if they attempt direct access.
• Steve Wells — Administrator — Stephen Wells (AWS Drains, awsdrains@gmail.com) added as the first named administrator of Tradies Bio®. Steve is the inspiration behind the platform — a civil trade-qualified plumber whose career exemplifies exactly why tradies deserve a professional digital identity without relying on marketing agencies.
• Extended document types — Compliance Vault expanded to 17 document types across four professional categories: Licences & Registrations (including WWC Check, Asbestos Removal Licence, Scaffolding Licence), Insurance (including Professional Indemnity and Plant & Equipment), Certifications (First Aid, Height Safety, EWP, Confined Space, Traffic Control), and Other.
• Document reference numbers — Each vault document can now store a licence number, policy number, or card number for instant quoting on site. The label adapts automatically to the document category selected.
• Valid From date — Vault documents now record their issue date alongside the expiry date, displaying a clean validity period (e.g. 12 Jan 2024 – 11 Jan 2029).
• Category showcase — Vault documents are grouped and displayed under their professional category headings with Safety Orange underlines, making credentials easy to locate at a glance.

Security

• Changelog route protected by @admin_required decorator; stacked on @login_required.
• 403 error page added matching the existing workwear aesthetic.

---

[1.5.0] — 2025-05-02

Added

• Changelog page — This dedicated /changelog route provides a full history of every improvement, fix, and addition to Tradies Bio®, rendered from CHANGELOG.md and styled in the workwear aesthetic.
• Changelog nav link — Authenticated users can now reach the changelog directly from the top navigation bar.

---

[1.4.0] — 2025-04-20

Added

• QR Code sharing — Tradies can generate and download a high-resolution print-ready QR code (300 dpi PNG) that links directly to their public bio page.
• QR preview — A live QR preview is rendered inline on the Share page before download.
• NFC guidance — Share page includes instructions for programming NFC stickers with the tradie's profile URL.
• vCard download — Public bio pages include a downloadable .vcf contact card so customers can save the tradie's details directly to their phone.
• Share dashboard page — Centralised /dashboard/share page brings together QR, NFC, and bio-link sharing tools.

---

[1.3.0] — 2025-04-10

Added

• Public Enquiry form — Customers visiting a tradie's public bio page can submit an enquiry (name, email, phone, message) without needing an account.
• Enquiries inbox — Tradies have a private /dashboard/enquiries page with search, sort, and read/unread filtering.
• Unread badge — The dashboard and nav show a live count of unread enquiries.
• Rate limiting on enquiry submission — Prevents spam submissions from the public form.

Fixed

• Flash message positioning on the public bio page.

---

[1.2.0] — 2025-03-28

Added

• Compliance Vault (Under-Carriage) — Private document storage where tradies upload licences, insurances, and certificates (PDF, JPG, PNG, up to 5 MB each).
• Document categories — Documents are grouped into Licences & Registrations, Insurance, Safety & Training, and Business Documents.
• Expiry tracking — Each document can have a valid-from and expiry date; the system calculates days remaining and flags expiring (≤ 30 days) and expired documents.
• Compliance health bar — Dashboard shows a progress bar indicating how many required documents are current for the tradie's trade type.
• Trade-specific required documents — Required document lists are pre-defined per trade type (Electrician, Plumber, Carpenter, etc.).
• Smart reminders — Dashboard surfaces expiry reminders sorted by urgency, with colour-coded indicators (red/amber/yellow).
• Document notes — Tradies can attach a private note to each vault document.
• Inline document viewer — PDFs and images open inline in the browser via a secure /dashboard/vault/view/<id> route.
• Document download — Force-download of the original file via /dashboard/vault/download/<id>.
• Document deletion — Remove a document from the vault; the physical file is deleted from disk.
• Vault PIN / My Pins — A free-text notes field on the dashboard for quick reminders visible to the logged-in user and any shared partner.

Security

• Vault files are stored outside the web root in a server-side vault/ directory, inaccessible via direct URL.
• All vault routes enforce @login_required and verify document ownership before serving files.

---

[1.1.0] — 2025-03-15

Added

• Public Bio page — Each tradie gets a public profile at /u/<slug> showing business name, trade type, phone, ABN, service area, bio, logo, and links to Google Reviews and HiPages.
• Auto-generated slug — Unique URL-friendly slug generated from business name on first save, with collision handling.
• Logo upload — Tradies can upload a business logo (JPG, PNG, max 2 MB) displayed on their public bio and served via /logo/<filename>.
• Google Review link — Tradies add their Google Business review URL; a prominent button appears on the public bio page.
• HiPages link — Optional HiPages profile link displayed on the public bio page.
• Domain mapping guide — Dashboard includes step-by-step instructions for pointing tradiesbio.au to the app.

Changed

• Profile edit form expanded to include all new fields (phone, ABN, service area, Google Review URL, HiPages URL, bio).

---

[1.0.0] — 2025-03-01

Added

• Account registration — Tradies sign up with email, business name, trade type, and password.
• Email verification — Registration sends a verification email; unverified accounts cannot log in.
• Login / Logout — Secure session-based authentication via Flask-Login.
• Password hashing — All passwords stored as bcrypt hashes; plain-text passwords are never stored.
• Edit Profile — Authenticated tradies can update their business name, trade type, and core contact details.
• Dashboard — Central hub showing document count, unread enquiry count, expiry alerts, and quick-action buttons.
• PWA / Mobile Installation — Service worker and web app manifest allow Tradies Bio® to be installed as a home-screen app on iOS and Android.
• Workwear design system — Charcoal (#2D2D2D), Safety Orange (#FF6600), and White colour palette applied site-wide with a fully mobile-responsive layout.
• Security hardening — CSRF protection (Flask-WTF), HTTP security headers (Flask-Talisman), rate limiting (Flask-Limiter), and @login_required guards on all private routes.
• Tradies Bio® trademark — Registered trademark symbol and branding appear consistently in the header and footer across all pages.

Security

• CSRF tokens required on all state-changing forms.
• Content Security Policy, X-Frame-Options, X-Content-Type-Options, and Referrer-Policy headers applied via Flask-Talisman.
• Rate limiting applied globally (500 requests/day per IP) with stricter limits on authentication routes.

Brand Milestone — New Logo Launched — 14 May 2026

By Stephen Pearce — Founder, Tradies Bio®

---

Tradies Bio® Rebrand — New Logo Effective Immediately

Effective 14 May 2026, Tradies Bio® has launched its new official logo across the entire platform.

The new mark features:

• The T-mark — a bold, geometric orange T with a swept interior curve, conveying strength, forward movement, and the precision of a skilled tradie
• TRADIESBIO® — the wordmark in structured black and Safety Orange, with the Bio® element rendered with a molecular network icon — reflecting the connected, intelligent platform beneath the brand
• "BUILDING YOUR BUSINESS IS OUR BUSINESS" — the tagline, set in uppercase, reinforcing the platform's singular purpose

This logo is now live across:

• Site-wide navigation header — every page of the platform
• All outgoing emails — welcome emails, enquiry notifications, admin alerts, and all future correspondence
• The public changelog — this record reflects the brand as it stands from this moment forward

---

This logo was approved and launched by Stephen Pearce on 14 May 2026.

Stephen Pearce
Founder — Tradies Bio®
14 May 2026

---

---

Tradies Bio® AI Suite — Phase 1 Live — 8 August 2026

By Stephen Pearce — Founder, Tradies Bio®

---

Tradie Scout — Now Live in Full Test Mode

8 August 2026 marks the beginning of a new era for Tradies Bio®.

Today we activated Tradie Scout — our first dedicated AI agent — and placed it directly inside every tradie's dashboard in the Tool Box. This is Phase 1 of a two-phase rollout that will fundamentally change how Australian tradies find and follow up on work.

Scout is live, connected, and being tested right now. Here is what has been built, how it works, and where we are heading.

---

What Is Tradie Scout?

Tradie Scout is an AI agent with one mission: find the work a tradie might be leaving on the table.

Every tradie has money sitting in their pipeline that they have not chased. A quote sent six weeks ago — no reply. An enquiry from their public Bio page — no response. A clear Thursday on the calendar — no job booked. Tradie Scout scans all of this and walks the tradie through it, one opportunity at a time, in plain language.

It is like having an extra person on your payroll — someone whose only job is to scan your business 24 hours a day, 7 days a week, and tell you what needs to be acted on. The difference is: Tradie Scout costs nothing.

What Scout scans:
- Stale quotes — sent 30 or more days ago with no acceptance or reply
- Unanswered enquiries — leads from the public Bio page that have not been responded to in 30 or more days
- Open calendar days — clear days in the tradie's Google Calendar over the next 14 days that could be filled with paid work

What Scout remembers:
- Every opportunity Scout surfaces is written to a persistent memory log
- Opportunities the tradie has actioned are retired permanently — Scout never repeats them
- Opportunities the tradie has skipped are snoozed for 30 days before Scout raises them again
- This means Scout gets smarter over time — it learns what the tradie has already seen and moves on to what is new

---

Co-Pilot and Scout — Two Agents, One Team

To understand how these two agents work together, think of them as head and neck. They are independent of each other, but they operate in the spirit of full cooperation for the tradie.

Tradie Scout is the analyst. It works quietly in the background, scanning, logging, and building a picture of every opportunity in the tradie's pipeline. Scout never rests. Scout never forgets.

Tradies Bio® AI Co-Pilot is the communicator. It sits in conversation with the tradie, writes professional messages, builds quotes, and handles the correspondence that turns an opportunity into a booked job.

Phase 1 — How the handoff works today:

1. The tradie taps the red Tradie Scout button in the Tool Box
2. Scout scans the tradie's calendar, quotes, and enquiries and opens a briefing
3. Scout presents one opportunity at a time: "John Smith — you quoted him $3,200 in June and he went quiet. Want me to draft a follow-up?"
4. The tradie taps Draft Message — Scout hands the opportunity directly to Co-Pilot
5. Co-Pilot writes a professional follow-up, ready to send with one tap
6. The opportunity is marked as actioned — Scout does not raise it again

Scout finds it. Co-Pilot actions it. The tradie approves and sends.

---

Google Calendar — Connected and Verified (Approval Pending)

Tradie Scout and the My Jobs calendar view both use the tradie's Google Calendar as the source of truth for their schedule.

Current status: Tradies can connect their Google Calendar right now from their dashboard. The connection works. When a tradie connects, Scout immediately gains access to their next 14 days of calendar data and can begin identifying open days.

Google verification note: Tradies Bio® has submitted a formal OAuth verification request to Google, including a recorded demonstration video showing the full calendar connect and disconnect flow. This verification is pending Google's approval. Until approval is granted, tradies connecting their Google Calendar will see a Google-issued "unverified app" warning screen — this is normal and expected for all apps in the pre-approval window. The connection is safe and functional. The warning disappears once Google approves the verification.

Verification submitted: 8 August 2026. Links provided to Google: tradiesbio.au privacy policy, terms of service, and the verification video at youtu.be/zNYTjyTnWKQ.

---

Phase 1 — What Has Been Built

Feature	Status	Notes
Scout opportunity scanner	✅ Live	Scans stale quotes, unanswered enquiries, open calendar days
Persistent memory log	✅ Live	scout_log table — outcomes written on surface, skip, and draft
30-day skip snooze	✅ Live	Skipped opportunities suppressed for 30 days, then resurface
Permanent retirement	✅ Live	Drafted opportunities never repeated
Scout → Co-Pilot handoff	✅ Live	Tap "Draft" — Co-Pilot opens with the opportunity pre-loaded
Red Tradie Scout button	✅ Live	Bottom-right of Tool Box grid on every dashboard
Carousel panel	✅ Live	Swipeable Scout showcase card at top of dashboard
Scout story pin card	✅ Live	Full narrative card below Tool Box explaining Scout's purpose
Calendar connection screen	✅ Live	Benefit-driven setup screen with escape route if Google redirects
Admin Scout log view	✅ Live	Admins can see last 10 Scout activities per tradie

---

Phase 2 — The Tradie Running the Show

Phase 2 is where Scout and Co-Pilot become invisible infrastructure — and the tradie just talks.

The Phase 2 vision:

A tradie finishes a job on a Friday. They lost a tender earlier in the week. The school fees are due. They pick up their phone and speak to Co-Pilot:

"Things are slow. I've got nothing on for next week. What have we got? Do I have anything to follow up?"

Co-Pilot does not just answer from its own knowledge — it checks with Scout. Scout has already been logging opportunities for days or weeks. Co-Pilot surfaces the most urgent one in plain language:

"Scout's been watching your pipeline. You've got a quote with Mark Sammut — $4,800 for the bathroom — sent three weeks ago, no reply. Want me to write him a follow-up now?"

The tradie says yes. Co-Pilot writes it. The tradie approves and sends. The opportunity is retired. Scout moves on.

What makes Phase 2 different from Phase 1:
- Phase 1: The tradie opens Scout directly and Scout briefs them
- Phase 2: The tradie speaks to Co-Pilot in natural language — Scout works entirely under the hood, invisible, always ready

The tradie never needs to think about "opening Scout." They just talk to Co-Pilot the way they talk to a trusted person on their team. Co-Pilot knows when to consult Scout and does it automatically.

Natural language triggers Co-Pilot will recognise:
- "Things are quiet — what have I got?"
- "I need work this week — anything I should follow up?"
- "I lost that job — what else is in the pipeline?"
- "Scout, what's doing? Do we have anything on the books?"
- "I've got bills to pay — who haven't I chased?"

Every one of these will prompt Co-Pilot to check Scout's log and deliver a briefing — the same briefing Scout has been quietly preparing in the background.

Phase 2 is currently in development. The foundation — Scout's persistent memory log — was completed in Phase 1. Phase 2 connects Co-Pilot's conversational interface to that log so the tradie never has to leave the Co-Pilot conversation to get Scout's findings.

---

Additional Platform Updates — 8 August 2026

SWMS Email — iOS Apostrophe Fix

The "Email SWMS" feature generates a professional PDF Safe Work Method Statement on the server and emails it instantly — no iOS print dialog, no large file sizes, no hanging "Sending…" indicator.

A bug was identified where the PDF generator crashed if any field contained iOS auto-corrected punctuation — specifically curly apostrophes ('), smart quotes ("), or Unicode dashes (—) that iOS substitutes automatically when a tradie types on their phone.

This has been fixed. All text fields now pass through a Latin-1 sanitisation layer before entering the PDF engine. The PDF generates correctly regardless of what iOS auto-corrects in the background.

Scout Calendar Connection Screen — Redesigned

The screen shown to tradies who have not yet connected their Google Calendar to Scout has been redesigned with full benefit-driven copy:
- Plain-language explanation of exactly what Scout gains from the calendar connection
- Three clear benefit statements — open day detection, customer matching, and memory
- Truthful privacy notice — Tradies Bio® only reads calendar events, nothing else
- Policy links (Privacy Policy, Terms of Service) open in a new tab — tradies never lose their place in the setup flow
- An escape hatch card for tradies who navigate away during Google's consent screen and need to get back

---

Phase 1 testing commenced 8 August 2026.
Google Calendar OAuth verification lodged 8 August 2026 — pending Google approval.
Phase 2 development commences upon Phase 1 test confirmation.

Stephen Pearce
Founder — Tradies Bio®
8 August 2026

---

Co-Pilot's New Role — and the Road to Agentic Behaviour

12 August 2026

---

What Changed

Two major architectural tasks were completed back-to-back. Together they shift Co-Pilot from a smart chatbot into the control layer of a platform that can eventually act on its own.

---

1 — Co-Pilot Action Services (app/services/)

What was built:

A dedicated services layer — app/services/ — with three independent modules:

Service	What it does
email_service.py	Sends supplier emails and enquiry replies
quote_service.py	Creates and sends quotes
sms_service.py	Sends after-job SMS, review requests, and magic links

Six REST endpoints were added under /api/services/:

POST /api/services/send-supplier-email
POST /api/services/send-customer-reply
POST /api/services/create-quote
POST /api/services/send-quote
POST /api/services/send-after-job-sms
POST /api/services/request-review

All six are API-key authenticated, CSRF-exempt, and gated behind the Co-Pilot subscription check. They can be called from Co-Pilot, from the mobile app, from a Siri Shortcut, or from any future automated agent — without touching the Co-Pilot conversation at all.

Why this matters:

Previously, every "do" action (send email, create quote, send SMS) lived inside the Co-Pilot route as one-off logic that couldn't be reached from anywhere else. Now each action is an independently callable service. Co-Pilot delegates to the service. So does the mobile app. So does Siri. So will the agent layer.

---

2 — One Co-Pilot Brain Behind Every Trigger

What was built:

A shared processing core — _copilot_process() — that every entry point now calls:

• Browser chat (tap the Co-Pilot button)
• Voice API (Siri Shortcut, mobile mic, future automations)
• Nova voice conversation (tap-to-talk on mobile)

Before this change, the voice API path was a stripped-down version of Co-Pilot — single-turn, no history, no Scout context. It effectively gave a different (weaker) Co-Pilot to anyone using voice.

After this change, every trigger shares:

Capability	Browser	Voice API	Mobile mic
Rolling 20-turn history	✅	✅	✅
Scout opportunity context	✅	✅	✅
Task mode pre-loading	✅	✅	✅
Full system prompt	✅	✅	✅

Voice callers also receive a brevity hint — Co-Pilot knows it's being heard, not read, and adjusts its reply length accordingly.

Task modes added:

quote, supplier, money, followup, swms — a tradie can Siri-shortcut directly into a specific Co-Pilot mode. The money mode is new: designed for tradies chasing an outstanding invoice, it walks them through their options and drafts a firm but professional follow-up.

Security tightened:

Voice STT (/dashboard/copilot/voice-stt) now enforces both copilot_access AND voice_copilot_enabled before accepting audio. An account with voice beta enabled but no active Co-Pilot subscription gets a clear 403 — no silent STT cost is incurred.

---

3 — Nova Voice on Mobile

The native voice Co-Pilot trigger is now live in the Tradies Bio mobile app (iOS):

• Microphone permission handled via expo-av with a plain-language explanation
• State machine: idle → recording → transcribing → thinking → reply
• Reply appears in a bottom-sheet modal — readable, dismissible, hands-free
• Gated: only appears when the tradie has both copilot_access AND voice_copilot_enabled
• Works via API key — no session cookie required, so Siri Shortcuts and background automations can call the same endpoint

---

4 — PDF Email Fix

The "Download PDF — 22 Slides" email feature was silently failing on every request with:

ERR_SOCKET_NOT_CONNECTED at https://tradiesbio.au/tradies-bio-deck/allslides

Root cause: The --disable-background-networking Chromium flag disables Chrome's socket pool initialisation. On Linux production containers this kills the socket before the first navigation — so every page.goto() fails immediately. The green "PDF is being generated" message appeared, but the background job died before the email ever sent.

Fix: Removed --disable-background-networking. Replaced with --no-first-run, --disable-translate, and --disable-sync — which suppress unnecessary startup prompts without touching the network stack. The deck URL is also now configurable via DECK_PDF_URL environment variable so it can be overridden per-environment without a code change.

---

Where This Is Headed — Agentic Co-Pilot

The services layer and the unified Co-Pilot core are not endpoints — they are infrastructure. The next steps build on them:

Step 1 — Close the loop (Task #204, drafted)
When Co-Pilot offers an action ("I've drafted that quote — want me to save it?") and the tradie says yes, Co-Pilot calls the matching service and confirms what it actually did. Today it drafts. Next it does.

Step 2 — Scout triggers Co-Pilot unprompted (Task #168, drafted)
Scout already logs opportunities silently in the background. The next step is Scout surfacing those findings to Co-Pilot proactively — not waiting to be asked. A tradie comes home, opens the app, and Co-Pilot has already identified the most urgent follow-up.

Step 3 — Agents call services on a schedule
Once every action is a service call (Step 1) and Scout can trigger Co-Pilot (Step 2), a lightweight scheduler can chain them: Scout detects a stale quote → Co-Pilot drafts a follow-up → sends it (with the tradie's approval, or autonomously for pre-approved actions). The tradie wakes up to work already done.

The architecture is in place. The tradie just talks — or doesn't even need to.

---

Stephen Pearce
Founder — Tradies Bio®
12 August 2026

---