AppsGuide

Your first app

An app is files — HTML, CSS, JavaScript, images — that Waiso hosts at an address of its own, such as meu-casamento.waisoapps.app. Its buttons and forms call this project’s scripts and flows, so a page and the work behind it live in one place.

6 min readBefore this: Create a projectOpen in Waiso
What you will learn
  • Create an app and choose its address
  • Fill it by uploading a site or by asking the assistant
  • Preview the draft, publish and restore an earlier version

What an app is

Every app has a draft — the files you change — and, once published, a published version that visitors see. Changing the draft never touches the live app; Publish puts the draft live and keeps the previous version in the history.

There is no drag-and-drop editor: you bring the files (from any tool, a build’s dist/ folder included) or the project assistant writes them for you.

Weddingcasamento.waisoapps.app
PublishedDownloadPublish
CodeHistoryDomainsSettings
Files · 4
index.html2 KB
style.css1 KB
rsvp.js1 KB
fotos/capa.jpg1.8 MB
Drop a .zip or a folder
index.html
1<h1>Bruna & Talisson</h1>2<form id="rsvp">3  <input name="name" placeholder="Seu nome">4  <button>Confirmar presença</button>5</form>6<script src="/_waiso.js"></script>
Draft preview
Bruna & Talisson
12.06.2027 · São Paulo
Your nameConfirm
An app: its files, the code of the chosen file and the draft preview, with Publish on top.

What fits in an app: a landing page for a launch, an event site with a confirmation form, a small portal where clients see their orders, an internal form that feeds a spreadsheet, a page that shows a report a flow builds every morning. Anything a browser can show, as long as the work behind it is a script or a flow of this project.

Create and publish

  1. Open Apps

    In the project’s sidebar, open Apps and press New app. Give it a name; the address is suggested from it and checked as you type.

  2. Add the files

    Drop a .zip or a folder on the file list. A zip that wraps everything in one folder is served from that folder. Or ask the assistant: “make a page with our gift list and a form to confirm attendance”.

  3. Look at the preview

    The preview beside the code shows the draft exactly as visitors would see it.

  4. Publish

    Press Publish. The address serves the new version within a minute.

Files the address serves

A visitor opensWaiso serves
/index.html
/sobresobre, else sobre.html, else sobre/index.html
A path that does not existYour 404.html if there is one — or index.html when Single-page app is on in Settings
  • Up to 5,000 files; a file’s size limit depends on the plan (see Address, domains and limits).
  • Programs for an operating system (.exe, .sh…) are refused: an app is a web page.
  • The same file in many versions or many apps is stored once, so versions cost almost no space.

Versions and download

History lists every published version: who, when, how it came (upload, assistant, edited, restored) and what changed. Restore puts a version live again at once — it becomes a new version, so nothing is lost.

Take it with you

Download gives the files as a zip. Hosted anywhere else, the app keeps calling this project’s endpoints — see Call your scripts and flows.