Files and storage

Files show up in two places in Vaulter, and they behave differently in each: files you attach to a chat message, and assets that are part of your app. Knowing which is which saves confusion about where things went and who can see them.

1. Chat attachments: context for the agent

You can attach up to 4 files per message, 8 MB each, to any chat message. These are input for the agent, not part of your app:

• Images (PNG, JPG, GIF, WebP): screenshots of bugs, designs to match, photos to use. Showing beats describing; this is the highest-leverage habit in the prompting guide.
• Documents (PDF, Word, plain text): specs, copy decks, requirements.
• Spreadsheets (CSV, XLSX, XLS): the agent reads the columns and sample rows, which makes "build me a dashboard for this data" work in one message.

If a spreadsheet is rejected as unsupported, check the file actually ends in .csv, .xlsx, or .xls; browsers sometimes report unhelpful types, and the extension is what rescues them.

When you attach an image and ask for it to be used in the app ("use this as the hero image"), Vaulter promotes it into your app's asset store automatically, so one message does both jobs.

2. App assets: images that ship with your app

Vault → Storage is your app's media library for images (PNG, JPG, GIF, WebP, SVG): upload, copy URLs, rename, and delete. Anything here is available to your app in the preview and the published version alike, and the agent can see the list, so "put the logo I uploaded in the header" works by name.

Asset upload size follows your plan: 10 MB on Free, 50 MB on Starter, 100 MB on Pro and Teams. Oversized files are refused with a clear message.

Files your app's users upload

Apps cannot yet take file uploads from their own users (a profile photo, a document on a case). If you ask for one, the agent will tell you it is not available rather than build an upload button that cannot work. Images you upload as the builder, in Vault → Storage, work today.

Frequently asked

What image format should I use for logos and photos?

PNG or WebP for logos and anything with sharp edges or transparency, JPG or WebP for photos. Keep files under a megabyte or two where you can; the biggest single cause of a slow-feeling app is multi-megabyte images.

Can I replace an asset and keep the same URL?

Asset filenames are unique per upload, so upload the new version and ask the agent to switch to it (or point Edit Mode at the image). That also means a stale cached copy can never mask your update.

A file type I need is not accepted

Chat attachments accept the types listed above. For anything else, the content usually travels another way: paste text directly into chat, or convert the file.