framejs-origins

name	framejs-origins
description	Maps the framejs.io / framejs.app origin split between this repo and its sibling framejs-nhost repo, plus each one's local dev address. Load whenever working with cross-app URLs, FRAMEJS_APP_ORIGIN/FRAMEJS_IO_ORIGIN env vars, or debugging requests between the rendering runtime and the account layer.

framejs.io / framejs.app origin map

This repo (metaframe-js) serves framejs.io — the public rendering runtime (uploads, screenshots, the metaframe that actually executes user code). Docker Compose + Traefik stack (worker/).

Its sibling, framejs-nhost, at /Users/dion/dev/git/metapages/framejs-nhost, serves framejs.app — the account layer: auth, frame storage, Hasura/nhost backend (api/) + Deno Fresh worker (frontend/worker/).

App	Repo (this machine)	Production	Local dev
framejs.io	metaframe-js (here)	https://framejs.io	https://framejs-io.localhost:4470
framejs.app	framejs-nhost (.../framejs-nhost)	https://framejs.app	https://framejs-app.localhost:5173

Source of truth, don't hardcode: local ports/hosts can drift from the table above. Check this repo's .env (FRAMEJS_APP_ORIGIN) for what it currently points at for framejs.app, and the sibling repo's frontend/worker/.env (FRAMEJS_IO_ORIGIN) for what it points at here. Both vars are read live by the framejs Agent Skill helper (worker/static/skill/framejs/scripts/framejs.mjs) — see worker/static/skill/README.md for the canonical table and the skill-dev workflow that consumes it.

Run both stacks locally:

• framejs.io (here): just dev → https://framejs-io.localhost:4470
• framejs.app (sibling): cd .../framejs-nhost/api && just dev (nhost stack), then cd frontend/worker && just dev → https://framejs-app.localhost:5173

Both bind dedicated *.localhost hosts (never bare localhost) over HTTPS via mkcert, so the two apps' cookies/sessions don't collide. If a host doesn't resolve, see that repo's _hostcheck justfile recipe.

For the mirror of this file, see framejs-nhost/.claude/skills/framejs-origins/SKILL.md.