# ruru

> Grafast-flavoured GraphiQL distribution

Latest version **2.0.3** (published 2026-10-30) · MIT license · 0 weekly downloads

## Install

```sh
npm install ruru
pnpm add ruru
yarn add ruru
bun add ruru
```

Provides the command `ruru`.

## Health

**Score 75/100 (B)** — status: active.

Positive: has types; esm support; no vulnerabilities; has provenance; recently updated; high maintenance score; popular repo.

Warnings: low downloads; large bundle.

## Facts

| | |
|---|---|
| Version | 2.0.3 |
| Published | 2026-10-30 |
| First published | 2017-04-13 |
| Weekly downloads | 0 |
| License | MIT |
| TypeScript types | bundled |
| Module format | ESM + CommonJS |
| Node | >=22 |
| Dependencies | 7 |
| Unpacked size | 63.3 MB |
| Known vulnerabilities | 0 |
| Install scripts | no |
| Provenance | attested (GitHub Actions) |
| GitHub stars | 12933 |
| Author | Benjie Gillam |
| Maintainers | benjie |
| Keywords | graphile, graphql, graphiql, graphite |

## Links

- npm: https://www.npmjs.com/package/ruru
- Repository: https://github.com/graphile/crystal
- Homepage: https://grafast.org/ruru/
- Issues: https://github.com/graphile/crystal/issues
- npm.io page: https://npm.io/package/ruru

## Dependencies (7)

- [tslib](https://npm.io/package/tslib.md) ^2.8.1
- [yargs](https://npm.io/package/yargs.md) ^17.7.2
- [graphql](https://npm.io/package/graphql.md) ^16.9.0
- [http-proxy](https://npm.io/package/http-proxy.md) ^1.18.1
- [ruru-types](https://npm.io/package/ruru-types.md) ^2.0.1
- [graphile-config](https://npm.io/package/graphile-config.md) ^1.1.2
- [@emotion/is-prop-valid](https://npm.io/package/@emotion/is-prop-valid.md) ^1.4.0

## Alternatives

- [apollo-link-http-common](https://npm.io/package/apollo-link-http-common.md) — 879.0K weekly downloads
- [react-relay](https://npm.io/package/react-relay.md) — 336.8K weekly downloads
- [relay-test-utils](https://npm.io/package/relay-test-utils.md) — 181.6K weekly downloads
- [@vendure/core](https://npm.io/package/@vendure/core.md) — 14.8K weekly downloads
- [@pnpm/deps.graph-sequencer](https://npm.io/package/@pnpm/deps.graph-sequencer.md) — 13.4K weekly downloads

## Recent versions

- 2.0.3 (latest) — 2026-10-30
- 2.0.2-aardvark.next-20260928202932 (snapshot-next) — 2026-09-28
- 2.0.0-rc.7 (rc) — 2026-03-10
- 2.0.0-beta.31 (beta) — 2025-09-24
- 2.0.0-alpha.11 (alpha) — 2023-07-31
- 2.0.0-alpha.2 (prealpha) — 2023-05-03
- 2.0.2-aardvark.next-20260925164249 — 2026-09-25
- 2.0.2-aardvark.next-20260922224416 — 2026-09-22
- 2.0.2-aardvark.next-20260919185130 — 2026-09-19
- 2.0.2-aardvark.next-20260918085327 — 2026-09-18
- 2.0.2-aardvark.next-20260910230054 — 2026-09-10
- 2.0.2-aardvark.next-20260907131448 — 2026-09-07
- 2.0.2 — 2026-09-04
- 2.0.2-aardvark.next-20260902182429 — 2026-09-02
- 2.0.2-aardvark.next-20260902153400 — 2026-09-02
- … 74 more at https://npm.io/package/ruru/versions

## README

# ruru

[![GitHub Sponsors](https://img.shields.io/github/sponsors/benjie?color=ff69b4&label=github%20sponsors)](https://github.com/sponsors/benjie)
[![Discord chat room](https://img.shields.io/discord/489127045289476126.svg)](http://discord.gg/graphile)
[![Follow](https://img.shields.io/badge/BSky-@Graphile.org-006aff.svg)](https://bsky.app/profile/graphile.org)
[![Follow](https://img.shields.io/badge/Mastodon-@Graphile.fosstodon.org-6364ff.svg)](https://fosstodon.org/@graphile)

A distribution of [Graph*i*QL][graphiql] that's easy to use and embeds both the
popular [GraphiQL Explorer](https://github.com/onegraph/graphiql-explorer)
plugin and [Gra*fast*][grafast]-related tools such as viewing of plan diagrams
and explaining executed operations. _(Ruru can be used without Gra*fast*.)_

Flexible usage options

- [a CLI](https://grafast.org/ruru/cli) - temporary or installed
- [a Node.js middleware](https://grafast.org/ruru/server)
- [a static HTML file](https://grafast.org/ruru/html) - hosted or self-hosted
- [embedded](https://grafast.org/ruru/html#embedded) - render Ruru into your
  existing HTML pages

See it in action at:

https://grafast.org/myruru/#endpoint=https://countries.trevorblades.com/graphql

If you have Node installed, you can instantly run `ruru` without permanently
installing it using the `npx` command. Here's an example command to explore
[@trevorblades](https://twitter.com/trevorblades)'s countries API:

```
npx ruru -SPe https://countries.trevorblades.com/graphql
```

(`-S` enables subscriptions, `-P` proxies GraphQL requests; neither of these are
needed for Trevor's API, but you might want them for your API.)

**Documentation**: https://grafast.org/ruru

[GNU Terry Pratchett](http://www.gnuterrypratchett.com/)

[graphiql]: https://github.com/graphql/graphiql
[grafast]: https://grafast.org

---
_Source: https://npm.io/package/ruru · Machine-readable twin of the npm.io package page. Health data is recomputed on every publish._