Skip to content
Onplana Docs

Use your files in a build

All plans Member

Your Onplana Maker app can use files you provide, a logo, a hero image, an icon set, or a data file the app reads. Upload them to the project’s Files tab and the agent can reference them in the build. They are served to your app at /assets/<name> and ship with the published site.

Add a file and use it

Section titled “Add a file and use it”

  1. Open the Files tab in your project and click Upload file. Add your image or data file.

  2. Go to Build and tell the agent to use it by name, for example: “use /assets/logo.png as the header logo” or “load the products from /assets/data.csv”.

  3. Build. The agent wires the file in, and you see it in the live preview.

  4. Publish as usual. The files travel into your published onplana.app site, no extra step.

Which files the agent can use

Section titled “Which files the agent can use”
TypeExtensionsUsed in the build?
Imagespng, jpg, jpeg, gif, webp, svg, ico, avifYes
Data / textcsv, json, txt, mdYes
Everything elsepdf, docx, zip, and so onKept in Files, but not served to the app

You can still keep briefs, PDFs, and reference docs in Files, they just stay as project attachments rather than being served to the running app.

Limits

Section titled “Limits”
  • Up to 5 MB per file and 20 MB total across all assets in a build.
  • Up to 25 files are made available to any one build.
  • Files over the limit stay in Files; they are simply not injected into the app.

These limits keep published apps well within the free hosting size, so your app stays fast and publishable.

Files stay with your project

Section titled “Files stay with your project”

Uploaded files, and anything else in the Files tab, stay with the project. When you open your app in the full Onplana workspace, they are in the project’s document library, right where you left them.

FAQs

Section titled “FAQs”

I uploaded a file but the agent is not using it. Tell the agent explicitly which file to use and where, by its /assets/<name> path. Uploading a file makes it available; the agent uses it when you ask.

Can the app read a CSV or JSON at runtime? Yes. Data files (csv, json, txt, md) are served at /assets/<name>, so the app can fetch and parse them.

Do the files count against my credit? No. Uploading files does not spend credit. Only builds and AI edits do.

Section titled “Related”