I’m Robert - co-founder of grapqhleditor.com. We're creating a visual tool for developers that will automate their backend development. I'm sharing our journey as part of my-saas-story. All of our team have long years of experience in the tech industry but none on saas.

It's the first week of November, and we are working the 6th month on our idea. Since then we made a pivot (half sept), and many other things happened. I'll write another post on that. Here wanted to focus on our current state and goals for this quarter. October was an excellent month for us. Check below:

## New blog!

We started a blog.graphqleditor.com. We wrote eight blog posts, published them on few places and that gave us more than 1,5k page views! Below you can see which posts are most popular:
- [Levensthein algorithm for better faker experience](https://graphqleditor.com/blog/levensthein-algorithm-for-better-faker-experience/) 555  views
- [Canvas node graph in typescript](https://graphqleditor.com/blog/canvas-node-graph-in-typescript/) 423 views
- [Twitter clone with React XP and faker](https://graphqleditor.com/blog/twitter-clone-with-reactxp-and-faker/) 415 views
- [Graphsourcing new way to build systems](https://graphqleditor.com/blog/graphsourcing-new-way-to-build-systems/) 191 views
- [GraphQL newbie tutorial - introduction](https://graphqleditor.com/blog/GraphQL-newbie-tutorial-introduction/) 144 views
- [Typescript backend with slothking](https://graphqleditor.com/blog/typescript-backend-with-slothking/) 116 views

## Outreach & Feedback calls

We organized an outreach campaign to front-end developers asking about feedback. We organized ten calls after sending around invites to 1000 people. Those calls were very good. We received a lot of feedback and added those ideas as issues to our GitHub. We had a pleasure to speak with developers from Paypal and Microsoft! It was super exciting!

Some compelling features were around offline version for the enterprise, adding icons to nodes (making them more consumable for non-tech people), generating Interface for frontend or creating fake backend out of the graph. All of them are on our GitHub.

## First OKR’s & Metrics

Together with our advisors, we created a short roadmap for this quarter. It's not 100 ready, but the first version includes our vision, mission and metrics which we want to measure to grow. Below you can find our OKR' results from October. I'll update it every month!

| METRIC                      | COUNT   |
| --------------------------- | ---- |
| github faker stars          | 19   |
| github diagram stars        | 54   |
| github graphql-editor stars | 2550 |
| blog views                  | 1500 |
| website views               | -    |
| blog articles               | 8    |
| mailchimp subscriptions     | 16   |
| demo runs                   | 200  |
| outreach to developers      | 1000 |
| slack users                 | 10   |
| quality calls               | 10   |
| close issues                | 20   |

## Development:

Graphql Editor: Total open issues: 16. Last month we closed ten issuse in our main repo (21 from pivot).

Javascript Diagram: Total open issues: 14. We have rewritten our tool to canvas to handle large schemas. It was an idea by users. Try GitHub schema! IT Rocks!

Team: Artur is working on the front end with few hours of help from Hubert and Kamil is working on backend features.

## Other:
- Launched a slack group (pm me to join). 
- Three guys agreed to contribute
- Created landing page for diagram.graphqleditor.com



 My saas story - oct'18 first OKRs

Ready for take-off?

For GraphQL cache can significantly improve performance and reduce redundancy, particularly when the same data is queried multiple times within a short timeframe. In this post, I'll go over implementing caching using [GraphQL Zeus](/docs/zeus) to fetch data from our custom CMS. No worries this can also be applied just as effectively to other GraphQL APIs, such as Hygraph or Hasura. Whether you’re working with a headless CMS, an e-commerce backend, or any other GraphQL-powered service, caching is just as important in every scenario and the implementation should look very similar.

## Why Add Caching?

Caching provides a number of advantages like:
 -  Reduced Server Load: By serving repeated requests from the cache, you avoid making unnecessary calls to the GraphQL server, which can be essential for scaling applications with high traffic.
 - Improved Performance: frequently requested data can be served directly from memory, reducing query response time significantly
 - Cost Efficiency: if your GraphQL API usage is metered (e.g., cloud-based APIs), caching significantly reduces the number of queries made, saving on usage costs

## [GraphQL Zeus](/docs/zeus) query example

Let’s start with a simple query I made using [GraphQL Zeus](/docs/zeus), which fetches homepage data from our CMS:

```ts
export const getHomepageData = async () => {
  try {
    const result = await chain('query')({
      onehomepageBySlug: [{ slug: 'home' }, HomepageDataSelector],
    });
    return result;
  } catch (error) {
    console.error('failed to fetch home data', error);
  }
};
```

This query retrieves all the homepage data at once and passes it to the relevant components. This allows users to update the homepage content directly through the CMS without needing to modify any code. Currently, this function is called in server-side props, meaning it triggers an API call every time the page is refreshed or visited.

To optimize this and reduce redundant API calls, we’ll implement caching by using the [node-lru-cache](https://github.com/isaacs/node-lru-cache) library.

## LRU cache

LRU stands for "Least Recently Used," a caching strategy that automatically removes the least recently accessed items when the cache reaches its limit. The node-lru-cache library offers several configuration options, but in our case to set up a basic GraphQL cache, we only need two key settings:

 - `ttl` (Time to Live): This setting defines how long an item stays in the cache before it’s considered expired, specified in milliseconds.
 - `ttlAutopurge`: When enabled, this option automatically deletes expired items from the cache. Without it, expired items are only purged when the cache is next accessed which can potentially lead it to grow unbounded.
 
```ts
import { LRUCache } from 'lru-cache';

const cache = new LRUCache({
  ttl: 1000 * 60 * 5, // Set time to live to 5 minutes
  ttlAutopurge: true,  // Automatically clean up expired entries
});
```

## Caching the query

To cache the query I mentioned earlier, we need to do three simple things:
1. Set up a cache key: This helps the cache know which entry to return when the same data is requested. You can name the key however you like, but it has to be unique to avoid conflicts.
2. Check if the cache contains the result: If the cache has the entry for that key, return the cached result.
3. Store the query result in the cache: After fetching the data, save the result in the cache for future use.

```ts
export const getHomepageData = async () => {
  const cacheKey = 'homepageData'; // Cache key for this entry
  if (cache.has(cacheKey)) { // Check if the cache contains this key
    return cache.get(cacheKey) as { onehomepageBySlug: HomepageDataType }; // Return cached result
  } 
  try {
    const result = await chain('query')({
      onehomepageBySlug: [{ slug: 'home' }, HomepageDataSelector],
    });
    cache.set(cacheKey, result); // Store query result in the cache
    return result;
  } catch (error) {
    console.error('failed to fetch home data', error);
  }
};
```

This approach results in two scenarios:

 - First visit: The query runs, fetches the data, and caches it for future use.
 - Subsequent visits (within the TTL): The cached result is returned, avoiding the need to make a new API request.

## Query with params (slug, locale)

As mentioned earlier, the cache key must be unique to avoid conflicts. This is especially important for queries that include parameters, such as `locale` (for localization) or `slug` (for specific blog pages). Without unique cache keys, you may end up with the same content being served for different locales or blog pages. To avoid this, it's best to use a dynamic cache key based on the query parameters.

```ts
export const getBlogpostBySlug = async ({ slug }: { slug: string }) => {
  const cacheKey = `Blogpost:${slug}`; // Unique cache key based on the slug
```

By using this dynamic approach, we ensure that the correct data is returned for the given slug. If you were to use a static cache key like 'blogpost', you'd always get the first cached blog post, regardless of which slug is provided. The same issue would arise with localization: without unique keys, you'd end up serving the wrong content for different locales.

## Its all about performance

GraphQL is all about efficiency — retrieving only the data you need (unlike REST). It makes sense to take that a step further to further enhance performance. With a GraphQL cache setup like this we can reduce redundant API calls and significantly speed up queries, especially for frequently accessed data like homepage content or blog posts. Dynamic cache keys based on query parameters ensure that the data is correctly localized or filtered according to specific slugs and [GraphQL Zeus](/docs/zeus) and selectors keep everything type-safe. Together this solution can greatly improve your app's speed and scalability. As mentioned, even if you're not using [GraphQL Zeus](/docs/zeus), the implementation should still be very similar to the above, so give it a try!
  

GraphQL cache: using LRU cache with GraphQL Zeus

Unlocking the Power of React 19

Welcome to a short post about a recent quality of life update to [GraphQL Zeus](/docs/zeus). If you're not familiar with [GraphQL Zeus](/docs/zeus) go ahead and read my [earlier post which breaks down its basics](/what-is-graphql-zeus). If you are lets go ahead and talk about the update!

### Graphql Fragments

GraphQL has long supported reusable fields natively with the use of fragments. If you're not familiar with them basically if you had the same fields in multiple queries you could define a fragment - a set of fields, and then reuse it instead of repeating all the fields every time. Lets say you had a user with some fields like name, email, address. Then you could use a fragment like this:

```ts
query getUser {
  user(id: 4) {
    ...userFields
  }
}

fragment userFields on User {
  name,
  email,
  address,
  avatar
}
```

For reusability you could put all your fragments in a fragments.js file and then use them across a project. Zeus already had a solution like Selectors (which work a bit similarly to that) but with the latest update it can now go a step further! :)

### Zeus fields - GraphQL spread operator

For our example lets say we need to get the posts data for our blog page where we display them in a grid, usually the query that would look something like this:

```ts
const posts = await Chain('http://example.com/api/graphql')('query')({
  posts: [
    {
      title: true,
      coverImage: true,
      publishedAt: true,
      slug: true,
      content: { markdown: true },
    },
  ],
});
```

With Zeus 6.0.0 you can simply use a spread operator `...fields` with the TypeScript type from the schema (eg. `Post`) to simply get all the fields available for that type:

```ts
const posts = await Chain('http://example.com/api/graphql')('query')({
  posts: [
    {
      ...fields('Post'),
    },
  ],
});
```

### Never go full REST

With this, we now have a convenient quality-of-life improvement for cases where you just want to quickly retrieve all the fields for a type. That said it's important to remember what GraphQL is all about - getting exactly what you requested without overfetching. So don't just use `...fields` everywhere or you'll defeat the entire purpose of using GraphQL in the first place and turn it into REST, always pulling way more data than necessary.


My saas story - oct'18 first OKRs

New blog!

Outreach & Feedback calls

First OKR’s & Metrics

Development:

Other:

Check out our other blogposts

Ready for take-off?

Elevate your work with our editor that combines world-class visual graph, documentation and API console

METRIC	COUNT
github faker stars	19
github diagram stars	54
github graphql-editor stars	2550
blog views	1500
website views	-
blog articles	8
mailchimp subscriptions	16
demo runs	200
outreach to developers	1000
slack users	10
quality calls	10
close issues	20