A self-hosted Cloudflare Worker (Hono, worker/) serving a React app (src/) that helps a GitHub user organise their stars and watch their own repos. shared/ is imported by both sides, so it stays free of Worker and DOM APIs.
- Product decisions and copy: read
PRODUCT.md. - UI changes: read
DESIGN.mdfirst, and update it in the same change when you add or alter a component or pattern.
- Each
Backendmethod (src/lib/api.ts) also has a demo version insrc/lib/demo.tsordemo-own.ts. It returns plausible generated data and never calls GitHub. - Each schema change is a new file in
migrations/; applied migrations stay unchanged. - The cron cleanup in
worker/cron.tsdeletes repos no table references. A new table that references repos joins its exemption list.
- Check UI changes in a browser in demo mode (
/?demo=1, no GitHub login needed) at 1440 and 390 wide. Signed-in paths need a real token; say when one went untested. - Screenshots for docs and PRs come from demo mode only.
- If the dev server serves a blank page after a
vite.config.tschange, restart it.
- A push to
maindeploys to production, so each push bumpsversioninpackage.json(semver: patch for fixes, minor for features). - Allow a deliberate lint exception with a file override in
.oxlintrc.jsonwhose comment gives the reason. vite.config.tsresolves its root and aliases to the on-disk path so a build started fromc:\orC:\bundles each module once (otherwise two React Query copies and "No QueryClient set" on every page).- The logo mark is defined in
src/components/shell.tsxandbrand/make_logo.py, which also writes the favicon, app icons and web manifest intopublic/. Change both, then re-run the script (brand/README.md).