Taskly.ca

The get-it-done network for the GTA. A two-sided task marketplace: customers post tasks, vetted Taskers make offers, an accepted offer becomes an escrow-held booking (20% commission). A curated set of fixed-price "vetted flows" sits alongside the open marketplace. One Next.js 16 app — Supabase auth + RLS, Stripe Connect, Groq AI layer.

Run locally

Prerequisites: Node.js. Then:

npm install
npm run dev      # Turbopack dev server on :3000

Full commands, required env vars, architecture, and conventions live in CLAUDE.md — the working guide for anyone (human or agent) editing this repo.

---

🗂 Repo layout

Where	What lives there
app/ components/ hooks/ lib/ public/ scripts/ supabase/ tests/	The product (Next.js 16 app).
Root docs	Only the indexes + code-anchored system docs: README, CLAUDE.md, AGENTS.md, ARCHITECTURE.md, DESIGN_SYSTEM.md, SECURITY.md.
docs/	Engineering & product specs (flows, pricing spec, AI package, SEO, deploy, email/notifications maps).
business/	Business, marketing, legal & GTM docs — current only (business model, plans, brand voice, launch/social plans, growth kit, research). Superseded material moved to _archive/business/ on 2026-07-31.
status/	Living trackers only (Progress.md is the hub). Finished point-in-time logs go to _archive/status/.
_archive/	Superseded docs & artifacts — history only, never current.
community/	The separately-deployed community app (own package.json/build; served at /community).

📚 Documentation index

This is the map. Each topic lists its one canonical file first; everything cross-links. Stale/superseded drafts live in _archive/ (nothing deleted). Docs marked 🔒 are referenced by code — do not move or rename them without updating the referencing code.

Business

