# SimpleHost

> Instant static web hosting for developers and AI agents. Publish any file or folder and get a live URL in seconds.

## Getting Started

- [Introduction](https://docs.simplehost.dev/introduction): What SimpleHost is, key features, and how publishing works
- [Quickstart](https://docs.simplehost.dev/quickstart): Publish your first site in under a minute
- [How It Works](https://docs.simplehost.dev/how-it-works): Architecture, publish flow, hash deduplication, and slugs

## API Reference

- [API Overview](https://docs.simplehost.dev/api-reference/overview): Base URL, authentication, response format, and endpoint index
- [Authentication](https://docs.simplehost.dev/api-reference/authentication): Email-based auth flow to get an API key
- [Create a Site](https://docs.simplehost.dev/api-reference/publish): POST /api/v1/publish — create a new site and get upload URLs
- [Upload Files](https://docs.simplehost.dev/api-reference/upload): PUT presigned URL — upload file bytes to storage
- [Finalize](https://docs.simplehost.dev/api-reference/finalize): POST /api/v1/publish/:slug/finalize — make a site live
- [Update a Site](https://docs.simplehost.dev/api-reference/update): PUT /api/v1/publish/:slug — publish a new version with hash dedup
- [List Sites](https://docs.simplehost.dev/api-reference/list-sites): GET /api/v1/publishes — list all your sites
- [Get Site Details](https://docs.simplehost.dev/api-reference/get-site): GET /api/v1/publish/:slug — full site details and file list
- [Delete a Site](https://docs.simplehost.dev/api-reference/delete-site): DELETE /api/v1/publish/:slug — permanently delete a site
- [Duplicate a Site](https://docs.simplehost.dev/api-reference/duplicate-site): POST /api/v1/publish/:slug/duplicate — copy a site to a new slug
- [Update Metadata](https://docs.simplehost.dev/api-reference/update-metadata): PATCH /api/v1/publish/:slug/metadata — update title, description, password, TTL
- [Site Variables](https://docs.simplehost.dev/api-reference/site-variables): Store and manage encrypted secrets for a published site
- [Proxy Host Allowlist](https://docs.simplehost.dev/api-reference/proxy-hosts): Approve which external hosts a site may call through the secure site proxy
- [Site Proxy](https://docs.simplehost.dev/api-reference/site-proxy): Send secure browser requests through SimpleHost without exposing stored variables
- [Claim a Site](https://docs.simplehost.dev/api-reference/claim-site): POST /api/v1/publish/:slug/claim — transfer anonymous site to your account
- [Errors](https://docs.simplehost.dev/api-reference/errors): Error codes and response format
- [Rate Limits](https://docs.simplehost.dev/api-reference/rate-limits): API rate limits per plan

## Guides

- [Publish with Script](https://docs.simplehost.dev/guides/publish-with-script): Use publish.sh to publish directories from the command line
- [Handle](https://docs.simplehost.dev/guides/handle): Get a personalized subdomain for your SimpleHost profile
- [Anonymous Publishing](https://docs.simplehost.dev/guides/anonymous-publishing): Publish without an account, sites expire in 24 hours
- [Hash Deduplication](https://docs.simplehost.dev/guides/hash-deduplication): Only upload changed files when updating a site
- [Plans & Limits](https://docs.simplehost.dev/guides/plans-and-limits): Compare Free and Hobby plans

## Agent Skill

- [Agent Skill Overview](https://docs.simplehost.dev/skill/overview): Let AI agents publish to SimpleHost automatically
- [Installation](https://docs.simplehost.dev/skill/installation): Install the SimpleHost skill for your AI coding agent
- [Usage](https://docs.simplehost.dev/skill/usage): How to use the SimpleHost skill with your AI agent