Example Rails app using GitHub's GraphQL API
Ruby HTML JavaScript CSS
Switch branches/tags
Nothing to show
Clone or download
Latest commit 1339e97 May 2, 2018
Failed to load latest commit information.
app Update CSS May 19, 2017
bin Generate Rails scaffold Sep 10, 2016
config Add a basic mutation example May 19, 2017
db Commit schema changes May 19, 2017
lib/tasks Upgrade graphql-client Sep 14, 2016
public Update CSS May 19, 2017
.gitignore Generate Rails scaffold Sep 10, 2016
Gemfile Upgrade rails May 19, 2017
Gemfile.lock Upgrade rails May 19, 2017
LICENSE Add LICENSE Sep 11, 2016
README.md Update README.md Sep 27, 2017
Rakefile Generate Rails scaffold Sep 10, 2016
config.ru Generate Rails scaffold Sep 10, 2016


GitHub GraphQL Rails example application

Demonstrates how to use the graphql-client gem to build a simple repository listing web view against the GitHub GraphQL API.

The application structure is setup like a typical Rails app using controllers, views and routes with one key difference, no models. This app doesn't connect directly to any database. All the data is being fetched remotely from the GitHub GraphQL API. Instead of declaring resource models, data queries are declared right along side their usage in controllers and views. This allows an efficient single request to be constructed rather than making numerous REST requests to render a single view.

Table of Contents

Jump right into the code and read the inline documentation. The following is a suggested reading order:

  1. app/controller/repositories_controller.rb defines the top level GraphQL queries to fetch repository list and show pages.
  2. app/views/repositories/index.html.erb shows the root template's listing query and composition over subviews.
  3. app/views/repositories/_repositories.html.erb makes use of GraphQL connections to show the first couple items and a "load more" button.
  4. app/views/repositories/show.html.erb shows the root template for the repository show page.
  5. app/controller/application_controller.rb defines controller helpers for executing GraphQL query requests.
  6. config/application.rb configures GraphQL::Client to point to the GitHub GraphQL endpoint.

Running locally

First, you'll need a GitHub API access token to make GraphQL API requests. This should be set as a GITHUB_ACCESS_TOKEN environment variable as configured in config/secrets.yml.

$ git clone https://github.com/github/github-graphql-rails-example
$ cd github-graphql-rails-example/
$ bundle install
$ GITHUB_ACCESS_TOKEN=abc123 bin/rails server

And visit http://localhost:3000/.

See Also