← Files anewARCHIVED FILE

GEMINI.md

2.21 KB · Nov 21, 2026 · 12:27 UTC

↓ Download file

See the change to this file →

# anew.page

anew.page turns a self-contained HTML document into a shareable URL. The URL *is* the
page — the HTML is compressed into the link itself. Nothing is stored server-side.

## Tools

- `anew_write` — HTML in, an anew.page URL out.
- `anew_read` — an anew.page URL in, the HTML encoded in it out.

Both are read-only: writing a page never mutates anything that already exists. Each
encoding path is deterministic, so the same HTML through the same path mints the same
URL; different paths may mint different, equally valid URLs, so compare pages by their
decoded HTML and never by slug.

## Writing a page

Inline everything — CSS, JS, images (data: URIs, inline SVG, CSS gradients, emoji). A page
that reaches out to another host is a page that dies when that host does. The one accepted
exception is a webfont too large to inline; load it from a durable CDN behind a system-stack
fallback.

There is no size limit below the physical ceilings (65000 URL bytes, 163839 decoded bytes),
only a strong warning: a URL over 4000 bytes (or a page over 160000 UTF-8 bytes) still mints,
renders and serves, and the response says the link may break when shared. Deliver the URL as
minted and tell the person; whether to shorten it is their decision — never remove content to
clear a warning without asking.
Brotli puts a typical page in a few hundred URL bytes, so pages that look far too large
routinely fit. Never estimate the compressed size and never trim page content to make room
before you have tried the write — Brotli is non-linear, and source bytes removed are not URL
bytes saved. Measure by writing, then read the error if one comes back; it names the exact
overage and the fix.

## Revising a page

A page's URL is its source. Read it, edit the HTML, write it again. The new URL is a separate
page; the original keeps working.

Never invent, guess or retype a slug: carry the URL verbatim from the response that minted
it — a dropped or altered character kills or changes the page.
Deliver the URL exactly as produced, as `[anew.page link](<https://anew.page/SLUG>)` — the
angle brackets stop chat clients bending the slug's `-` into a smart dash.

Full recipe, including the plain-HTTP and local-mint paths: https://anew.page/llms.txt

SHA-256: de21269b5c75d49a5054eaa1cb7a58421985e09054421f94c14e1517f5477727