framejs.io

Appearance

Worker ​

The worker is a Deno backend using the Hono framework. It serves the static frontend and handles routing.

Location ​

worker/
├── server.ts
├── deno.json
├── deno.lock
├── index.html
├── sw.js              # Service worker
├── static/
└── ...

Key details ​

  • Uses Deno URL imports + npm: specifiers for npm packages
  • Type checking: just worker/check (runs deno check server.ts)
  • Formatting: just worker/fmt (runs deno fmt)
  • Deployed to Deno Deploy

Analytics (optional) ​

The worker can send cookieless, server-side usage analytics to a Umami instance (cloud or self-hosted). It is a no-op unless both env vars are set:

bash
UMAMI_HOST=https://cloud.umami.is   # or your self-hosted Umami URL
UMAMI_WEBSITE_ID=<website-uuid>     # from the Umami dashboard

See worker/src/analytics.ts. Pageviews are tracked on GET / and GET /j/:sha256; custom events shorten and fetch are tracked on the short-URL API endpoints, each with a source property (skill | browser | api-other) so AI-agent/skill usage can be segmented from web-editor usage. The framejs Agent Skill identifies itself with an X-Framejs-Client: skill/1.0 header. No cookies are set and no consent banner is required.

Development ​

The worker runs as part of the full dev stack:

bash
just dev

To type-check:

bash
just worker/check