Lou Acresti namuol

2015-01-29 Unofficial Relay FAQ

Compilation of questions and answers about Relay from React.js Conf.

Disclaimer: I work on Relay at Facebook. Relay is a complex system on which we're iterating aggressively. I'll do my best here to provide accurate, useful answers, but the details are subject to change. I may also be wrong. Feedback and additional questions are welcome.

What is Relay?

Relay is a new framework from Facebook that provides data-fetching functionality for React applications. It was announced at React.js Conf (January 2015).

Building a Maintainable, Agile Architecture for Realtime, Transactional Apps

A maintainable application architecture requires that the UI only contain the rendering logic and execute queries and mutations against the underlying data model on the server. A maintainable architecture must not contain any logic for composing "app state" on the client as that would necessarily embed business logic in the client. App state should be persisted to the database and the client projection of it should be composed in the mid tier, and refreshed as mutations occur on the server (and after network interruption) for a highly interactive, realtime UX.

With GraphQL we are able to define an easy-to-change application-level data schema on the server that captures the types and relationships in our data, and wiring it to data sources via resolvers that leverage our db's own query language (or data-oriented, uniform service APIs) to resolve client-specified "queries" and "mutations" against the schema.

We use GraphQL to dyn

	// Usage : less2stylusDir('../src/css/');

	var fs = require('fs');

	// this less 2 stylus conversion script make a stylus easy to read syntax
	// - let the braces
	// - replace the @ for var as $
	// - let semicolons

	function less2stylus(less)

	/global module:false/
	module.exports = function(grunt) {
	// Load tasks
	grunt.loadTasks('util/grunt');

	// Load vendors tasks
	grunt.loadNpmTasks('grunt-contrib-compass');
	grunt.loadNpmTasks('grunt-contrib-uglify');
	grunt.loadNpmTasks('grunt-contrib-jshint');
	grunt.loadNpmTasks('grunt-contrib-watch');

	buildscript {
	repositories {
	mavenCentral()
	}
	dependencies {
	classpath 'com.android.tools.build:gradle:0.3'
	}
	}

	sourceCompatibility = JavaVersion.VERSION_1_6

	toRad = (p_angle) ->
	return (p_angle - 90) * Math.PI / 180

	for method in ["drawArc", "drawRoundRect", "drawSlice"]
	if PIXI.Graphics.prototype[method]? then console.warn "PixiJS already has an #{method} method defined. It's recommended that you update your code to use the official implementation."

	PIXI.Graphics.prototype.drawArc = (p_x, p_y, p_radius, p_startAngle, p_endAngle) ->
	totalAngle = p_endAngle - p_startAngle
	segments = Math.ceil Math.abs(Math.sqrt(1 - Math.pow (1 - Math.min(p_radius / 60, 1)), 2) * totalAngle * p_radius * 0.01)
	anglePerSegment = totalAngle / segments

	var AppConstants = require('../constants/AppConstants.js');
	var AppDispatcher = require('../dispatchers/AppDispatcher.js');
	var api = require('../utils/api');

	var ActionTypes = AppConstants.ActionTypes;

	module.exports = {
	create_customer: function(data){
	api.customer.create(data);
	}