Skip to content

harshil1712/gql-playground

Repository files navigation

This project was bootstrapped with Create Contentful App.

This app allows you to add a modern GraphQL Playground to your Contentful space.

How to use

Install to Contentful

To install locally execute create-contentful-app with npm, npx or yarn to bootstrap the example:

# npx
npx create-contentful-app -s https://github.com/harshil1712/contentful-gql-playground

# npm
npm init contentful-app -- -s https://github.com/harshil1712/contentful-gql-playground

# Yarn
yarn create contentful-app -s https://github.com/harshil1712/contentful-gql-playground

Available Scripts

In the project directory, you can run:

npm start

Creates or updates your app definition in Contentful, and runs the app in development mode. Open your app to view it in the browser.

The page will reload if you make edits. You will also see any lint errors in the console.

npm run build

Builds the app for production to the build folder. It correctly bundles React in production mode and optimizes the build for the best performance.

The build is minified and the filenames include the hashes. Your app is ready to be deployed!

npm run upload

Uploads the build folder to contentful and creates a bundle that is automatically activated. The command guides you through the deployment process and asks for all required arguments. Read here for more information about the deployment process.

npm run upload-ci

Similar to npm run upload it will upload your app to contentful and activate it. The only difference is
that with this command all required arguments are read from the environment variables, for example when you add the upload command to your CI pipeline.

For this command to work, the following environment variables must be set:

  • CONTENTFUL_ORG_ID - The ID of your organization
  • CONTENTFUL_APP_DEF_ID - The ID of the app to which to add the bundle
  • CONTENTFUL_ACCESS_TOKEN - A personal access token