https://github.com/MatthieuSegret/graphql-rails-blog

Blog App built with Rails 5, React and GraphQL
https://github.com/MatthieuSegret/graphql-rails-blog

apollo graphql javascript rails react ruby starter-kit

Last synced: 3 months ago
JSON representation

Blog App built with Rails 5, React and GraphQL

• Host: GitHub
• URL: https://github.com/MatthieuSegret/graphql-rails-blog
• Owner: MatthieuSegret
• License: mit
• Created: 2016-11-11T12:39:02.000Z (almost 8 years ago)
• Default Branch: master
• Last Pushed: 2021-02-12T00:48:03.000Z (over 3 years ago)
• Last Synced: 2024-07-05T16:55:18.344Z (4 months ago)
• Topics: apollo, graphql, javascript, rails, react, ruby, starter-kit
• Language: TypeScript
• Homepage:
• Size: 541 KB
• Stars: 154
• Watchers: 7
• Forks: 32
• Open Issues: 7
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

        
# GraphQL Rails Blog

This application can be used as **starter kit** if you want to get started building an app with **Rails**, **React**,

and **GraphQL**. This is a simple blog engine using ordinary features which can be found in most web applications.

If you are interested by Elixir, I created a similar application with Phoenix and Absinthe that you might like:

[Yummy Phoenix GraphQL](https://github.com/MatthieuSegret/yummy-phoenix-graphql).

## Technologies

### Frontend

* [TypeScript](https://github.com/Microsoft/TypeScript) - A superset of JavaScript that compiles to clean JavaScript

  output.

* [React](https://facebook.github.io/react) - A JavaScript library for building user interfaces. It introduces many

  great concepts, such as, Virtual DOM, Data flow, etc.

* [Create React App](https://github.com/facebookincubator/create-react-app) - is a new officially supported way to

  create single-page React applications. It offers a modern build setup with no configuration.

* [Bulma](https://bulma.io) - Bulma is a modern CSS framework based on Flexbox

* [Apollo 2](http://dev.apollodata.com/) - A flexible, fully-featured GraphQL client for every platform.

* [React Final Form](https://github.com/erikras/react-final-form) - High performance subscription-based form state

  management for React.

### Backend

* Ruby 2.4

* Rails 5.1

* [GraphQL-Ruby](https://github.com/rmosolgo/graphql-ruby) - GraphQL-Ruby is a Ruby implementation of

  [GraphQL](http://graphql.org).

* [GraphQL-batch](https://github.com/Shopify/graphql-batch) - GraphQL-batch is a query batching executor for the graphql

  gem.

* [Graphiql](https://github.com/graphql/graphiql) - Graphiql is an in-browser IDE for exploring GraphQL.

* [Rack CORS](https://github.com/cyu/rack-cors) - Rack Middleware for handling Cross-Origin Resource Sharing (CORS),

  which makes cross-origin AJAX possible.

* [Optics Agent](http://www.apollodata.com/optics) - Optics Agent for GraphQL Monitoring

* SQLite3 for development and PostgreSQL for production.

## Features

* CRUD (create / read / update / delete) on posts

* Creating comments on post page

* Pagination on posts listing

* Searching on posts

* Authentication with Devise and authorizations (visitors, users, admins)

* Creating user account

* Update user profile and changing password

* Setup dev tools

* Application ready for production

## GraphQL Using

* Queries et mutations

* FetchMore for pagination

* Using `apollo-cache-inmemory`

* Apollo Link (dedup, onError, auth)

* [Managing local state](https://github.com/apollographql/apollo-link-state) with Apollo Link

* Optimistic UI

* [Static GraphQL queries](https://dev-blog.apollodata.com/5-benefits-of-static-graphql-queries-b7fa90b0b69a)

* Validation management and integration with Final Form

* Authentication and authorizations

* Protect queries and mutations on GraphQL API

* Batching of GraphQL queries into one HTTP request

* Batching of SQL queries backend side

## Prerequisites

* Ruby 2.4

* Node 9.2 ([Installing Node](https://nodejs.org/en/download/package-manager))

* SQLite3

## Getting Started

* Install Bundler

          $ gem install bundler

* Checkout the graphql-rails-blog git tree from Github

          $ git clone https://github.com/MatthieuSegret/graphql-rails-blog.git

          $ cd graphql-rails-blog

          graphql-rails-blog$

* Run Bundler to install/bundle gems needed by the project:

          graphql-rails-blog$ bundle

* Create the database:

          graphql-rails-blog$ rails db:migrate

* Load sample records:

          graphql-rails-blog$ rails db:seed

* Run the Rails server in development mode

          graphql-rails-blog$ rails server

* Run Yarn to install javascript package in other terminal:

          graphql-rails-blog$ cd client

          graphql-rails-blog/client$ yarn

* Start client in development mode. You should be able to go to `http://localhost:8080` :

            graphql-rails-blog/client$ yarn start

## Next step

* [ ] Use subscription GraphQL feature

* [ ] Create mobile app with React Native

## Screens

#### Listing posts



#### Creating comments



#### Post page



#### Editing post



## License

MIT © [Matthieu Segret](http://matthieusegret.com)