bogdanbiv / relaybootserver

Barebones starting point for a Relay application.

Relay Boot Server

Most React/Relay apps have similar server requirements - this is an attempt to bootstrap such a server

This kit includes an app server, a GraphQL server, and a transpiler that you can use to get started building an app with Relay. For a walkthrough, see the Relay tutorial.

Project Plan

0. Start with Relay Starter Kit

• npm install
• smoke tests

1. Verify Webpack/React Transform features

• Simple React Component is rendered
• JSX transform
• Hot Module Reload
• Red Error flasher
• ES2015 support on the client

2. Verify GraphQL features

• seed database / backend/s
• Graffiti based schema
• extend schema with REST backend/s

3. Change webserver to Koa, add Lusca for security

• port middleware to use generators
• check http2 support in NodeJS (also check Webpack for compat)
• TLS encryption
• Detect connection performance (server ?)

4. Logging & monitoring

• bunyan
• weston

5. Authentication & Authorization:

• One approach to authentication/authorization with GraphQL-based server - https://github.com/mostr/graphql-auth
• Limit introspection capability programatically - graphql/graphql-js#113

6. Test suite

• Unit test components
• Component integration
• Mocha, Chai, Sinon
• WebDriver ?
• Karma (other runners ?)

7. Task runner

• Gulp / Slush
• Fly / Flightplan
• Deployment task
• Generate static site via React (server side) - during idle time
• Re/Generate schema (data/schema.json) and restart server
• Seed database

8. Cluster support

• Geo-optimisation ?
• latency ?

9. React tools

• GraphiQL
• Playground
• Block editors (Structor, Kattappa, Colonel Kurtz)

License

Relay Starter Kit is BSD licensed. We also provide an additional patent grant.

1043

relaybootserver's Issues

Project Plan

Project Plan (nov 2015)

1. Start with Relay Starter Kit
   • npm install
   • smoke tests
2. Verify Webpack/React Transform features
   • Simple React Component is rendered
   • JSX transform
   • Hot Module Reload
   • Red Error flasher
   • ES2015 support on the client
3. Verify GraphQL features
   • Compose schema sources
   • Graffiti based schema
   • schema with REST backend/s
   • seed database / backend/s
4. Webserver features
   • change Express to Koa, port middleware to use koa generators
   • add Lusca for security
   • port middleware to use generators
   • check http2 support in NodeJS (also check Webpack for compat)
   • TLS encryption
   • Detect connection performance (server ?)
5. Logging & monitoring
   • bunyan
   • weston
6. Authentication & Authorization:
   • One approach to authentication/authorization with GraphQL-based server - https://github.com/mostr/graphql-auth
   • Limit introspection capability programatically - graphql/graphql-js#113
7. Test suite
   • Unit test components
   • Component integration
   • Mocha, Chai, Sinon
   • WebDriver ?
   • Karma (other runners ?)
8. Task runner
   • Gulp / Slush
   • Fly / Flightplan
   • Deployment task
   • Generate static site via React (server side) - during idle time
   • Re/Generate schema (data/schema.json) and restart server
   • Seed database
9. Cluster support
   • Geo-optimisation ?
   • latency ?
10. React tools
    • GraphiQL
    • Playground
    • Block editors (Structor, Kattappa, Colonel Kurtz)

Verify Webpack/React Transform features

• Simple React Component is rendered
• JSX transform
• Hot Module Reload
• Red Error flasher
• ES2015 support on the client

Add Graffiti support

GraphQL server implementation examples

• I want to use only those technologies that make me excited about them. vslinko/ripster
• Example Relay TodoMVC application using graffiti-mongoose RisingStack/graffiti-todo
• React, Relay, GraphQL project skeleton fortruce/relay-skeleton
• A very simple starter for React Relay using Browserify mhart/simple-relay-starter
• Relay TodoMVC with routing
  • taion/relay-todomvc
  • http://fashionablenonsense.com/relay-todomvc
• Graphql with express, sqlite, and async-await mrblueblue/graphql-express-sqlite
  • Basic GraphQL example using the GitHub API devknoll gist for GraphQL server
• relay-starter-kit - Barebones starting point for a Relay application.
• swapi-graphql - A GraphQL schema and server wrapping swapi.
• graphql-server - GraphQL server with Mongoose (MongoDB) and Node.js.
  https://www.reindex.io/blog/building-a-graphql-server-with-node-js-and-sql/
• writing a Basic API with-graphql http://davidandsuzi.com/writing-a-basic-api-with-graphql/
• Building a GraphQL Server with Node.js and SQL https://www.reindex.io/blog/building-a-graphql-server-with-node-js-and-sql/

Compose schema sources

Needed to generate schemas that compose several backends. Will compose:

• Graffiti (mongo, ?couchdb)
• REST
• other ORMs (SQL)