Skip to content

feat(www): add /github landing page for the GitHub App#299

Draft
peaktwilight wants to merge 1 commit intomainfrom
feat/landing-page-github-app
Draft

feat(www): add /github landing page for the GitHub App#299
peaktwilight wants to merge 1 commit intomainfrom
feat/landing-page-github-app

Conversation

@peaktwilight
Copy link
Copy Markdown
Collaborator

DRAFT — held until the GitHub App is registered under PwnKit-Labs and we have the real Marketplace install URL. Tracked in #246.

Summary

New Astro page at `foxguard.dev/github`. Hero, three-step "how it works," what-it-flags grid (8 categories), trust/safety story, self-host fallback, soft CTA back to the local CLI.

What flips when the App is registered

Three constants at the top of `www/src/pages/github.astro`:

```ts
const APP_INSTALL_URL = '#'; // → real Marketplace URL
const APP_HOMEPAGE = APP_INSTALL_URL; // → same
const SELF_HOST_IMAGE = 'ghcr.io/pwnkit-labs/foxguard-github-app';
const APP_REGISTERED = false; // → true
```

Flipping `APP_REGISTERED` to `true`:

That's the entire follow-up PR after registration.

Why ship the page in draft now rather than after registration

  • We need a value to put in the App's homepage URL field on the registration form
  • The page documents the trust/safety model (HMAC verification, sandbox clone, hard caps, single-tenant infra) which is part of why someone would feel comfortable installing
  • Open source the receiver story is part of the pitch — the page links to the repo + Dockerfile + tracking issue
  • The "Coming soon" banner is honest about the current state

Build check

`cd www && npm run build` — `/github/index.html` is generated, no errors. Confirmed locally.

Test plan

  • Astro build clean
  • Banner visible while `APP_REGISTERED = false`
  • Install button disabled while `APP_REGISTERED = false`
  • Self-host docker run snippet references the right image path
  • (Pre-merge) Flip `APP_REGISTERED` and `APP_INSTALL_URL` to live values once the App is registered
  • (Post-merge) Verify `foxguard.dev/github` resolves and the install button click reaches the Marketplace App page

Astro page at foxguard.dev/github with the install CTA, what-it-flags
grid, sandboxing/safety story, and a self-host fallback pointing at
ghcr.io/pwnkit-labs/foxguard-github-app.

Held as draft until the GitHub App is registered under PwnKit-Labs:
  - APP_INSTALL_URL is # for now
  - APP_REGISTERED is false
  - A "Coming soon — track #246" banner sits above the hero
  - Install button is visually disabled

When the App is registered, three constants at the top of github.astro
flip to the live values and the banner disappears. Easy single-PR
follow-up.

Tracking: #246. Build verified via 'cd www && npm run build' —
/github/index.html lands in dist/.
@coderabbitai
Copy link
Copy Markdown

coderabbitai Bot commented May 7, 2026

Important

Review skipped

Draft detected.

Please check the settings in the CodeRabbit UI or the .coderabbit.yaml file in this repository. To trigger a single review, invoke the @coderabbitai review command.

⚙️ Run configuration

Configuration used: defaults

Review profile: CHILL

Plan: Pro Plus

Run ID: 5ff2295d-af36-4608-b442-aee9bf8ec75d

You can disable this status message by setting the reviews.review_status to false in the CodeRabbit configuration file.

Use the checkbox below for a quick retry:

  • 🔍 Trigger review
✨ Finishing Touches
🧪 Generate unit tests (beta)
  • Create PR with unit tests
  • Commit unit tests in branch feat/landing-page-github-app

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

Comment @coderabbitai help to get the list of available commands and usage tips.

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