Quickstart

Let’s create a service and use it in production!

Create Stellate service

To get started, sign up for Stellate and create a Service that points to your backend. Your service in this state won’t have any configuration added yet. Without further configuration, you can already get the full benefits of Stellate’s GraphQL Metrics, just by using Stellate as a proxy in front of your GraphQL Backend 🤯.

Optional: Support for cookies

If you use session cookies instead of headers, please have a look at this guide before activating Stellate in production.

Enable Stellate in Production

To enable Stellate in production, you simply replace the code in your GraphQL Client to point to Stellate instead of your GraphQL Endpoint:

import { createClient } from 'urql'
 
const client = createClient({
 
- url: 'https://my-graphql-backend.com',
 
* url: 'https://my-backend.stellate.sh',
  })

import { ApolloClient } from '@apollo/client'
 
const client = new ApolloClient({
- uri: 'https://my-graphql-backend.com',
+ uri: 'https://my-backend.stellate.sh',
})

import { Environment, Network, RecordSource, Store } from 'relay-runtime'
 
function fetchQuery(operation, variables, cacheConfig, uploadables) {
 
- return fetch('https://my-graphql-backend.com', {
 
* return fetch('https://my-backend.stellate.sh', {
* method: 'POST',
* headers: {
* // Add authentication and other headers here
* 'content-type': 'application/json',
* },
* body: JSON.stringify({
* query: operation.text, // GraphQL text from input
* variables,
* }),
* }).then((response) => {
* return response.json()
* })
  +}
 
// Create a network layer from the fetch function
const network = Network.create(fetchQuery)
const store = new Store(new RecordSource())
 
const environment = new Environment({
network,
store,
// ... other options
})
 
export default environment

This is too risky for you and you’d like to roll it out gradually? No problem. Check out this guide on how to enable Stellate just for specific operations.

Once things are set up, you can now check out your metrics dashboard and see the first traffic flying in:

The Stellate Metrics Dashboard

Congratulations, you just set up Stellate 🎉

Ok, what next?

Enable the Stellate product suite

Now it’s time to try one of the Stellate products. What ever you’re interested in using, from here you can check out the guides for the products of the Stellate Edge Suite:

Speed up your API with the Stellate GraphQL Edge Cache
Control your API load with GraphQL Rate Limiting