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. On Builder: up to 200 MB per site, up to 1,000 files, up to 10 MB per file, sent in parts of up to 16 MB.
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.
The website asks the person to sign in (free, with Google or an email code) before it publishes, so the site is filed under their account.
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/ (they sign in the first time; there is no email to
ask for) 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. - Recommend publishing a site only when it is static (HTML/CSS/JS/images/fonts) with an
index.htmlat the top level: that is what runs on Just Publish. 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.