Changelog

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

---

[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

---