docs(marketing): homepage redesign messaging strategy#980
Open
lane711 wants to merge 10 commits into
Open
Conversation
Competitive analysis + section blueprint for sonicjs.com redesign. Core wedge: edge-native speed + MIT freedom together — what no rival offers. Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
Replace docs-layout home page with standalone marketing page: - Convert page.mdx → page.tsx to bypass MDX Prose wrapper (max-w-2xl constraint) - Add MarketingNav: sticky dark-aware navbar with logo, Docs/Blog/Compare links, GitHub/Discord icons, Getting Started CTA, mobile hamburger - Layout.tsx: early-return marketing branch when pathname === '/' (no sidebar, no offset, no breadcrumbs) - Hero: Tailwind UI dark full-bleed layout with grid SVG pattern, indigo glow, and admin UI screenshot - Sections: benchmark strip, pain→escape cards with images, code proof, feature grid, comparison table, pricing, social proof, use cases, final CTA band - Move changelog off home page → single link to /changelog - Add 5 placeholder images under www/public/images/home/ (to regenerate with DALL-E when billing restored) - Add E2E spec tests/e2e/91-marketing-home.spec.ts Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
Brings in full page.tsx homepage rewrite, MarketingNav, Layout updates, hero images, pain card images, and E2E spec 91. Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
- Hero: new headline "The headless CMS that runs on the edge." fusing edge-native + MIT-free wedge per strategy; updated subhead, npx snippet in hero, micro trust strip (MIT · 330+ cities · $0 · TS-first) - Four Pillars section: edge / MIT-free / independent+community-owned / DX+AI — surfaces the "no VC clock" differentiator missing from prior page - AI section: elevated above comparison table with MCP, Vectorize, agent-ready API copy; was buried as one feature card - Comparison section: "Honest numbers. No marketing spin." heading with candor teaser linking to /compare - Final CTA: updated copy to lead with MIT+no-paywalls angle Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
… edge." Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
Wraps admin screenshot in -m-2/p-2 ring border from Tailwind template for the frosted inset border effect. Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
Portability as risk-reversal, not repositioning — edge stays the wedge, portability kills the "married to Cloudflare" lock-in objection. - Hero subhead: "built for Cloudflare Workers — and runs on Docker, your VPS, anywhere SQLite runs" - Trust strip: "Runs anywhere" token - Pillar 3: "Independent & portable" (adds no-infra-lock-in leg) - New "Deploy anywhere" section: Cloudflare RECOMMENDED + self-host grid (Docker/VPS/PaaS/homelab/on-prem/serverless) + honest "Postgres on the roadmap" footnote - Strategy doc: portability risk-reversal subsection, competitive judo, honesty guardrail, blueprint slot 11, Do/Don't - E2E: fix 2 stale assertions from merge (would fail CI) + 3 portability tests Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
Assume MCP plugin (issue #784, docs/ai/plans/mcp-plugin-plan.md) shipped. Upgrade AI messaging from generic "MCP support" to concrete agent-operable. - Pillar 4: "Code-first DX + AI-native" — native MCP server, agents read/manage content via Claude Code, Cursor, VS Code - AI section: MCP promoted to lead bullet (auto-generated tools, read/ create/publish, secure scoped keys, respects existing ACL); intro leads with MCP; code panel swapped to mcpServers connect snippet (/api/mcp) - Strategy doc: pillar 4, blueprint slot 9, AI-story line -> agent-operable - E2E: +1 test for AI-section MCP content Honest framing: MCP is opt-in plugin ("connect your agent"), not on by default. h1 unchanged (SEO needs "headless CMS"). Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
Pain cards now use the image as a full-bleed card background with text overlaid, replacing the image-on-top-of-text layout. - Card: relative, min-h-[22rem], flex-col justify-end, overflow-hidden - Next Image fill + object-cover fills the card; hover zoom retained - Dark top-gradient scrim (black/90 -> black/25) for text legibility - Text overlay wrapped in relative div (paints above image+scrim, no negative z-index); title white, body/footer light gray - Stat highlights -> text-red-300 for contrast on the dark image - E2E: +1 test (heading, fill-image alt, overlaid card title) Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
1 participant
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Summary
demo.sonicjs.com) — Phase A cron-reset sandboxNo code changes — strategy doc only
docs/marketing/homepage-redesign-strategy.md🤖 Generated with Claude Code