Skip to content

feat(site): add marketing landing page - #187

Merged
jeremymcs merged 1 commit into
mainfrom
jeremymcs/website
Aug 30, 2026
Merged

feat(site): add marketing landing page#187
jeremymcs merged 1 commit into
mainfrom
jeremymcs/website

Conversation

@jeremymcs

Copy link
Copy Markdown
Owner

What

Adds a standalone marketing site under site/, intended to run as its own Vercel project (Root Directory site). The existing GitHub Pages docs site in docs/ is untouched — the landing page links out to it.

Static HTML compiled with the Tailwind CLI. No framework, no runtime dependencies. site/ carries its own package.json so the marketing build never pulls the application's dependency tree.

Page contents

One long page: hero → the stale-PR problem → watch/sync/triage/dispatch (including the real pending → queued → in_progress → resolved lifecycle as inline SVG) → six feature sections built on product screenshots → safety and local-first defaults → the four interfaces → install and a cautious first run → FAQ → footer.

Copy is sourced from README.md, package.json and docs/public/. No invented metrics, no testimonials, no user counts. The README's own caution — that PatchDeck can spend paid agent usage when automation is enabled — is surfaced on the page rather than hidden.

Design

Follows design-system/patchdeck/MASTER.md for typography (Fira Code / Fira Sans) and the green CTA, but uses the product's real near-black surfaces and blue/amber/red status accents so the page resembles the app it describes. This is a deliberate deviation from MASTER.md, which specifies green as the sole accent.

Asset decisions

  • Screenshots pre-optimized to webp and committed (2.6 MB → 608 KB) rather than converted during the build, since the conversion tooling is macOS/Homebrew-local and would not run on Vercel's Linux builders. Regeneration steps are in site/README.md.
  • docs/assets/hero-background.png (1.5 MB) is not used — it is a plain radial gradient, reproduced in CSS.
  • docs/assets/sdlc-bottleneck.png is deliberately unused: it is a light-background image asserting an unsourced "90% of total delay" statistic.

Verification

  • Rendered at 1440px and 375px — 0 console errors or warnings, no horizontal page overflow.
  • All external links return 200. The npm package link 403s to curl (bot protection); confirmed via the registry API that @jeremymcs/patchdeck@1.6.0 exists and matches the version shown on the page.
  • Mobile nav and copy-to-clipboard verified working.
  • npm run lint and npm run check pass; no server or client code is touched.

Follow-up before this goes live

Canonical URLs are currently the placeholder https://patchdeck.vercel.app/. Once the real domain is attached they need updating in index.html (canonical, OG/Twitter meta, JSON-LD), public/robots.txt, and public/sitemap.xml — documented in site/README.md.

The Vercel project does not exist yet. A production deploy from main will only succeed once this branch is merged, since site/ does not exist on main.

Implementation plan: docs/plans/marketing-website.md.

🤖 Generated with Claude Code

https://claude.ai/code/session_01LF9K9Y3sGMA2EAQVqF93JW

Adds a standalone marketing site under site/, deployed as its own Vercel
project (Root Directory "site"). The existing GitHub Pages docs site in
docs/ is untouched; the landing page links out to it.

Static HTML compiled with the Tailwind CLI — no framework, no runtime
dependencies. site/ carries its own package.json so the marketing build
never pulls the application's dependency tree.

Design follows design-system/patchdeck/MASTER.md for typography and the
green CTA, but uses the product's real near-black surfaces and
blue/amber/red status accents so the page looks like the app it describes.

Page covers: the stale-PR problem, the watch/sync/triage/dispatch flow
with the real feedback lifecycle, six feature sections using product
screenshots, safety and local-first defaults, the four interfaces,
install and a cautious first run, and an FAQ.

Screenshots are pre-optimized to webp and committed (2.6 MB -> 608 KB)
rather than converted at build time, keeping the build reproducible on
Linux builders. The 1.5 MB hero-background.png is reproduced in CSS.
docs/assets/sdlc-bottleneck.png is deliberately unused: it is a
light-background image carrying an unsourced "90% of total delay" stat.

Implementation plan saved to docs/plans/marketing-website.md.
@jeremymcs
jeremymcs merged commit 165f82c into main Aug 30, 2026
8 checks passed
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