Skip to content

Download surface for the macOS companion - #170

Merged
pratikbodkhe merged 1 commit into
mainfrom
feat/download-page
Jul 19, 2026
Merged

Download surface for the macOS companion#170
pratikbodkhe merged 1 commit into
mainfrom
feat/download-page

Conversation

@pratikbodkhe

Copy link
Copy Markdown
Contributor

Adds /download on getminutia.com.

  • Resolves the newest DMG from the GitHub Releases API at request time (ISR, 5-minute revalidate). With no release published (true today), the page degrades to an honest coming-soon state: "Watch for the release" pointing at GitHub Releases plus a signup CTA. No dead buttons, no fabricated status.
  • 404 from releases/latest is the one expected, silent degradation; every other failure (rate limit, 5xx, malformed body, missing tag) logs with rate-limit context so a broken resolver cannot masquerade as "no release yet". GITHUB_TOKEN is attached when configured.
  • /download added to middleware public paths; it previously redirected logged-out visitors to /login.
  • Landing page CTA and the signed-in companion install prompt both route through /download, centralizing degradation in one place.
  • Sitemap entry, page metadata, and the public-route smoke check updated.

Copy verified against the desktop repo: macOS 14.4+, universal binary. Two independent reviews (spec + silent-failure); all findings fixed: resolver observability, 300s revalidate bound on transient-failure cache pinning, honest version handling, truthful coming-soon copy.

/download resolves the newest DMG from GitHub Releases at request time
(5-minute revalidate) and degrades to an honest coming-soon state while
no release exists, so the page never links a 404 or claims a build that
is not there. 404 is the one silent degradation; every other resolver
failure logs with rate-limit context, and GITHUB_TOKEN is used when set.
/download joins the middleware public paths (it previously bounced
logged-out visitors to /login), the landing page and the in-app
companion install prompt route through it, and it lands in the sitemap
and the public-route smoke check.
@pratikbodkhe
pratikbodkhe merged commit 14d2de4 into main Jul 19, 2026
16 of 18 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