Brangr is a simple, unique tool that any web server can host to provide a user-friendly browser/viewer for any GraphQL service (or many).
Brangr formats GraphQL results attractively, via a selection of user-configurable layouts. It lets users extract the generated HTML, and its source JSON. It provides a schema browser. It has built-in docs.
Brangr enables sites hosting it to present users with a collection of pre-fab GraphQL requests, which they can edit if desired, and let them create their own requests. And it allows sites to define custom CSS styling for all aspects of the formatted results.
It's fast & small.
It's a browser-based app, not a code module (although that might be arranged).
It's built with Vue.js, in ordinary Javascript & plain CSS,
and employs the GraphQL.js language module [1].
It's tested on Firefox, Safari, and Chrome.
More features are on the drawing board — please convey what your GraphQL users need!
Try it at the public Brangr site.
[1] https://graphql.org/graphql-js/language
query {
heroes(_layout:{type:table}) { # _layout arg not sent to service
first
last
}
}
Brangr renders the above query as roughly this HTML (though not in a quote block):
heroes...
First Last Arthur Dent Ford Prefect Zaphod Beeblebrox
- Download the latest release, and unpack its files into a website directory.
- Copy
tmpl_brangr-config.js
to a new file,brangr-config.js
.
Edit the new file to create the config for your site. - Copy
tmpl_brangr-local.css
to a new file,brangr-local.css
.
No edits to this file are required at installation. - Direct your browser to
<site/dir>/brangr.html
.
Copyright 2023 Liam Breck
Published at https://github.com/networkimprov/brangr
This Source Code Form is subject to the terms of the Mozilla Public
License, v. 2.0. If a copy of the MPL was not distributed with this
file, You can obtain one at http://mozilla.org/MPL/2.0/