Skip to main content
Everything you build in Mist is a project. The left nav has a section for each type of project. Click a section to open its page, which shows all your projects of that type.

Project types

Skills you write aren’t in a section of their own. They’re on the Skills page. See Skills.

Create a project

In the left nav, click a section, such as Apps. Then click the button at the top of the page, such as New app. For databases, the button is Connect a database. To work on a portal widget project that’s already on your computer, click Portals, then click Open local widget project. Choose the project’s folder, then click Open project. Opening the project doesn’t run its scripts or create a portal. Running it, installing its dependencies or publishing its widgets can run the project’s code. You can also ask Mist in the chat, for example “Build me an app that lets reps log event attendance”. Mist shows an Approve and Decline card before it creates anything. Shortcuts create the most common types:
  • Cmd+Shift+M: a Mist app
  • Cmd+Shift+T: a theme
  • Cmd+Shift+W: a widget
  • Cmd+Shift+S: a skill
On Windows, use Ctrl instead of Cmd.

Create a Mist app

1

Open New Mist

In the left nav, click Apps, then click New app. You can also press Cmd+Shift+M. The New Mist dialog opens.
2

Name it

Enter a name under Name (optional), such as “Customer Portal”.
3

Pick an app type

If your company has app templates, the dialog shows App type. Leave it on the option marked (default), or pick another template. Without templates, the dialog skips this step.
4

Create it

Click Create Mist. You see Setting up your Mist Cloud environment… while Fluid sets up the app.
Fluid creates a code repository, a database and hosting for the app. The app starts as a Next.js web app, with sign-in to Fluid already built in. Ask Mist to build what you need, then run it on your computer and publish it. See Run and publish. For how a Mist app works under the hood, see Mist apps in the developer docs. To create a Mist app, your role needs the Mist permission that starts with Create new Mist hostings. See Roles. If creating fails, you see We couldn’t finish creating your Mist right now. This is usually temporary, so try again in a moment. If it keeps happening, contact Fluid support.

Manage a Mist app

Right-click a Mist app in the left nav, or click More (⋯) on its card on the Apps page. The same menu is in the bar at the top of the app’s page. It includes:
  • Copy Mist app ID: copy the app’s short ID, such as 3bed85. It’s the slug the Fluid CLI uses.
  • Rename…: change the app’s name.
  • Environment variables…: view and set the app’s environment variables, such as API keys.
  • Domain: connect your own domain to the app. See Connect a domain.
  • Compute: the app’s server settings, saved in the app’s code. It appears once the app is on your computer.
  • Add integration point…: connect the app to Fluid, as a droplet, a drop zone or a mobile embed. See Integration points.
  • Delete…: delete the app. See Delete a Mist app.
You can also see and create your company’s Mist apps in the admin, on Mist Apps.

Connect a domain

1

Open Domain

Right-click the Mist app in the left nav, or click More (⋯), then click Domain.
2

Add your domain

Under Add a domain, enter the domain, such as shop.example.com.
3

Add the DNS records

Add the DNS records Mist shows at your domain provider.
4

Check it

The domain shows Pending verification or Needs DNS routing until the records work, then Live. Click Re-check verification to check again.
To disconnect a domain, click Remove domain.

Delete a Mist app

1

Open Delete

Right-click the Mist app in the left nav, or click More (⋯), then click Delete….
2

Confirm

Type DELETE, then click Delete app.
Fluid schedules the app to be torn down in 15 days. Until then, you can still restore it, and you aren’t charged for it. Mist doesn’t have a restore button yet. If you use the Fluid CLI, run fluid mist restore with the app’s slug. To keep the slug, click Copy Mist app ID before you delete the app. Otherwise, contact Fluid support.

What a Mist app costs

A Mist app is billed by use. Fluid charges for what the app’s server and database use each day, plus a small monthly price for its code repository. The AI that Mist uses while it builds counts as AI usage. Fluid draws these charges from your company’s usage credits. If your credits run out, your live apps keep running, but you can’t create a new one until you buy more. To stop paying for an app, delete it. See Mist app billing.

If something goes wrong

Ask Mist first, for example “Why did my app crash?”. Mist reads the app’s logs and tells you what it finds. For common problems and their fixes, see Troubleshoot a Mist app.