Engineering roadmap — Phase 1 completion + Phase 2 setup (tracking)

[0xdevcollins]

What this is

Tracking issue for the post-PR-#136 engineering queue. Six follow-up issues filed; this is the parent so contributors can see the whole queue + priorities in one place.

The big picture

PR #136 is the biggest change set in the repo's history: CCTP V2 cutover, hosted checkout end-to-end, managed Stellar settlement onboarding, ~15k LOC net deletion. Everything below is the work that turns "infrastructure shipped" into "can invite a real merchant to use this without anything 404'ing or crashing."

The queue

Tier 1 — demo-ready (this week)

• PR 8 — Dashboard: /links list page + create-link form #144 PR 8 — Dashboard `/links` list page + create form (1 day)
• PR 9 — Dashboard: /links/[id] detail page #145 PR 9 — Dashboard `/links/[id]` detail page (0.5 day, depends on PR 8 — Dashboard: /links list page + create-link form #144)
• PR 10 — E2E crypto smoke: Base Sepolia → Stellar testnet round-trip + runbook #146 PR 10 — E2E crypto smoke on Base Sepolia + runbook (0.5 day)
• Marketing: /pricing page (currently 404s from nav) #137 — Marketing `/pricing` page (0.5 day)
• Marketing: /contact page (replace mailto: in Footer) #140 — Marketing `/contact` page (0.5 day)

Exit criteria: A new merchant can sign up, create a link via the dashboard, share it, watch a real crypto payment land on Stellar, and the marketing site doesn't 404 on `/pricing` or `/contact`.

Tier 2 — production-ready (next 1–2 weeks)

• Withdrawal flow — endpoint + dashboard UI (the managed-wallet escape hatch) #147 — Withdrawal endpoint + UI (1 day) — the honest-custody lever
• Card flow: real Stripe test key + end-to-end card payment verification #148 — Real Stripe test key + card E2E (1 hr) — closes the card flow
• Checkout app: fix pre-existing tsc errors (production build will fail) #149 — Checkout app tsc cleanup (1–2 days) — required for production `next build`
• Marketing: /products family (hosted-checkout, pay-by-link, invoicing) + index #139 — `/products/*` family pages (depends on PR Phase 1: hosted checkout, CCTP V2 cutover, managed Stellar settlement #136 merging)
• Marketing: legal stack — /cookies, /dpa, /sla, /security/responsible-disclosure #142 — Legal stack: cookies/DPA/SLA/responsible-disclosure (1 day, copy drafted)

Exit criteria: A real merchant can sign up, take card + crypto + bank payments, withdraw their balance to a self-controlled wallet, and procurement can review the legal pages without flagging them as missing.

Tier 3 — growth + retention (next month)

• PR 7.9c — Passkey-derived self-custody settlement wallet (Approach B) #150 — Passkey-derived settlement wallet (Approach B) (3–5 days) — graduates the marketing claim to "self-custody by default"
• Marketing: /integrations page (currently 404s from nav) #138 — Marketing `/integrations` page (needs logo assets first)
• Marketing: /blog index + scaffold (content marketing surface) #141 — `/blog` infra + 5 seed posts (5 days)
• Dashboard analytics screens, payouts UI, invoicing UI — file as separate issues when the first merchant asks

Suggested sequencing for a 2-person team

Engineer A (frontend-heavy):

• Mon–Tue: PR 8 — Dashboard: /links list page + create-link form #144 + PR 9 — Dashboard: /links/[id] detail page #145 (dashboard /links)
• Wed: Marketing: /pricing page (currently 404s from nav) #137 + Marketing: /contact page (replace mailto: in Footer) #140 (pricing + contact)
• Thu: Card flow: real Stripe test key + end-to-end card payment verification #148 (Stripe key + card test)
• Fri: start Checkout app: fix pre-existing tsc errors (production build will fail) #149 (checkout type cleanup)

Engineer B (backend-heavy):

• Mon: PR 10 — E2E crypto smoke: Base Sepolia → Stellar testnet round-trip + runbook #146 (E2E crypto smoke + runbook)
• Tue–Wed: Withdrawal flow — endpoint + dashboard UI (the managed-wallet escape hatch) #147 (withdrawal endpoint + UI)
• Thu–Fri: Marketing: legal stack — /cookies, /dpa, /sla, /security/responsible-disclosure #142 (legal pages, mostly mechanical)

Both engineers reconverge on #150 (passkey wallet) the following week.

Out of scope for this roadmap

• Dashboard `/payouts` and `/invoices` polish — separate issues to file once the link flow is solid
• Mobile-app variant — explicitly deferred
• The remaining "Phase 2" work (more chains, more payment methods, embedded SDK) — separate roadmap

How to pick something up

1. Read this issue + the linked one
2. Claim it by commenting "I'll take this" + ideally a target date
3. Branch off `main` (or off `feat/phase-1-checkout-cctp-v2-settlement` if your work depends on PR Phase 1: hosted checkout, CCTP V2 cutover, managed Stellar settlement #136)
4. PR back to `main` (or to that branch if it isn't merged yet)
5. Reference the issue number in the PR title and body

Related

• Marketing pages audit: Marketing: missing pages — tracking issue + audit #143 (parent for Marketing: /pricing page (currently 404s from nav) #137, Marketing: /integrations page (currently 404s from nav) #138, Marketing: /products family (hosted-checkout, pay-by-link, invoicing) + index #139, Marketing: /contact page (replace mailto: in Footer) #140, Marketing: /blog index + scaffold (content marketing surface) #141, Marketing: legal stack — /cookies, /dpa, /sla, /security/responsible-disclosure #142)
• Phase 1 PR Phase 1: hosted checkout, CCTP V2 cutover, managed Stellar settlement #136 — the giant phase-1 change set this is all building on