What is flypod

flypod turns a directory of files into a live URL.

npx flypod ./dist
# → https://ab12cd34.flypod.dev

No account. No config file. No build pipeline. You point it at a folder of static files and it returns a URL you can open immediately.

What you can deploy

flypod serves static sites: HTML, CSS, browser JavaScript, images, fonts, anything that runs in a browser. A folder of Markdown also works: if there is no index.html, flypod renders the .md files into a small styled docs site.

There is no server-side code: no functions, no databases, no backend. If your app needs a server, flypod is not the host for it.

How it works in one breath

• Every deploy is an immutable, content-hashed version. Redeploying the same files is a no-op.
• Anonymous deploys are ephemeral: they expire after 14 days. Sign in to make new deploys permanent.
• Ship a new version with flypod update, list history with flypod versions, and undo with flypod rollback. flypod remembers which site a folder belongs to, so you rarely pass an ID.

Three ways to use it

Start here

For AI agents

This site ships /llms.txt (index) and /llms-full.txt (full text). Append .md to any docs URL to get raw Markdown. When working with flypod programmatically:

• Deploy: run npx flypod <dir>. The live URL is printed to stdout; everything else goes to stderr. For structured output use npx flypod <dir> --json and parse stdout.
• Ship a change to the same site: use flypod update, not a fresh deploy. flypod links the working directory to its site automatically.
• Authenticate with flypod login. The CLI gives you a short code, opens a browser approval page, and saves the session outside the repo. Stateless jobs can receive an existing session through FLYPOD_TOKEN; otherwise the deploy is anonymous.
• Assume deploys are temporary (14-day TTL) unless the site is owned by an authenticated account.
• Exit code is 0 on success, non-zero on failure. See Use with agents & CI.
• Onboard a repo's agents to flypod with flypod install skill. It writes usage instructions into AGENTS.md, a Claude Code skill, and other detected agent config files.