Apollo Sandbox
Plugin verified by Strapi

Integrate Apollo Sandbox for a powerful GraphQL Explorer in your Strapi Admin Interface

Strapi Plugin: Apollo Sandbox

Enhance your Strapi Admin Interface with Apollo Sandbox, an alternative GraphQL Explorer. Simplify development and testing of GraphQL queries and mutations directly within the Strapi Admin Interface. Explore your API schema, test queries in real-time, and iterate faster with this powerful plugin.

💭 Motivation

There already is a GraphQL Playground plugin for Strapi, why do I need Apollo Sandbox? Well, the current Playground just doesn't provide a good developer experience in my opinion. Apollo Sandbox is a great alternative to the GraphQL Playground with an awesome developer experience. That's why I created this plugin.

⏳ Installation

Install the plugin in your Strapi project.

# using yarn
yarn add @creazy231/strapi-plugin-apollo-sandbox

# using npm
npm install @creazy231/strapi-plugin-apollo-sandbox --save

After successful installation, you've to build a fresh package. To archive that simply use:

yarn build && yarn develop
# or
npm run build && npm run develop

The Apollo Sandbox plugin should appear in the Plugins section of Strapi sidebar after you run the app again.

🔧 Configuration

!IMPORTANT This plugin requires the graphql plugin and its playground to be enabled. You can enable it in the ./config/plugins.ts file in your Strapi project. You also need to modify the ./config/middlewares.ts file and replace strapi::security with the following:

1export default [
2  // ...
3  {
4    name: "strapi::security",
5    config: {
6      contentSecurityPolicy: {
7        directives: {
8          "frame-src": [ "http://localhost:*", "self", "sandbox.embed.apollographql.com" ],
9        },
10      },
11    },
12  },
13  // ...
14]

After the modification, your file should look like this:

1export default [
2  "strapi::errors",
3  {
4    name: "strapi::security",
5    config: {
6      contentSecurityPolicy: {
7        directives: {
8          "frame-src": [ "http://localhost:*", "self", "sandbox.embed.apollographql.com" ],
9        },
10      },
11    },
12  },
13  "strapi::cors",
14  "strapi::poweredBy",
15  "strapi::logger",
16  "strapi::query",
17  "strapi::body",
18  "strapi::session",
19  "strapi::favicon",
20  "strapi::public",
21];

🛠️ Plugin Configuration

Config can be changed in the ./config/plugins.ts file in your Strapi project. You can overwrite the config like so:

1export default {
2  // ...
3  "graphql": {
4    enabled: true,
5    config: {
6      // set this to true if you want to enable the playground in production
7      playgroundAlways: false,
8    },
9  },
10  "apollo-sandbox": {
11    // enables the plugin only in development mode
12    // if you also want to use it in production, set this to true
13    // keep in mind that graphql playground has to be enabled
14    enabled: process.env.NODE_ENV === "production" ? false : true,
15    config: {
16      // endpoint: "https://tunneled-strapi.com/graphql", // OPTIONAL - endpoint has to be accessible from the browser
17    }
18  },
19  // ...
20};

endpoint configuration is optional. If you don't provide it, the plugin will create a tunnel of your Strapi instance. This is useful if you're developing locally but still want to use the Apollo Sandbox plugin. You can still provide your own tunneled endpoint if you want to.