Skip to content

[Docs] Host and publish the user guide (Cloudflare Pages / domain) #61

Description

@chtnnh

Summary

User-facing docs are landing in-repo as an Astro Starlight site (website/, see #11). This issue tracks publishing that site — domain, Cloudflare Pages (or equivalent), CI deploy, and who owns DNS/access.

Needs co-ordination with @ni5arga (repo owner / ops).

Why separate from #11

#11 is content and docs-as-code. Hosting needs maintainer decisions: which account hosts Pages, custom domain (if any), whether downloads/checksums live on the same origin, and who can trigger deploys.

Proposed setup (open to change)

  • Build: website/ Astro Starlight on push to main (rootDirectory website)
  • Host: Cloudflare Pages (static; easy to mirror)
  • CI: GitHub Action or Cloudflare’s Git integration
  • Trust: signed APK/IPA (or TestFlight) + checksums when distribution starts; keep “only trust a build you compiled or one from a source you trust” on the site

Decisions needed from maintainer

  • Cloudflare account / Pages project (or alternate host)
  • Custom domain vs *.pages.dev for now
  • Deploy from main only, or also PR previews
  • Whether the site will host binaries or only link to GitHub Releases

Done when

Metadata

Metadata

Assignees

No one assigned

    Labels

    No labels
    No labels

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions