Home - aaronpanch/idea-board GitHub Wiki

Introduction

Welcome! In this wiki we'll offer some instructions and guidance as we build our idea voting app. The purpose of this workshop is to introduce participants to the GraphQL-Ruby and Apollo frameworks. A simple idea board example application has been started to provide a sandbox for end-to-end development practice. We will discuss common usage and best practices where applicable.

Getting Help

If you find yourself behind, no worries! We ask that we keep our questions public-facing in the #dev-graphql-workshop Slack channel or out loud (which may be a little weird remotely but that's ok!) so that everyone has access to the answer. We will answer in threads as quickly as we can. No question is too small. There are also docs!

• Apollo Docs
• GraphQL-Ruby

The Project

Goal

• We're attempting to recreate our current Idea Feedback Tool and add a couple of key missing features: Mark-up style idea descriptions, and removing previous votes.
• The current HEAD of the app can be found here for demoing.

Structure

• Idea-board is a Rails application with a React/Apollo client.

• The rails controllers, models, and public views are provided and can be found in the app directory.

• Model Structure:

• Client code can be found in app/javascript and the code that we're most interested in lives in app/javascript/idea_board.

• The React components for the UI have also been provided, and the task for the student is to fill the data gap between the models responsible for persisting data and the client-side views.

Getting started

• Follow the README instructions for setting up the project.
• Check that the app is available at localhost:3000. You should see a login button, an Add Idea button, and the message "There aren't any ideas yet!". We'll be fixing that soon!
• Move on to the GraphQL Introduction!