Troubleshooting
Catalogue visualisation is blank or frozen
- Try a hard refresh; disable aggressive content blockers for this origin.
- Update the browser; WebGL must be enabled.
- Use Browse all on the catalogue toolbar to pick a language without the canvas.
/api/languages.json returns 404
- Confirm the file exists under
public/api/in the deployment. - On some hosts, rewrites matter—open the exact URL linked from For AI tools.
/v1/… returns 404
The public site is static plus a small Cloudflare Worker for /api/agent/*.
/v1/* routes (GET /v1/transfer, etc.) come from the Node server
in this repo when you self-host it. They are not on cachesphere.com unless you deploy that server or proxy it.
The Transfer page on the public site computes hints client-side from /api/languages.json instead.
Hosted agent routes
On cachesphere.com, GET /api/agent/tools should list
select-context-packs, decision-kit, and experiment-context.
If those POST routes fail, check you are hitting the production host and sending JSON bodies — see
For agents.
Preview vs dev
npm run preview serves the built static site. If you need API routes locally, run
npm run dev:api separately. See README “Front end + API together”.
Still stuck?
Email [email protected] with your browser, URL, and what you expected vs saw.