# ShareFast

ShareFast publishes generated artifacts as review-ready Drops. Use it for standalone HTML, Markdown review notes, zip packages, or built static folders when a user needs a reviewer-facing URL.

Canonical docs:
- Agent publish guide: https://sharefast.app/docs/agents/sharefast-publish
- Publish API: https://sharefast.app/api/publish
- Legacy agent publish alias: https://sharefast.app/api/agent/publish

Preferred CLI:
- npx -y sharefast ARTIFACT.html
- npx -y sharefast REVIEW-NOTES.md
- npx -y sharefast dist/

Agent rules:
- Share only the returned reviewer URL by default.
- Keep raw_url private unless the user asks for debug output.
- Keep revision_key private. Use it only to publish a new Drop Revision to the same Drop URL.
- A Drop URL is stable. Each Drop Revision is immutable, and the Drop points to one Current Revision.
- Respect Access Policy checks, Drop Expiry, and optional Drop Passcodes.
- Do not use ShareFast for databases, backend APIs, custom domains, notebooks, images, or PDFs as publish inputs.

Supported publish inputs:
- .html standalone HTML
- .md or .markdown rendered as a sandboxed HTML Drop Revision
- .zip packages with a root index.html
- folders zipped by the CLI before upload