The StepZen Netlify Build Plugin makes it easy to build and deploy your Netlify frontend and your StepZen backend from the same code base. Since the build plugin runs prior to your Netlify build, data updated from your StepZen GraphQL API is available to your site at build time.
This topic describes how to install and configure the plugin.
For a complete, step-by-step walkthrough showing how to build a Jamstack site using the StepZen Neltify Build Plugin, check out our tutorial on Netlify's blog.
Install the Plugin
Follow the steps below to install the plugin:
- Ensure you already have a site deployed to Netlify. Netlify supports code stored in GitHub, GitLab, and Bitbucket repositories.
- Navigate to Netlify and click the New site from git button in your Netlify dashboard. Follow the steps as needed to support your site deployment and/or static site generator.
- Navigate to the Plugins tab in the dashboard when the initial deployment is complete, and click on Go to Plugins Directory.
- Search for "StepZen" and then click the Install button.
- Choose the site you just created, when asked which site you want to install the plugin on.
- Navigate to your site's Netlify dashboard and choose Site Settings > Build and Deploy > Environment. The plugin requires you to add and configure the following variables:
STEPZEN_ACCOUNT: Account name from your My Account page.
STEPZEN_ADMIN_KEY: Admin key from your My Account page.
STEPZEN_NAME: Endpoint name you want to use for your StepZen API. The plugin assumes that the default folder name is
netlifybut you can override the default by modifying the
STEPZEN_FOLDERenvironment variable. For example, if you deployed an API as
netlify/my-graphql-api, the value of
STEPZEN_NAMEmust be set to
my-graphql-api. In this case,
STEPZEN_FOLDERis not required as it uses the default folder name value.
- (Optional) If want to call your StepZen API from within Netlify Functions or during the build of your site, set the
STEPZEN_API_KEYenvironment variable to the value of your API key from your My Account page.
- Click the Save button. Your plugin is configured and any changes you make to the StepZen schema will now be deployed whenever a Netlify build is triggered by checking code into our GitHub repository.