All Projects → sanity-io → sanity-plugin-graph-view

sanity-io / sanity-plugin-graph-view

Licence: MIT License
A tool for Sanity Studio to graph your content and see changes in real-time.

Programming Languages

javascript
184084 projects - #8 most used programming language
CSS
56736 projects
Sanity

Graph View Plugin

A tool for Sanity Studio to graph your content and see changes in real-time.

Screengrab of the Graph tool

Wonder how a visualization of your dataset will look? How many authors do you have? How many items have they worked on? And are currently working on! Edits and changes are shown in real-time!

Explore your data with this plugin, seek out strange corners and data types, boldly go where you could not before!

Installation and use

**Important!** Due to an [outstanding issue with Three.js](#4), you currently **have to use Yarn to install packages, not NPM, and add this to your app's `package.json`**:
  "resolutions": {
    "**/three": "0.119.1"
  }

We hope to remedy this in the future.

# In your Sanity Studio repository:
sanity install graph-view

# Start the Studio
sanity start

Configuration

Edit ./config/graph-view.json:

{
  "query": "*[_type in ['a', 'b']]"
}

For references to turn into graph edges, the entire document must be fetched, but you can also selectively filter what references will be included. For example:

{
  "query": "*[_type in ['a', 'b']]{ 'refs': [author, publisher] }"
}

By default, the plugin uses doc.title || doc.name || doc._id as the node label.

If you want to use another property, compute a title property in your query, e.g.:

{
  "query": "*[_type in ['a', 'b']] { ..., \"title\": select(_type == 'a' => 'Title A', _type == 'b' => 'Title B') }"
}

Contributing

If you want to take part in developing this plugin, then look for planned features in the list of issues and reach out to us in the Sanity Community.

git clone [email protected]:sanity-io/sanity-plugin-graph-view.git
cd sanity-plugin-graph-view
yarn
yarn link

# In a development Studio directory:
yarn link sanity-plugin-graph-view

# Lint your code before committing
yarn lint

Get help in the Sanity Community

Slack Community Button

Join Sanity’s developer community or ping us on twitter.

License

MIT © Sanity.io

Note that the project description data, including the texts, logos, images, and/or trademarks, for each open source project belongs to its rightful owner. If you wish to add or remove any projects, please contact us at [email protected].