Deploying Apps

Deploying pushes your app’s artifacts to the Falcon platform. A deployment must succeed before you can release or install the app.

Deploy from the Falcon console

1. In the App Builder, click Deploy in the toolbar.
2. Review the deployment summary showing which capabilities will be deployed.
3. Click Deploy.

The console shows deployment progress. If deployment fails, review the error details and correct the issue before retrying.

Deploy from the CLI

foundry apps deploy

The CLI validates your manifest.yml, builds all artifacts (functions, UI bundles, etc.), and uploads them to your CID.

Deployment modes

Mode	Description
Standard deployment	Full deployment of all app capabilities. Required before releasing.
Development mode	Loads your in-progress app in the Falcon console for real-time testing. Only visible to you.
Preview mode	After deploying, preview the app as end users will see it before releasing.

Troubleshooting deployment failures

Common deployment issues:

• Manifest validation errors — Check your manifest.yml for syntax errors or missing required fields.
• Function build failures — Ensure dependencies are correctly specified and code compiles.
• Scope conflicts — Verify your API client has the scopes required by your app’s capabilities.
• UI build failures — Check that your UI code compiles and all referenced assets exist.

After fixing issues, retry the deployment. Each deployment creates a new version — failed deployments do not affect your previously released version.