HubSpot CRM Deal Workspace — Three Custom UI Extension Cards (React, TypeScript, Serverless Functions)
A production-style HubSpot Deal record workspace built as three custom CRM UI Extension cards. Stage-aware checklists with hard-gate enforcement, append-only narrative and review history, Google Drive evidence capture, and read-only program metrics — all surfaced inside the Deal record itself.
Published Apr 26, 2026





Full description
Three React + TypeScript cards sit on the Deal record and surface a real internal-sales workflow without leaving HubSpot. Writes go through a HubSpot serverless function (no external server). 60 custom Deal properties are provisioned by an idempotent bootstrap script. Vitest unit tests cover the pure card logic; GitHub Actions runs tests, build, and a property-manifest dry-run on every push.
What it does
- Stage Workspace card — renders a different checklist per
dealstageand partner tier, computes hard-gate status (blocked/in_progress/ready), keeps append-only narrative history, and stores Google Drive evidence URLs per stage. - Document Library card — surfaces NDA / SOW / MSA / Contract template links, captures submission metadata, enforces a 48-hour minimum review window, routes review ownership to COO / Ops / Legal deterministically, and keeps an append-only review history.
- Program Builder card — read-only display of selected programs with aggregate conversion, monthly lead volume, and projected ACV. Reads stored Deal properties without recalculating in the UI.
- Property bootstrap —
config/deal-properties.jsondeclares the 60 custom Deal properties;scripts/create-properties.mjssupports dry-run and apply.
Why it's interesting
- Stage- and tier-aware UI driven by Deal properties. The cards re-render based on
dealstage+ custombd_partner_tier. Hard-gate logic lives in a pure module so it's unit-testable apart from the card. - Append-only writes through HubSpot serverless. Narrative and review history are append-only — the serverless function fetches the current value, appends with a stable separator, and PATCHes the Deal. No external backend, no client-side mutation risk.
- No file-upload hack. HubSpot UI Extensions don't offer a native file-upload component, so the evidence flow is honest: upload to Google Drive first, then store the share URL on the Deal.
- 60-property bootstrap. Custom Deal properties were the gnarly part of this build — idempotent dry-run / apply scripts mean the schema is reproducible across portals.
Tech
- HubSpot
2026.03project structure, CRM UI Extensions registered withhubspot.extend() - React 18, TypeScript, Vite for the local preview app
- HubSpot serverless function (Node) for the write path
- Vitest unit tests for stage gating, tier-conditional checklist, document routing
- GitHub Actions CI: tests + build + property-manifest dry-run
Repo
Public on GitHub: https://github.com/ohrytskov/hubspot-deal-workspace
Captures
A 2-minute Loom walkthrough covers all three cards plus the supporting code: https://www.loom.com/share/e24406f61fa143cca6548fd6bccbd7d4