{"id":19894524,"url":"https://github.com/stepzen-dev/transferred-netlify-plugin-stepzen","last_synced_at":"2026-02-13T16:16:34.430Z","repository":{"id":43322436,"uuid":"354877625","full_name":"stepzen-dev/transferred-netlify-plugin-stepzen","owner":"stepzen-dev","description":"StepZen build plugin for Netlify","archived":false,"fork":false,"pushed_at":"2022-08-04T06:42:41.000Z","size":104,"stargazers_count":4,"open_issues_count":2,"forks_count":0,"subscribers_count":6,"default_branch":"main","last_synced_at":"2025-04-25T11:50:41.884Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"JavaScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/stepzen-dev.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE.md","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2021-04-05T15:17:33.000Z","updated_at":"2023-03-17T17:59:39.000Z","dependencies_parsed_at":"2022-09-02T02:52:06.677Z","dependency_job_id":null,"html_url":"https://github.com/stepzen-dev/transferred-netlify-plugin-stepzen","commit_stats":null,"previous_names":["steprz/netlify-plugin-stepzen"],"tags_count":6,"template":false,"template_full_name":"netlify/build-plugin-template","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/stepzen-dev%2Ftransferred-netlify-plugin-stepzen","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/stepzen-dev%2Ftransferred-netlify-plugin-stepzen/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/stepzen-dev%2Ftransferred-netlify-plugin-stepzen/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/stepzen-dev%2Ftransferred-netlify-plugin-stepzen/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/stepzen-dev","download_url":"https://codeload.github.com/stepzen-dev/transferred-netlify-plugin-stepzen/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":252103903,"owners_count":21695384,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2024-11-12T18:33:46.738Z","updated_at":"2026-02-13T16:16:29.404Z","avatar_url":"https://github.com/stepzen-dev.png","language":"JavaScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Netlify Build Plugin: Deploy a StepZen GraphQL Endpoint Alongside a Netlify Build\n\nThe StepZen Netlify Build Pluign allows you to deploy a GraphQL API to\n[StepZen](http://stepzen.com) during a Netlify build.\n\nStepZen enables you integrate APIs and data into a single GraphQL API that forms\nthe backend of your Jamstack site. You can populate your API with data from\nREST, databases or any backend. The StepZen plugin enables you to easily deploy\nand integrate the API in a Netlify build. No change is required to the Netlify\ndeployment process. Your endpoint runs on StepZen, as a service, so that you\ndon't manage any infrastructure.\n\n\u003e For a full tutorial walkthrough showing how to build a Jamstack site using the\n\u003e StepZen Netlify Build Plugin, check our tutorial\n\u003e \"[How to build a database-driven Jamstack site](https://www.netlify.com/blog/2021/06/10/how-to-build-a-database-driven-jamstack-site/)\"\n\u003e on the Netlify Blog.\n\n## Pre-requisites\n\n- _required_ You have a [Netlify](http://netlify.com) account and site.\n- _required_ You have a [StepZen](http://stepzen.com) account.\n- _optional, recommended_ You have installed the StepZen CLI tool\n  `npm install -g stepzen`\n- _optional, recommended_ You have built an API using StepZen. Go\n  [here](https://www.stepzen.com/developers) for a quick \"how to\".\n\n## Usage\n\nThe first step is to install this plugin into your Netlify Site.\n\n- Search for `stepzen` in the Netlify plugins\n  [directory](https://app.netlify.com/plugins), and click the install button.\n\nNext, configure the plugin.\n\n- Create a `stepzen` directory within your Netlify project root containing your\n  API specification.\n- Add the environment variables (For options on how to add environment variables\n  to Netlify, refer to\n  [their documentation](https://docs.netlify.com/configure-builds/environment-variables/#declare-variables)):\n  - `STEPZEN_ACCOUNT` specifies the name of your StepZen account. This can be\n    found on the [My Account page](https://stepzen.com/account) on StepZen.com;\n  - `STEPZEN_ADMIN_KEY` specifies the admin API Key that enables access to\n    deploy APIs on your account on StepZen. This can be found on the\n    [My Account page](https://stepzen.com/account) on StepZen.com\n  - `STEPZEN_NAME` specifies the endpoint name for your API. This will determine\n    the URL that your endpoint will deployed to. For example, a user with the\n    account name `biggs` and a endpoint name of `my-api` will deploy as\n    `https://biggs.stepzen.net/netlify/my-api/__graphql` (note that this assumes\n    the dealt `STEPZEN_FOLDER` value is used).\n- Optionally, you can specify additional environment variables.\n  - `STEPZEN_FOLDER` is a folder name under which your endpoint will be deployed\n    (this defaults to `netlify`). StepZen generates the endpoint URL using a\n    pattern of `https://[account].stepzen.com/[folder]/[endpoint name]`.\n  - Any environment variable that starts with `STEPZEN_` are available in your\n    `config.yaml`, so set your API keys here. [Find out more about adding API\n    keys and other Secrets to your `config.yaml` safely](DOCS LINK HERE) on\n    StepZen.com\n\n## How does it work?\n\nThe StepZen GraphQL API is deployed whenever a site build is triggered (for\nexample, if you push into your connected git repository). You'll be able to view\nprogress via the Netlify deploy log. For example, a successful deploy will\noutput something similar to the following in the deploy log:\n\n```bash\n3:34:14 PM: ❯ Loading plugins\n3:34:14 PM:    - netlify-plugin-stepzen@1.0.2 from Netlify app\n3:34:14 PM: ​\n3:34:14 PM: ────────────────────────────────────────────────────────────────\n3:34:14 PM:   1. onPreBuild command from netlify-plugin-stepzen\n3:34:14 PM: ────────────────────────────────────────────────────────────────\n3:34:14 PM: ​\n3:34:14 PM:  Deploying from StepZen account: biggs\n3:34:14 PM:  using configuration sets netlify/configuration,stepzen/defaults\n3:34:14 PM:  Pushing schema to netlify/my-api\n3:34:16 PM:  Your endpoint is available at https://biggs.stepzen.net/netlify/my-api/__graphql\n3:34:16 PM: ​\n3:34:16 PM: (netlify-plugin-stepzen onPreBuild completed in 1.9s)\n```\n\nThe API is deployed to StepZen _prior_ to the site build step. This enables you\nto access data in your GraphQL API during the build process, allowing you to\npre-render pages off of dynamic data from the API.\n\n## Where To Go From Here\n\nYou can learn more about build GraphQL APIs using StepZen via the\n[StepZen documentation](https://stepzen.com/docs) or via the\n[StepZen blog](https://stepzen.com/blog).\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fstepzen-dev%2Ftransferred-netlify-plugin-stepzen","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fstepzen-dev%2Ftransferred-netlify-plugin-stepzen","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fstepzen-dev%2Ftransferred-netlify-plugin-stepzen/lists"}