Commit

README.md

@@ -22,6 +22,14 @@ bun run preview    # serve dist/
 | Theme tokens | top of `src/styles/global.css` |
 | Pages | `src/pages/` |
 
+### Direct downloads
+
+Every download button links straight to the file (`platforms.linux.url` in `src/config.ts`), with no
+intermediate page. Only visitors on Windows, macOS or a phone are sent to `/download/`, because the
+Linux AppImage is no use to them yet. Point `url` at any direct file URL. By default it is the GitHub
+Releases asset, which is a plain download link. Don't host the 157 MB file with the site itself on
+GitHub Pages (100 MB per-file limit) or Cloudflare Pages (25 MB); use Releases, R2/S3 or a CDN.
+
 ### Releasing a new version
 
 1. Build the app (`bun run dist` in the Ink repo) and upload the AppImage to your release page.