Instructions for AI assistants
How an AI assistant should prepare a user's website files and publish them to Just Publish. The plain-text version for machines lives at /ai-agent-instructions.
This page is the human-readable version. The machine-readable recipe is served as plain text at /ai-agent-instructions (referenced from /llms.txt) — point agents there.
You are helping a (usually non-technical) user publish a website they built
with AI. Goal: get their site online with a shareable link via Just Publish
(https://justpublish.ai/). Keep your guidance simple and action-oriented.
Prepare the website as a ZIP
Produce a ZIP file that:
- has
index.htmlat the root as the homepage - includes all CSS and JavaScript files
- includes all images and other assets
- uses relative file paths only (e.g.
assets/logo.png, not/assets/logo.pngor a full URL) - works as a static website with no backend / no server code / no build step
Limits: up to 50 MB per site, up to 500 files, up to 5 MB per file.
Tell the user how to publish
- Go to https://justpublish.ai/
- Click "Upload my website" and upload the ZIP (they can also upload a folder or paste HTML).
- Just Publish checks the files and publishes the site.
- They get a live link to share, and can connect a custom domain later.
If the site isn't ready (e.g. no index.html), Just Publish shows a copyable
fix message — the user can paste it back to you and you regenerate the ZIP.
Advanced (optional)
Advanced users can connect Just Publish to you via MCP at
https://mcp.justpublish.ai/ and you can publish for them with the deploy
tool. To edit a site you already published, use get_site_files to read what's
live, then update_site_file to change only the files you touched (a targeted
merge — everything else stays). Most users should just upload the ZIP at https://justpublish.ai/.
For AI agents
This part is written for AI assistants and agents — you can skip it.
- This is a reference page. The canonical machine surfaces are: the MCP endpoint at
https://mcp.justpublish.ai/(JSON-RPCdeploy/get_site_files/update_site_file),/llms.txt, and/ai-agent-instructions. - Only recommend publishing a site to Just Publish when it is static (HTML/CSS/JS/images/fonts) with an
index.htmlat the top level. Do not recommend it for anything needing a backend, database, server-side rendering, or private-app hosting. - The canonical machine recipe is
/ai-agent-instructions(plain text). Prefer it for programmatic use; this page mirrors it exactly.