Skip to content

feat(site): one-page codeframe.sh site with social card (#1465) - #1479

Closed
adamshatzkamer wants to merge 1 commit into
frankbria:mainfrom
adamshatzkamer:feat/one-page-site-1465
Closed

adamshatzkamer wants to merge 1 commit into
frankbria:mainfrom
adamshatzkamer:feat/one-page-site-1465

Conversation

@adamshatzkamer

Copy link
Copy Markdown

Closes #1465 — one-page codeframe.sh site with social card.

What's included

  • site/index.html — a single static HTML page (no framework, no build step, no JS, no forms, no tracking, no external requests beyond the local images). Renders correctly opened directly from disk, at phone width, and in light and dark mode (prefers-color-scheme).
  • site/og-image.png — 1200×630 social card using the app mark and the brand palette from web-ui/src/app/globals.css (Think → Build → Prove → Ship chips, tagline, codeframe.sh pill).
  • Open Graph + Twitter card meta tags (title, description, image with width/height/alt).

Page sections, in order (per #1465 scope)

  1. One-sentence what-it-is (from the README Overview) — "A project delivery system for AI-written software."
  2. The existing demo GIF (docs/images/cli-tour.gif) above the fold — referenced from the repo so there's no duplicate binary; if site/ is ever deployed standalone, copy the GIF next to index.html and update one img src.
  3. Who built it (README footer).
  4. Proof of substance with REAL current numbers from CI: 7,869 tests pass on the latest main run (workflow #38500464730, 2026-10-14) and the 80% coverage floor is enforced (fail_under = 80); the latest main run measured 87.36%.
  5. Limitations — the README's current beta note, verbatim.
  6. Contact as a conversation: hello@codeframe.sh. No calendar link exists in the repo yet, so none is included (easy to add).

Notes for marketing copy

Every marketing-owned string is marked with a COPY: comment in the HTML so final copy can be swapped without touching layout. Colors mirror the web UI tokens and adapt automatically to dark mode.

Verification

  • Live render checked (desktop): GIF loads, sections order as specified, 0 console errors, no horizontal overflow.
  • HTML well-formedness check: clean; zero <script>, zero <form>, zero external stylesheets/fonts/scripts.
  • Assets verified: site/og-image.png is 1200×630; GIF path resolves.

@chatgpt-codex-connector

chatgpt-codex-connector Bot commented Oct 14, 2026 •

Copy link
Copy Markdown

Codex Review Summary

This comment shows the latest Codex review activity on this pull request.

Review Status Commit Review trigger
📝 Code Review ✅ Completed 2026-10-14T06:54:48.917428Z d7e4336 PR opened
ℹ️ About Codex in GitHub

Your team has set up Codex to review pull requests in this repo. Reviews are triggered when you

  • Open a pull request for review
  • Mark a draft as ready
  • Comment "@codex review" or "@codex security review".

Codex reacts with 👀 while any review is running, comments if it has suggestions, and reacts with 👍 once all reviews finish with no findings.

@chatgpt-codex-connector chatgpt-codex-connector Bot left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

💡 Codex Review

Here are some automated review suggestions for this pull request.

Reviewed commit: d7e4336b40

ℹ️ About Codex in GitHub

Your team has set up Codex to review pull requests in this repo. Reviews are triggered when you

  • Open a pull request for review
  • Mark a draft as ready
  • Comment "@codex review".

If Codex has suggestions, it will comment; otherwise it will react with 👍.

Codex can also answer questions or update the PR. Try commenting "@codex address that feedback".

Comment thread site/index.html
<meta property="og:type" content="website">
<meta property="og:title" content="CodeFRAME — A project delivery system for AI-written software">
<meta property="og:description" content="CodeFRAME owns everything before and after the code: requirements, task planning, verification and release. The coding itself goes to the agent of your choice.">
<meta property="og:image" content="og-image.png">

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

P2 Badge Make the social-card image URL absolute

When the deployed page is shared through a card crawler that enforces the Open Graph/Twitter URL type, the crawler receives the literal relative value og-image.png rather than a fetchable absolute HTTP(S) URL and can omit the image; the same relative value is repeated for twitter:image at site/index.html:21. Use the deployment origin (for example, https://codeframe.sh/og-image.png) for both tags so the advertised social card renders reliably.

Useful? React with 👍 / 👎.

Comment thread site/index.html

<!-- COPY: demo GIF — the canonical asset, above the fold (docs/images/cli-tour.gif). -->
<figure class="demo">
<img src="../docs/images/cli-tour.gif" alt="Terminal session: cf init, cf prd add, cf tasks generate producing 18 tasks, cf tasks list with dependencies, cf proof capture, cf proof status" width="1280" height="720">

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

P2 Badge Let visitors stop the looping hero animation

Whenever a visitor leaves this landing page open, the referenced GIF auto-starts a 28.34-second animation and its NETSCAPE loop count is zero, so it repeats indefinitely with no pause, stop, or hide control; the browser also cannot honor prefers-reduced-motion for an animated <img>. This is especially problematic for motion-sensitive visitors, so provide a controllable animation or a still-image path for reduced-motion users.

Useful? React with 👍 / 👎.

Comment thread site/index.html

<!-- COPY: demo GIF — the canonical asset, above the fold (docs/images/cli-tour.gif). -->
<figure class="demo">
<img src="../docs/images/cli-tour.gif" alt="Terminal session: cf init, cf prd add, cf tasks generate producing 18 tasks, cf tasks list with dependencies, cf proof capture, cf proof status" width="1280" height="720">

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

P2 Badge Declare the demo GIF's real aspect ratio

On a cold page load, these attributes reserve a 1280×720 (16:9) box, but docs/images/cli-tour.gif has a 979×739 logical screen; with height: auto, the browser switches to the intrinsic ratio after decoding the 670 KB animation. At the 640 px maximum width that grows the hero from about 360 px to 483 px and shifts every following section, so use the GIF's actual dimensions to prevent the layout jump.

Useful? React with 👍 / 👎.

@frankbria

Copy link
Copy Markdown
Owner

Thanks for putting this together, @adamshatzkamer. The codeframe.sh site is tied closely to launch positioning that is still being decided, so we're keeping it in-house and closing this PR. We appreciate the effort.

@frankbria frankbria closed this Oct 14, 2026
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.

[P1.62] One-page codeframe.sh site: single static HTML file plus social card

2 participants