Doc	What it is
business/00-INDEX.md ✦	The business/marketing map-of-content — one canonical doc per theme, the live-decisions table (money model, fees, vetting, locked lines), and the genuinely-open questions. Start here for anything non-engineering.
business/BUSINESS-MODEL.md ✦	The finalized operating model (2026-07-06) — start here. Wins on any conflict. Positioning, category tiers, 20% money model, hybrid offers→fixed.
business/Taskly-Business-Plan.md	Fuller business plan — economics, GTM (see BUSINESS-MODEL.md for finalized deltas).
business/Final business plan.md	Code-verified primer; §7 = the trust-claim honesty boundary (what's real vs. never-claim).
docs/TECH-BUILD-PLAN.md ✦	Engineering spec to implement the finalized model (deterministic pricing, hybrid lifecycle).
business/RISK-REGISTER.md ✦	Red-team gap review — the trust paradox, the trust-fork decision, financial/liquidity/founder gaps, ranked. Carries the 2026-07-18 resolution pass.
business/LEGAL-CLAUSES-DRAFT.md ✦	DRAFT disclosure clauses for Ontario counsel (background-check/insurance/RMT/PSW/minors/children's-data).
business/CATEGORY-COMPLIANCE.md	Per-category Ontario go/no-go by vetting tier (T1/T2/T3) + the ⚠︎VERIFY-WITH-COUNSEL list.
business/DISPUTES-AND-REFUNDS.md · business/TASKER-QUALITY-POLICY.md	Refund matrix + safety runbook; supply-side value narrative + quality/removal ladder.
business/INSURANCE_POLICY.md · business/INSURANCE-BRIEF.md	What support says today (no insurance exists); the broker-quote package to change that.
business/FINANCIAL-MODEL.md ✦	Unit economics, break-even, cold-start burn, CAC sensitivity, scenarios.

Market & competition

Doc	What it is
business/COMPETITIVE-LANDSCAPE.md ✦	TaskRabbit / Jiffy / HomeStars / Bidmii / Taskal + the marketplace "graveyard" and whitespace.
business/POSTER-HOMEPAGE.md	Logged-in poster home: day-0 rail ranking (differentiation-first), archived commodity ranking, 2026-07 demand research (platforms + GTA channels).
business/MARKET-VIABILITY.md ✦	GTA market, cold-start playbook, Ontario regulatory reality, unit economics, the honest channel read.
business/research/GTA-LAUNCH-RESEARCH.md ✦	Canonical launch geography — census-computed FSA scoring, tiered postal codes, the "Don Valley Ring" verdict. Plus the data files in business/research/.
business/CATEGORY-SERP-RESEARCH.md	Verified SERP-competition ranking of the 19 categories — who already owns the search real estate.

Marketing, positioning & launch

Doc	What it is

The MC Final/ bundle was dissolved on 2026-07-31 — it was a frozen copy of docs that live below, and the copies had drifted. Its unique plans are now first-class files in business/; the duplicate residue is in _archive/business/MC-Final-bundle/.

Doc	What it is
business/TRAFFIC-ARCS.md ✦	The umbrella growth operating plan (July 2026) — the 10k-visits/day stacked-channel math, team, tools, cadence. Wins on priorities, team ops and channel mix.
business/30-60-90-SOCIAL-PLAN.md ✦	The operating 30-60-90 social plan (2026-07-08).
business/DAY-0-7-LAUNCH-WEEK.md · business/FIRST-3-DAYS-CONTENT-PLAN.md	Launch-week ops playbook; the 07-12 founder-light content amendment (no face on camera, Reddit = founder voice).
business/30-DAY-LAUNCH-PLAN.md	The execution layer — targets, funnel math, two lanes.
business/COMMUNITY-AND-DM-PLAN.md	The channel layer under the 30-day plan — Kijiji · FB Groups · Nextdoor · CanadaVisa · Reddit · Quora, with scripts + kill criteria.
business/SEASONAL-SUPPLY-CAMPAIGN.md	The Snow Squad — Gen Z seasonal supply lane. Pages: /seasonal, /seasonal/taskers, /snowsquad.
business/SEEDING-STRATEGY.md · business/SHOWCASE-AND-SEED-TASKS.md	How the marketplace gets its first pulse; the authored seed tasks + honesty rules.
business/BLOG-RANKING-PLAYBOOK.md	Rank + get cited (Google, AIO, ChatGPT, Perplexity) — founder-locked 2026-07-26.
business/GBP-LOCAL-SEO-PLAN.md · business/RISHABH-PLAYBOOK.md	GBP/local-SEO execution; the SEO data & ops playbook for Rishabh.
business/SOCIAL-CONTENT-PLAN.md	Operational playbook for @TasklyAnything (the two-lane CORE/DROPS structure).
business/SOCIAL-BIOS-AND-PROFILES.md ✦	Canonical bios + platform-by-platform setup guide (@TasklyAnything handles).
business/MARKETING-STRATEGY.md	Positioning ("broad AND safe"), personas, the §15 SEO/AEO playbook. ⚠️ Partly superseded — BUSINESS-MODEL wins on conflicts; BRAND-VOICE §9–10 carries the feeling + identity.
business/POSTER-HOMEPAGE.md	Logged-in poster home: differentiation-first rail ranking (founder call 2026-07-21).
business/growth/	Creator kit, outreach scripts, channel/bio map (trust-hook swept 2026-07-17).

Brand & copy

Doc	What it is
business/BRAND-VOICE.md ✦	Canonical voice — locked lines, voice pillars, verbiage, honesty guardrails, readability rules, §9 the exhale + §10 @TasklyAnything identity.
business/STORYTELLING.md ✦	Narrative craft — the nine-beat arc from /about, craft rules, §6 how to write a blog post. Governs every story-shaped piece.
docs/KEYWORDS-AND-BLOG-STRATEGY.md	Which keywords are winnable at zero authority (tiered), and what a blog is for once ChatGPT/Gemini answer first. Sits under SEO_MASTER_PLAN.md.
business/IMAGERY-PROMPT.md 🔒	Canonical generated-image prompt (founder-locked 2026-07-25) — one warm-dark palette for every Taskly image. Change only the subject clause.
business/HIGGSFIELD-CATEGORY-IMAGERY-BRIEF.md	Per-category hero-object table (§3) — stops two categories looking alike. Its own "Master Prompt" is superseded by IMAGERY-PROMPT.md.
business/HOMEPAGE-COPY.md	The verbatim shipped homepage copy.
business/MICROCOPY.md	The in-app writing rulebook — buttons, empty states, errors, statuses, notifications.
_archive/EXHALE-AUDIT.md	The 2026-07-12 site-wide copy audit — 139 findings, all executed 2026-07-13 (completed → archived).

Design

Doc	What it is
docs/TASKLY_DESIGN_CONSTITUTION.md	Design principles (the philosophy layer).
DESIGN_SYSTEM.md 🔒	Design system — tokens, type scale, components, readability checklist.
docs/Uber-DESIGN.md	Reference analysis of Uber's system (inspiration, not a Taskly spec).

Pricing

Doc	What it is
docs/pricing/PRICING_v3.md 🔒	Canonical curated rate card. ⚠️ Its §0 "Decision A" fee model is DEAD — the 8% Taskly fee was killed 2026-07-18 (R13). Rate card (B/C/D) stands; every "all-in" figure that adds the fee is wrong.
Money model, one line	Poster pays base − discounts + HST. Tasker gets ~80%. Taskly keeps 20%, HST-inclusive (COMMISSION_RATE = 0.2) — on both engines. No customer-facing fee line anywhere.
docs/pricing/PRICING_OVERVIEW.md + docs/pricing/PRICING_HOW_IT_WORKS.md	Marketplace price-estimate engine (separate subsystem).
docs/pricing/PRICING_v4_informal.md	Live proposal for the marketplace estimator (not yet applied).
business/SEASONAL-PRICE-VALIDATION-2026-07.md	Live GTA market validation of all 16 seasonal SKUs (all HOLD) + Sep/Oct re-check calendar.
Historical: _archive/PRICING.md · _archive/PRICING_v2.md · _archive/PRICING_PROMPT.md	Superseded by PRICING_v3 (kept for the § references in older code comments).

Architecture & flows

Doc	What it is
ARCHITECTURE.md 🔒	System-of-record for the capability refactor + marketplace payments. Tie-breaker on any conflict.
docs/MARKETPLACE_PLAN.md 🔒 · docs/BOOKING_FLOWS.md 🔒	Marketplace mechanics; curated-wizard UX rationale.
docs/FEED-RELEVANCE.md	Browse feed relevance engine — living spec + tuning log (P0 shipped, flags off).
docs/PAYMENTS_AND_DISPUTES.md · docs/ATTRIBUTION.md · docs/MAP_STYLING.md 🔒 · docs/COOKING_SERVICE_FLOW.md	Escrow/disputes, UTM/referral, maps, cooking flow.
docs/TASKER_COMMUNITY_PLAN.md	Design + architecture for the live ephemeral domain rooms (the separately-deployed community/ app).

AI layer

Doc	What it is
docs/AI_PROMPTS.md	As-shipped prompt catalog for every AI route.
docs/ai/taskly_ai_package/	Taxonomy + price-estimation + content-moderation source-of-truth specs (runtime copies live in lib/taxonomy/data/).

Ops, SEO & status

Doc	What it is
docs/audits/	The 2026-07-21 production-readiness audit bundle (architecture, security, scalability, infra, roadmap, target system).
docs/SEO_MASTER_PLAN.md 🔒	The audited SEO master plan (2026-07-21).
docs/SEO-GEO-AUDIT-AND-PLAN.md	SEO/GEO audit + plan.
docs/DEPLOY.md · docs/NOTIFICATIONS-MAP.md · docs/OPERATIONS-RUNBOOK.md · docs/EMAIL_MAP.md	Deploy runbook, notifications source-of-truth, ops runbook, email map.
docs/PRODUCT.md · docs/PRODUCT_BACKLOG.md · business/INSURANCE_POLICY.md	Product overview, backlog, support/honesty policy.
status/	Living trackers only (Progress.md is the hub). Finished logs: _archive/status/.

---

Conventions when adding docs

• One home per doc type. Engineering/product specs → docs/. Business/marketing/legal → business/. Living trackers → status/. Root is reserved for README / CLAUDE / AGENTS / ARCHITECTURE / DESIGN_SYSTEM / SECURITY.
• One canonical file per topic. Update it in place; don't fork a -v2. Supersede by moving the old one to _archive/ with a "superseded by →" pointer (see _archive/README.md).
• Cross-link. Start a new reference doc with the banner line the other library docs use, and link its companions.
• Honesty first. Any customer-facing claim must clear the business/BRAND-VOICE.md §5 / business/Final business plan.md §7 boundary.
• 🔒 code-referenced docs (ARCHITECTURE, docs/MARKETPLACE_PLAN, docs/BOOKING_FLOWS, docs/pricing/PRICING_v3, _archive/PRICING / _archive/PRICING_v2, DESIGN_SYSTEM, docs/MAP_STYLING, docs/SEO_MASTER_PLAN, CLAUDE) must not be moved/renamed without updating the referencing code.