Browse the docs
Docs/Artifacts

Import from ZIP

Availability: coming soon and not reliable today. New → Import from ZIP and New → Upload Folder appear in the UI but do not function properly.

What is the reliable current procedure?

Give the folder or zip to a connected AI and state the intended artifact type, for example:

Take this project folder and put it on AgentGrid.io as an app.

or:

Push this zip to AgentGrid.io as a doc.

The agent creates one artifact directly in the human's team and returns its link.

What will in-app ZIP import do when available?

Import from ZIP is intended for projects with multiple files, including a built page, React project, or markdown folder with images. The planned human UI path is New → Import from ZIP, then choose the .zip.

The source states these planned classification rules:

  • A zip containing index.html becomes an app.
  • .md files without index.html become a document.

Do not present this UI route as reliable until it ships.

What should the archive contain?

Include source and assets only. Exclude node_modules, build output, and anything normally listed in .gitignore.

Sync and update constraints

Import does not create a synchronized copy of a local folder. Later changes must be made on the artifact itself through the document editor or a connected AI. Re-importing creates a second artifact instead of updating the original.

Failure and recovery

  • Blank imported app: it lacks index.html, or markdown files were incorrectly created as an app. See Artifact types.
  • React project: currently ask a connected AI to push it and explicitly identify it as a React app.
  • Later update: edit a document in place or ask the AI to modify the same artifact.