Quell

Quell is a light-weight caching layer implementation for GraphQL responses on both the client- and server-side. Use Quell to prevent redundant client-side API requests and to minimize costly server-side response latency.

Accelerated by OS Labs and developed by Nick Kruckenberg, Mike Lauri, Rob Nobile and Justin Jaeger.

Features

Client-side caching utilizing sessionStorage
Server-side caching utilizing a configurable Redis in-memory data store
Automatic unique cache key generation
Partial and exact match query caching
Programmatic rebuilding of GraphQL queries to fetch only the minimum data necessary to complete the response based upon current cache contents

Currently, Quell can only cache query-type requests without arguments, aliases, fragments, variables, or directives. Quell will still process these other requests, but will not cache the responses.

Installation

Quell is divided up into two npm packages:

Download @quell/client from npm in your terminal with npm i @quell/client
Download @quell/server from npm in your terminal with npm i @quell/server

Installing and Connecting a Redis Server

If not already installed on your server, install Redis.

Mac-Homebrew:
- At the terminal, type brew install redis
- After installation completes, type redis-server
- Your server should now have a Redis database connection open (note the port on which it is listening)
Linux or non-Homebrew:
- Download appropriate version of Redis from redis.io/download
- Follow installation instructions
- Once Redis is successfully installed, follow instructions to open a Redis database connection (note the port on which it is listening)

Documentation

Contribute to Quell

Interested in making a contribution to Quell? Click for our open-source contribution guidelines.

Thank you for your interest and support!! Team Quell

justinjaeger / Quell