Getting started
Your projects
Where your apps live: the short list on the dashboard, the All apps window, folders you make yourself, and the trash that holds a deleted app for thirty days.
Every app you build is saved the moment it is written. You never have to save one, and you cannot lose one by closing the page.
There are two places to find them. The dashboard shows the handful you touched most recently, which is the right answer until you have about thirty apps. After that, use the All apps window.
The short list on the dashboard
| Tab | What it shows |
|---|---|
| Search | Filters the apps on this page by name and by what you originally asked for. An app called "app" can still be found by the sentence you wrote. Press Enter to ask the same thing of every app you have. |
| My projects | Yours, most recently edited first, with the starred ones on top. |
| Recently edited | The eight you worked on last, for jumping back to one. |
| Starred | Appears once you have starred something. |
| Recently deleted | Appears once something is in the trash. |
| Templates | Apps other people published as a starting point. |
This page holds your 50 most recent apps, so its search reaches those. When there could be an older one it has not seen, it says how many it searched and offers to look through all of them. Pressing Enter does the same thing: it opens All apps with what you typed already in the box, and that search asks the server.
To start an app that is already built somewhere else, use Import an app: see Import an app.
In the editor
Three small buttons sit together at the top of the editor: New project, My Projects and History. Each one shows its name when you point at it, and the one in use opens into a labelled pill. New project starts a fresh app. My Projects opens the All apps window described below. History opens the versions of the app you are in: see History.
All apps
All apps, at the right of that bar, opens everything at once. In the editor the same window is behind My Projects at the top, so you can look for another app without losing the one you are working on.
Down the left are the sections, each with how many apps are in it. The number is counted by the database, not by what happens to be on screen, so it is true even when you have more apps than the window loads at once.
| Section | What is in it |
|---|---|
| All apps | Everything you have not deleted. |
| Starred | The ones you marked with a star. |
| Published | The ones that are online right now. |
| Last 7 days | What you worked on this week. |
| Recently deleted | The trash. Only appears when there is something in it. |
The list itself is grouped by when each app was last worked on: active in the last 14 days, then earlier, then older still. Sort by Last edited, Created or Name from the button above the list, and switch between cards and rows with the two buttons beside it.
The window loads the 200 most recently edited apps. If you have more, a line at the bottom of the list says so. The search box goes to the server rather than filtering what is loaded, so it finds the older ones too.
Folders
A folder is a name and the apps you put under it. Nothing nests, and an app is in one folder or in none.
Make one
New folder at the bottom of the left column, or Create then New folder. Give it a name and press Create.
Put apps in it
Drag a card onto the folder, or open the three dots on a card and pick the folder under Move to.
Find them again
Click the folder in the left column. Not in a folder shows everything you have not filed yet.
To remove a folder, press the × beside its name. It asks once, and answering removes the folder only: the apps that were in it go back to being unfiled. Losing a folder never loses an app.
If you are in a team, the Create folder window also asks whose the folder is. A personal folder is your own order on your own screen, even for an app the whole team can see. A workspace folder is the opposite on purpose: everyone in that workspace sees it and can file apps into it.
What you can do with one app
The three dots on a card open everything there is to do with it.
| Rename | Type over the name. It saves when you press Enter or click away. |
| Make a copy | A full copy under "Copy of …". The original is untouched. |
| Copy app ID | The app's id, which is what the API and connected assistants ask for. |
| Open the live site | Only when the app is published. |
| App settings | Opens the app, on its settings. |
| Move to | Which folder it is filed under. |
| Move to trash | Asks once, then moves it. Nothing is destroyed here. |
The star on the card is the quickest thing on it. A starred app has its own section here, and sits at the top of the list on the dashboard.
A published app's card also carries a label in its top corner: a green Live, or a red one with the number of errors visitors hit in the last day. Click it for the app's errors and the buttons that fix them: see The errors window.
Several at once
Hover a card and a checkbox appears in its corner. Tick one and a bar comes up from the bottom for everything picked.
| All / None | Picks everything in front of you, then unpicks it. |
| Move to folder | Files all of them at once, or takes them out of any folder. |
| Unpublish | Takes them offline. Only offered when at least one of them is online. The app itself stays. |
| Delete | To the trash. It asks first, and says how many. |
| Cancel | Leave everything as it was. |
Recently deleted
A deleted app is not gone. It waits in Recently deleted for 30 days, with the picture of the app rather than only its name, and the number of days it has left. Put it back returns it to your projects with everything it held. If it was online when you deleted it, put it back and publish it again to return it to the internet.
After 30 days it goes for good, along with the files uploaded to it. Until then nothing is lost.
Deleting a published app takes its site off the internet at the same time. The app waits in the trash and can be brought back, but its site does not come back with it: publishing it again is a separate step. Unpublish on its own does the same to the site and leaves the app where it is.
Put an app on your own domain
Once an app is published, it can answer on a domain you own.
Was this page helpful?
