Native Fragments — coding-agent brief
=====================================

Native Fragments builds fast, explicit HTML applications on Cloudflare Workers.
The server owns routes and first render; the browser router upgrades native
navigation; Lit owns interactive islands. Source is standards-based ESM bundled
with esbuild. There is no framework compiler.

Create an app
-------------
  npm create @nativefragments/app@latest my-app
  cd my-app
  npm install
  npm run dev

`npm run dev` builds the ESM entry points and runs the local Cloudflare Worker
with Wrangler. It does not deploy or publish anything.

Read the installed skill
------------------------
  node_modules/@nativefragments/core/skills/nativefragments/SKILL.md

Key files
---------
  worker.js                 Cloudflare Worker entry
  site/routes.js            route manifest
  site/shell.js             persistent document shell
  site/pages/               server HTML renderers
  client/index.js           Lit hydration + startRouter()
  client/components/        Lit custom elements
  public/app/               CSS and static assets
  scripts/build-app.mjs     explicit esbuild step
  wrangler.jsonc            runtime and build configuration

Core imports
------------
  @nativefragments/core/server
  @nativefragments/core/cloudflare
  @nativefragments/core/client/router.js
  @nativefragments/core/client/worker.js
  @nativefragments/lit/server
  @nativefragments/lit/client

Verification
------------
Run `npm run check`, then open the Wrangler URL in a real browser. Verify direct
refresh, link navigation, streamed reveals, back/forward, metadata, focus, and
the console. Never deploy unless the user explicitly asks.

Docs: https://docs.nativefragments.org/llms.txt
Source: https://github.com/somedudeokay/nativefragments