Skip to content

feat(landing): major splash-page overhaul (self-serve + Harbinger bridge)#202

Merged
jfrench9 merged 8 commits into
mainfrom
feature/splash-overhaul
Jul 13, 2026
Merged

feat(landing): major splash-page overhaul (self-serve + Harbinger bridge)#202
jfrench9 merged 8 commits into
mainfrom
feature/splash-overhaul

Conversation

@jfrench9

Copy link
Copy Markdown
Member

Summary

Ground-up overhaul of the RoboLedger marketing splash page. Rebuilds it as a focused self-serve product page for the SMB / controller who owns the monthly close, adds a clear bridge to the done-for-you service (Harbinger FinLab) on the same open platform, and aligns every capability claim with what the RoboSystems backend actually ships.

Information architecture

content.tsx now composes, top to bottom:

Hero → ProofBand → Contrast → HowItWorks → Spotlights → Platform → OpenSourceStrip → Harbinger bridge → FAQ → FinalCTA

This consolidates the previous page's overlapping sections (two report sections + a workflow + an "AI in every step" that retold the same story) into a tighter, non-repeating narrative.

Changes

New sections & components

  • HeroSection rebuilt around "Close your books with AI," with an animated Claude cowork demo (CoworkDemo) that simulates the human-in-the-loop close over MCP — sequential reveal + progressive typing + per-tool "running" state + auto-scroll (modeled on robosystems-app's ConsoleDemo; starts on view via IntersectionObserver; honors prefers-reduced-motion).
  • ProofBand — outcome stat strip. ContrastSection — traditional-vs-AI-native compare (carried from the old FeaturesSection, tightened). HowItWorks — 6-beat end-to-end loop (renamed from WorkflowSection). Spotlights — four grounded feature deep-dives (Inbox, Guided Close, Live statements & reports, Console/MCP), replacing the overlapping ReportCreator/OutputFormats/AIReporting sections.
  • HarbingerSection — the done-for-you bridge (#harbinger); the only place BYOC / custom frameworks / managed-ops / consulting appear. OpenSourceStrip — slim trust strip replacing the developer-heavy self-host section. FaqSection — objection-handling accordion, including a multi-company (accountant ICP) question and a getting-started answer that reflects RoboSystems-side provisioning.
  • ProductShot — reusable frame that renders on-brand previews now and swaps in real screenshots at /public/screenshots/*. constants.ts — single HARBINGER_URL / ROBOSYSTEMS_URL / GITHUB_URL.
  • Header/Footer updated for the new nav anchors + Harbinger link; GitHub demoted from a co-primary CTA to a tertiary icon across hero, nav, and final CTA. metadata.ts SEO aligned to the new framing.

Accuracy / backend-alignment (verified against the robosystems backend where checkable)

  • Corrected the demo's MCP tool names to the real catalog: list-event-blocks, create-event-block, close-period (were invented names).
  • Removed the price: '0' Offer from structured-data.ts — it told search engines the app was free; the page is intentionally price-silent.
  • Plaid presented as "coming soon" (not a live integration); no "Coming Soon" feature-card filler.
  • Softened unbacked/overstated copy: "filing-ready" → "reports" (SEC needs iXBRL, which is deferred; backend emits validated XBRL 2.1 + JSON-LD); "millisecond queries" → "fast, interactive queries"; "minutes" → "hours, not days"; Cash Flow & Equity scoped ("as your transactions are classified" — flow mapping is MCP-side); autopilot reframed as opt-in; Auto-Map "review and approve" → "review and adjust".
  • New multi-company FAQ grounded on the verified Organization.graphs one-to-many; makes no team/collaboration claim in either direction.

Removed

  • Deleted 6 superseded, unimported landing sections (FeaturesSection, WorkflowSection, ReportCreator, OutputFormats, AIReportingSection, OpenSourceSection) — they carried the removed overclaims (Plaid-live, "autonomous," "Coming Soon"). Content is re-told honestly in the new sections; 0 references confirmed before deletion.

Testing

  • npm run test:all runs on every commit via the pre-commit hook — 128 tests pass, plus format-check, ESLint, tsc --noEmit, and cf-lint, all green.
  • npm run build compiles successfully; landing / prerenders as static.
  • Verified the rendered page in a local dev server via Puppeteer: hero (animated cowork demo), spotlights, Harbinger bridge, and FAQ all render with no console errors; Plaid shows "coming soon"; the Harbinger link resolves; the "Built on RoboSystems" link resolves.

Notes / follow-ups

  • Product screenshots: the hero + spotlights currently render on-brand placeholder previews. ProductShot is wired to drop in real captures at /public/screenshots/* with a one-line prop change once a backend + authenticated session is available.
  • "10x faster close" is intentionally kept, per product-owner decision.
  • Design system preserved — no rebrand; this stays within RoboLedger's violet/purple/fuchsia dark tokens.
  • A separate branch (bugfix/console-mcp-package-name) fixes the in-app Console's MCP package name (@roboledger/mcp@robosystems/mcp) and ships as its own PR.

jfrench9 added 8 commits July 12, 2026 17:56
…Harbinger bridge

Rebuild the marketing splash as a focused self-serve product page for the
SMB/controller who owns the monthly close, with a clear bridge to the
done-for-you service (Harbinger FinLab) on the same open platform.

Information architecture (new content.tsx composition):
Hero -> ProofBand -> Contrast -> HowItWorks -> Spotlights -> Platform
-> OpenSourceStrip -> Harbinger bridge -> FAQ -> FinalCTA.

Highlights:
- Hero rebuilt around 'Close your books with AI'; GitHub demoted from a
  co-primary CTA to a tertiary icon link across hero, nav, and final CTA.
- New Harbinger bridge (#harbinger) — the only place BYOC / custom
  frameworks / managed-ops / consulting appear — plus nav + footer links,
  all via a single HARBINGER_URL constant.
- New slim open-source trust strip replaces the developer-heavy self-host
  section (left dormant); routes self-host/BYOC intent to Harbinger.
- Consolidated the overlapping ReportCreator/OutputFormats/AIReporting
  sections into four grounded feature spotlights (Inbox, Close, Live
  Statements & XBRL, Console/MCP); dropped 'Coming Soon' filler.
- New FAQ answering QuickBooks/data/XBRL/AI objections; getting-started
  answer reflects RoboSystems-side provisioning (no pricing on this page).
- Accuracy fixes: Plaid relabeled 'coming soon' (was advertised as a live
  integration in 3 places); softened real-time-sync implication.
- ProductShot component frames on-brand previews now and swaps in real
  screenshots at /public/screenshots/* when captured.

Retains RoboLedger's design system (font-heading, primary/secondary/accent
violet-purple-fuchsia tokens, dark cards). Superseded sections left dormant
(unimported). Typecheck, lint, build, and 128 tests green.
- ProductShot: remove the fake traffic-light (close/minimize/maximize)
  buttons; keep a clean breadcrumb bar for the caption.
- Hero: replace the inbox preview with the guided period-close panel
  (fiscal-calendar summary, drafted schedules, rule-engine pass, gated
  Close button) — the close is the flagship surface and feeds the inbox.
Add a ROBOSYSTEMS_URL constant (NEXT_PUBLIC_ROBOSYSTEMS_APP_URL, default
https://robosystems.ai) and wrap the hero trust-row item in it, matching
the cross-app link pattern used elsewhere and the HARBINGER_URL constant.
…-the-loop)

Replace the static Closing Book panel in the hero with an emulation of the
real workflow: Claude driving the RoboLedger tools via @robosystems/mcp
while a person approves each step — list_inbox_events -> approve ->
draft_closing_entries -> close_period. The Closing Book panel remains
represented lower on the page in the Guided Close spotlight.
…y chip

- New CoworkDemo client component simulates the human-in-the-loop close as
  a live chat: sequential reveal + progressive typing + per-tool 'running'
  state + auto-scroll, modeled on robosystems-app's ConsoleDemo. Starts on
  view via IntersectionObserver; honors prefers-reduced-motion.
- Hero uses CoworkDemo in place of the static transcript; removes the now
  unused inline helper components.
- Remove the 'XBRL-ready' trust chip from the hero row — it's already in the
  hero description sentence.
…nment review)

Verified against the robosystems backend:
- CoworkDemo advertised invented MCP tools (roboledger.list_inbox_events,
  draft_closing_entries, close_period). Real tools are hyphenated with no
  namespace prefix: list-event-blocks, create-event-block, close-period.
- structured-data.ts published an Offer with price '0', telling search
  engines the app is free — it isn't (paid RoboSystems tiers; the page is
  intentionally price-silent). Removed the Offer block.
- Soften the Console spotlight: 'drive the whole month-end close' ->
  'help drive your month-end close' (close is a co-pilot flow).
- 'filing-ready' -> 'reports' framing (SEC needs iXBRL, which is deferred;
  backend emits validated XBRL 2.1 + JSON-LD). ProofBand + Spotlights.
- 'Millisecond queries' -> 'fast, interactive queries' (unbenchmarked).
- Timeliness: 'minutes to hours' / 'closing books in minutes' ->
  'hours, not days', consistent with the rest of the page.
- Cash Flow & Equity: scope the live/no-close promise (flow-tag mapping is
  MCP-side, not addressable from the frontend on a raw QB sync).
- Autopilot: reframe as opt-in ('enable autopilot for trusted sources') —
  it's off by default but a few clicks to turn on.

Kept '10x faster close' per product owner.
…ctions

- §4: new FAQ 'I keep books for several companies — can I manage them all
  here?' surfacing multi-graph-per-org (verified: Organization.graphs
  one-to-many). Framed on the isolated-books-per-company capability only;
  makes no team/collaboration claim either way.
- §2.9: 'you review and approve' -> 'review and adjust' (MappingOperator
  auto-writes mappings above its confidence threshold; not a hard gate).
- §2.10: delete the 6 superseded, unimported landing sections
  (FeaturesSection, WorkflowSection, ReportCreator, OutputFormats,
  AIReportingSection, OpenSourceSection) — they carried the removed
  overclaims (Plaid-live, 'autonomous', 'Coming Soon'). Content is re-told
  honestly in the new sections; 0 references confirmed.
@jfrench9 jfrench9 merged commit 65a845a into main Jul 13, 2026
3 checks passed
@jfrench9 jfrench9 deleted the feature/splash-overhaul branch July 13, 2026 01:46
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant