Deployment overview

image (1).png

Build software

Pushing to the master branch will automatically trigger a build (if there's currently no build running). If you want a different branch built than master, you need to push a (probably empty) commit with the message #build to that branch to trigger Continuous Integration to build it.

Once the build goes through and is successful, you'll receive a commit with the built assets plus a tag in the form YYYY.MM.DD.HH.II, which is your release tag.

Test the build

master builds will be automatically deployed to your staging environment when successful. If you want to deploy a non-master build, you can trigger the deployment to staging in the same way as deploying to production, which is explained in the next step.

Once deployed, you can perform acceptance tests in staging and eventually roll out the new version. The master build for frontend gets deployed automatically to your staging site on Netlify. You can use the staging site to test changes before publishing them to production.


Once you're satisfied with the state of the built assets, you can deploy using the steps below:

  1. Open your studio, click Developer, then Deployment, or use the URL similar to https://<your-project>

c57a4ec Deployment landing page

  1. Click Deploy new version

  2. Select the tag you created in the list and it will deploy

c16c5bd Select deployment version

Before deploying a new project for the first time, a provision needs to be made for the project. Please contact our Support team, who'll do this for you.

If it's not in the dropdown list, you can follow the steps below to deploy it anyway.

At the bottom of the page within the studio, you'll find an example cURL command with your current session ID, similar to the below:

curl \
--cookie 'FCSESSID0815=c95914cb7a3ef945f56cd0053ab01234' \
--header 'Content-Type: application/json' \
-d '{"tag": "####.##.##.##.##"}' \

Copy this command into your shell and replace ####.##.##.##.## with the concrete tag that was created by the CI $env with staging or production, depending on the environment you want to deploy to.

If you already have an API-Token, you can also use the token-based approach instead of your current studio session:

curl \
--header 'X-Frontastic-Api-Token: <your-api-token>' \
--header 'Content-Type: application/json' \
-d '{"tag": "####.##.##.##.##"}' \

It'll then deploy.

The auto-publishing feature is turned off on your production site. Hence, you'll have to manually deploy a build to production.

To deploy a build to production, open the Deploys page of your Netlify site. Then click on the build you want to deploy to production in the list of deploys.

ee7337f 09 08 2022 at 15 19 452x

You can use the staging site to test latest master build. Once tested, use the commit id to find the unique deployment for a build and click on Publish deploy button to publish this build to production.

Getting the current deployment status

At the moment, status information is very limited, and there's a timeframe of around 5 minutes of silence where we spin off new sandboxes. But you can access the status for the deployment with the following command:

curl \
--header 'X-Frontastic-Api-Token: <your-api-token>' \

We're working on adding more status information to this service endpoint.

Visit the Builds page on your Netlify team dashboard to see the status of all frontend builds, as shown below.

75e9b53 09 08 2022 at 14 18 302x

Read Monitor builds in Netlify documentation to learn more.


If you're experiencing any issues with your latest deployment, you can roll back to the previous build. Click the Rollback to <version number> button to do this.

c2521fa Rollback version button

Follow the instructions in this video to roll back the frontend application to an older build.


By clicking the View deployment log button, you can see the logs from the current build version.

8b4e415 Click view deployment log

You can check the frontend application deployment logs on Netlify. Learn more about deployment logs on Netlify documentation.

Current version

The information near the top of the screen is where you can find the current version that's deployed.

For example:

ff18b7d Latest version deployed

You'll find the latest deployed version details of the frontend application on the Netlify site's dashboard.

6111f53 09 08 2022 at 14 08 522x