Get started with Snowflake App Runtime¶
Build an app, deploy it, and share it with other roles. Follow the guide for the way you want to build:
- Snowsight Workspaces (Public Preview): build in the browser with nothing to install.
- Cortex Code: describe the app, and the agent builds, tests, and deploys it.
- Snowflake CLI: deploy code you already have
with
snow appcommands.
For a guided walkthrough, see the Getting started with Snowflake App Runtime quickstart.
Before you begin¶
- Use a paid Snowflake account. Trial accounts don’t support App Runtime.
- To share apps, ask an account administrator to complete account setup once. Until then, you deploy to your personal database, and you can’t share apps from there.
Workspaces runs in Snowsight, so there’s nothing to install. To build on your machine instead, install:
- Cortex Code CLI or
Cortex Code Desktop,
if you want the agent to build the app. Both include the
snowflake-appsskill. - The Snowflake CLI, with a
connection.
If you already have it, run
snow upgradeto get the latest release. - Node.js 22 or later for Node.js apps, or Python 3.13 for Python apps.
Build in Snowsight Workspaces¶
Build, preview, and deploy in the browser. For how preview works and how to configure it, see Develop Snowflake App Runtime apps in Snowsight Workspaces.
- In the navigation menu, select Projects » Workspaces. In the file explorer, select + Add new » Next.js App, and name the folder. To build with an agent, ask Cortex Code in Snowsight instead.
- Select Preview. Snowflake installs dependencies and starts a dev server, and your edits reload the running app.
- Select Deploy.
- Open the app at its URL, then share it.
To redeploy changes, select Deploy again.
Build with Cortex Code¶
Describe the app with the
snowflake-apps
skill:
Name the skill in your prompt:
Type / in chat, select snowflake-apps, and describe the app, or use the
Build an app starter card:
For other ways to start, see entry points.
Cortex Code creates a Next.js project with a working UI, Snowflake data access,
and an app.yml manifest.
Then continue in chat:
-
Ask it to run the app:
Run the dev server and open it in my browser. In Cortex Code Desktop, the Agent Browser shows a live preview. Describe changes in chat to update the app. -
Ask it to deploy:
Deploy this app. Cortex Code runssnow app deployand gives you the app’s URL. -
Ask it to open the app:
Open the app. In Cortex Code Desktop, you can also use the Apps view. -
Ask it to share the app:
Share this app with the ANALYST role. See Share the app.
To redeploy changes, describe them and ask Cortex Code to redeploy.
Build with the Snowflake CLI¶
-
From your project directory, generate an
app.ymlmanifest:Setup uses the account defaults from account setup, or your personal database if they aren’t set. To choose the destination, pass
--database,--schema, or--warehouse. To see the result without writing the file, pass--dry-run. If the project has asnowflake.yml, see Migrate from snowflake.yml to app.yml. -
Add the
install,build, andruncommands for your language. See Build a Node.js app for Snowflake App Runtime or Build a Python app for Snowflake App Runtime. -
Run the dev server locally, for example
npm run dev. To check the project before you deploy, runsnow app validate. -
Deploy the app. The command prints the app’s URL:
-
Open the app:
To redeploy changes, run snow app deploy again.
Deploy details¶
A deploy uploads the project, builds it, and starts the app at a URL that stays the same across redeploys. Each deploy creates a new version. For what each phase does, see Deploy an app to Snowflake App Runtime.
To run the app on serverless compute
(Public Preview), set compute_resource: SERVERLESS in app.yml before you
deploy.
If a deploy fails, see Retry a failed deploy and Troubleshoot Snowflake App Runtime apps.
Share the app¶
To let another role open the app, grant it USAGE on the database, schema, and
Application Service:
To share from Snowsight instead:
- In Snowsight, select Apps » App Runtime admin.
- On the app’s card, select Share. You can also open the app and select the Sharing tab.
- Under Account roles, select Add role, choose the role, and select Save.
Send the URL to users who hold the role. They open it and sign in to Snowflake. For more patterns, see Share a Snowflake App Runtime app.
Next steps¶
- Query Snowflake from your app: Query Snowflake from a Snowflake App Runtime app.
- Learn what Snowflake provides to the running app: Runtime environment for Snowflake App Runtime apps.
- See every
snow appcommand: Snowflake App Runtime CLI commands.