> This page is for Webflow Cloud. > For clean Markdown of any page, append .md to the page URL. > For a complete documentation index, see https://developers.webflow.com/llms.txt. > For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://developers.webflow.com/_mcp/server. # Getting started > Build and deploy your first Webflow Cloud app In this guide, you'll use the Webflow Cloud deploy wizard to create a new app from an Astro or Next.js starter template. The wizard clones the template into your GitHub account, creates the Webflow Cloud app, configures the first environment, and starts the first deployment. **Time Estimate:** 10 minutes **Prerequisites:** * A Webflow account * A GitHub account * Permission to create apps in your Webflow Workspace * Permission to install the Webflow Cloud GitHub App on the GitHub account or organization where you want to create the repository ## Fast path: one-click deploy To create an app from a ready-to-deploy Astro starter quickly, click this button and follow the steps to deploy it to Webflow Cloud: [![Deploy to Webflow](https://webflow.com/img/deploy-dark.svg)](https://webflow.com/dashboard/cloud/deploy?repo=https%3A%2F%2Fgithub.com%2FWebflow-Examples%2Fhello-world-astro-minimal\&branch=main\&sourceKind=starter-template\&framework=Astro\&templateFramework=Astro\&repoName=hello-world-astro) The deploy wizard opens with the repository, branch, app name, mount path, and framework prefilled. You can review the configuration, connect GitHub if needed, and deploy the app. ## Getting started Follow these steps to deploy an application from a starter template with the Webflow Cloud deploy wizard. ### 1. Open the deploy wizard You can go directly to the deploy wizard by clicking [this link](https://webflow.com/dashboard/cloud/deploy). Or, from your Webflow Dashboard, open the Workspace where you want to create the app and click **Create app**. In an empty Workspace, click **Deploy app**. This opens the Webflow Cloud deploy wizard. ### 2. Connect GitHub Click **Login to GitHub** and authorize Webflow Cloud. When prompted, install the Webflow Cloud GitHub App for the account or organization where the new template repository should be created. For a security-oriented breakdown of each GitHub permission, see [GitHub App permissions](/webflow-cloud/github-app-permissions). ![The Webflow Cloud deploy wizard showing the Connect GitHub prompt](/_fern-img/3a9edb422e586e7f7e8b654441816306b45fe709acbc657d8653ce8705df716e.webp) ### 3. Clone a starter template In the deploy wizard, open **Clone a starter template** and choose either the Astro or Next.js starter template. These templates are ready to deploy on Webflow Cloud. ![The Webflow Cloud deploy wizard showing Astro and Next.js starter templates](/_fern-img/823fa8a75ff2b98e48a85a2402851d728ffcb2c07a926bd31b8e83fb88354f2a.webp) ### 4. Configure the new app Enter an app name, choose the Webflow Workspace, and select the GitHub account or organization where Webflow Cloud should create the repository. For a first app, choose **New domain** as the deployment target. This creates a standalone Webflow Cloud app with its own domain. > **Note** > > To deploy the template onto an existing Webflow site instead, choose **Existing site** and enter a mount path such as `/app`. ![The Webflow Cloud deploy wizard showing repository and app configuration](/_fern-img/5ab4c89df7cbb19ff734e25e07a1371fe7723fc5a3cf28a56d6eb654fd3f8f47.webp) ### 5. Deploy the app Click **Deploy**. Webflow Cloud clones the starter template into the selected GitHub account or organization, creates the app and environment, and starts the first deployment. If GitHub asks you to grant repository permissions during deployment, approve the request and retry the deployment. ### 6. View and manage your app When the deployment succeeds, open the deployed app from the success screen or manage it from the Webflow Cloud dashboard. Future pushes to the deployed branch will start new deployments automatically. ## Start from a starter app The deploy wizard's built-in templates cover Astro and Next.js. For any other framework, or if you'd rather clone a repo yourself, Webflow keeps an official starter for each supported framework in the [Webflow-Examples](https://github.com/Webflow-Examples) org. Each one comes in two versions: * **Starter** is the framework, a landing page, and the configuration Webflow Cloud needs. Nothing else. * **With bindings** is the same app with a SQLite database, object storage, and key-value storage already set up, plus a page that shows them working. Start here if you know you'll need storage. | Framework | Starter | With bindings | | ----------------- | ---------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------- | | Next.js 16 | [`hello-world-next-app`](https://github.com/Webflow-Examples/hello-world-next-app/tree/v16) | [with bindings](https://github.com/Webflow-Examples/hello-world-next-app/tree/v16-with-bindings) | | Astro 7 | [`hello-world-astro-app`](https://github.com/Webflow-Examples/hello-world-astro-app/tree/v7) | [with bindings](https://github.com/Webflow-Examples/hello-world-astro-app/tree/v7-with-bindings) | | React 19 | [`hello-world-react-app`](https://github.com/Webflow-Examples/hello-world-react-app/tree/v19) | [with bindings](https://github.com/Webflow-Examples/hello-world-react-app/tree/v19-with-bindings) | | Vue 3 | [`hello-world-vue-app`](https://github.com/Webflow-Examples/hello-world-vue-app/tree/v3) | [with bindings](https://github.com/Webflow-Examples/hello-world-vue-app/tree/v3-with-bindings) | | Svelte 5 | [`hello-world-svelte-app`](https://github.com/Webflow-Examples/hello-world-svelte-app/tree/v5) | [with bindings](https://github.com/Webflow-Examples/hello-world-svelte-app/tree/v5-with-bindings) | | Vanilla JS | [`hello-world-js-app`](https://github.com/Webflow-Examples/hello-world-js-app/tree/v6) | [with bindings](https://github.com/Webflow-Examples/hello-world-js-app/tree/v6-with-bindings) | | Static (no build) | [`hello-world-static-app`](https://github.com/Webflow-Examples/hello-world-static-app) | — | To deploy one, point the [deploy wizard](https://webflow.com/dashboard/cloud/deploy) at the repo, or clone it and run `webflow cloud deploy` from the app directory. Need an older framework version? Each repo keeps them on `vN` branches. For example, Astro 5 and 6 live on the `v5` and `v6` branches of `hello-world-astro-app`. To add error tracking, see [Sentry](/webflow-cloud/sentry). Each starter has a ready-to-deploy `sentry` branch. ## Next steps Now that you've deployed your first Webflow Cloud app, here's what you can do next. #### [Bring your own app](/webflow-cloud/bring-your-own-app) Configure an existing Astro or Next.js app for Webflow Cloud. #### [Deploy with one click](/webflow-cloud/deploy-button) Create a deploy button for a GitHub repository. #### [Manage environments](/webflow-cloud/environments) Learn how environments map branches to deployed app paths. ## Troubleshooting #### A deployment doesn't start when I push to my GitHub repository The [Webflow Cloud GitHub App](https://github.com/apps/webflow-cloud/installations/select_target) may not have access to your repository. Open the app or environment settings in Webflow Cloud and install or update the GitHub App permissions for the repository. For what each permission is used for, see [GitHub App permissions](/webflow-cloud/github-app-permissions). #### My deployment failed Open the environment and review the [build logs](/webflow-cloud/deployments#build-logs). If GitHub asks you to grant repository permissions during the first deployment, approve the request and retry the deployment. See [GitHub App permissions](/webflow-cloud/github-app-permissions) for a security-oriented breakdown of each scope. #### I'm seeing a 404 error when I try to access an app For an app on its own domain, verify that the latest deployment succeeded.