Docs
Launch GraphOS Studio

The GraphOS Studio Explorer

Overview


The is a powerful web IDE for creating, running, and managing :

The Explorer is free for all organizations. It supports all types (Query, Mutation, and Subscription).

💡 TIP

The Explorer is also available in a sandbox mode that doesn't require an Apollo account.

Setup

To get started with the Explorer, create a graph in and then navigate to that graph's Explorer page:

The default Explorer view for a new supergraph

Building a query

Here's an example embedded Explorer you can use to try out the -building features described below!

The operation editor

The Explorer's editor is built on Monaco. It provides common features of -building tools, including:

  • Panels for specifying headers, variables, and environment variables
  • Persistence across sessions
  • Keyboard shortcuts (click the keyboard icon in the bottom-right corner of the editor to view all available shortcuts)

The editor also provides full IntelliSense support for , including:

  • linting
  • Autocomplete
  • Peek definitions on mouse hover
  • Jump-to-definition with command-click

The editor can manage multiple and reason about those operations individually. As you work, the editor shifts focus to whichever operation you click into. Each operation has its own context menu (•••) that enables you to format it, copy a link to share, or generate a curl command.

The Documentation tab

The Explorer's Documentation tab enables you to step into your schema, beginning at one of its entry points. As you step into a and its subfields, the Explorer keeps track of your current path within the schema.

You can click the ⊕ button next to any in the Documentation tab to add that field to the editor, at your current path. By default, the Explorer automatically generates for that field's .

Searching your schema

The Explorer provides a two-step schema search (shortcut ⌘+K):

  1. Find the schema you're looking for
  2. Find the ideal path to that from your schema's entry points

1. Find a field

First, you search for a by its name, for example, email. The interface helps you differentiate between with the same name, for example, User.email versus Organization.email. The search is "fuzzy," so it works even if you don't know a 's exact spelling.

If you know exactly which type and which you're looking for, you can separate those values with a period, for example, User.email.

2. Find a path to the field

After you identify a type- pair, the Explorer lists all the paths to that field that start at your schema's entry points (Query, Mutation and Subscription). These paths are ordered by depth.

ⓘ NOTE

Finding the path to a is particularly important with , because you can only a field if that field's position within your query is valid.

After you select which path you want, the Explorer opens that path in its Documentation tab. You can then click the ⊕ button to add that path to your .

Additional features

The Explorer also provides:

Next
Sandbox (no account required)
Edit on GitHubEditForumsDiscord

© 2024 Apollo Graph Inc.

Privacy Policy

Company