Build and deploy to Azure Static Web Apps

Up to this point we have focused on authoring our Gatsby app using React, GraphQL and plugins. The next step once you are done authoring is to build your application. After that you are able to deploy to any web server or hosting service that can serve static files.

Build your app

Gatsby's command-line tool provides a command to build your project to create something that you can deploy anywhere you like. The build consists of HTML, JavaScript, CSS, and any additional assets you've included.

Creating the build

Gatsby runs the React compiler underneath so when it produces the build - it does many things. It compiles the React code by translating the JSX to JavaScript and HTML. It also extracts all the JavaScript code and places it in a set of bundles. Each bundle is then optimized meaning it has whitespace removed, variables are renamed and expressions are generally optimized for speed. The styles goes through a similar process. If you have chosen a library like LESS, SCSS or Stylus for your CSS, there will be a pre-step in which your CSS is being compiled from a high-level language to CSS. There are no further actions needed to deploy the files at this point. It's just a set of static files that can be hosted from any webserver that can serve files.

Deploy it

There are many technologies and services capable of hosting static apps. After all it's just HTML, CSS and JavaScript and can be hosted by most web services out there. For this tutorial, we'll deploy to Static Web Apps, an Azure service that specializes in hosting static apps like those built with Gatsby.

Azure Static Web Apps

Static Web Apps is an Azure service that allows you to take some static files and serve them from the cloud. What you deploy is not a deployment package but just a set of static files. This is a good fit for Gatsby as what Gatsby ends up producing from a build is static files.

Speaking of build, the service actually does the build step for you so there's no need to build anything up front. How it does this is by locating the build command in the package.json of the Gatsby project. All you need to do is put your project in a GitHub repository.


Azure Static Web Apps is currently in preview.

Currently your code sits in a directory on your machine, so you'll need to do a few things to deploy Azure:

  1. Initialize a Git repository: Right now, your Gatsby project is in a directory that hasn't been initialized as a Git repository.
  2. Create a GitHub repository and push to it: Once you initialize your repository, you'll push it to GitHub.
  3. Create an Azure Static Web Apps instance: When you use the Azure portal to create an Azure Static Web Apps instance, you'll provide the URL to your GitHub repository and the name for the sub directory where the static files live in your project. In Gatsby's case, this directory is called public/.