Vandal is the Graphiti UI. It’s helpful for exploring data, testing and generating URLs. To take Vandal for a spin, view our sample app (initial load may take a second).
1.1 Installing via Template
If you ran our application template, you already have Vandal installed. Check your routes to see it mounted.
1.2 Installing via Gem
- Add the
- Mount the engine:
That’s it! Vandal will dynamically generate a schema at
<api_namespace>/vandal/schema.json, and you can view the UI at
1.3 Manual Installation
Vandal is a VueJS application. Just grab the dist files and put them anywhere you’d like.
index.html has a placeholder,
this with a URL hosting your schema, and you’ll be good to go.
First, make sure your schema is being correctly generated. You should
see Vandal make a request something like
/vandal/schema.json - make
sure that looks correct. If it doesn’t, you may need to bounce your
After selecting an endpoint, use the left rail to configure your request. Click a relationship once to include it in the response. If a relationship is included, you can click any row in the table to view related data.
Click a relationship twice and you can configure the deep query of
the associated Resource. In other words, if you’re fetching Posts and
comments twice to say things like “only active
comments should be returned”.
When you hit ‘submit’, the top URL bar will change to reflect your query and results will show in the center table.