August 31, 2026: app.yml for Snowflake App Runtime (Preview)

Snowflake App Runtime projects use a single app.yml file to describe both deployment and the remote build. Include version: 2 at the top of the file. snow app setup writes this file for new projects.

Use the latest Snowflake CLI. Run snow helpers check-version and upgrade if that command is missing or reports an older release. An older CLI ignores the deployment keys in app.yml and still expects snowflake.yml.

You can optionally declare named targets when one project needs more than one deploy configuration, then select one with --target. That covers a development, stage, and production lifecycle, deploying to several accounts with slightly different configuration, or variants of one app for different audiences. Set database: USER$ so a target deploys into the caller’s personal database.

If your project still uses snowflake.yml plus a build-only app.yml, move it to a single app.yml. The switch isn’t a rename: deploys become one CREATE OR ALTER APPLICATION SERVICE that matches the manifest; a leftover profile: block is ignored; database and schema no longer fall back to your connection; and the remote build no longer copies Next.js standalone assets for you. See Migrate from snowflake.yml to app.yml.

Snowflake App Runtime remains in Open preview.

For more information, see: