react-server

React framework with server render for blazing fast page load and seamless transitions between pages in the browser.

---

What is it?

React Server is an Express middleware for serving universal (isomorphic) JavaScript applications built with React.

Read more on our dev blog.

Getting started

The easiest way to get started is with our yeoman generator:

# install yeoman
npm install -g yo

# install the react-server generator
npm install -g generator-react-server

# make a new react-server project in the CURRENT directory
yo react-server

# compile and run the new app
npm run compile
npm run start
# go to http://localhost:3010

That hooks you up with react-server-cli, which will take care of the server part and get you up and running right away.

Why react-server?

One of the great things about React is its support for server-side rendering, which can make sites show up faster for users and play better with search engine bots.

However, when you actually try to use React for server-side rendering, you quickly run into a bunch of practical problems, such as:

• How should I load data on the server for my components?
• How do I ensure that the client and the server load the same data and generate the same HTML markup?
• How do I write code that can be both generated server-side and be part of a single-page application (SPA)?
• How should I optimize the delivery of my JavaScript and CSS?
• How do I find out about and follow performance best practices?
• How do I ensure that my site is streamed to the browser as quickly as humanly possible?
• How can I make my app resilient when my backend has high latency spikes?

react-server is a framework designed to make universal (neé isomorphic) React easier to write, providing standard answers for these questions and more. When you write your app for react-server, you concentrate on your React components, and react-server takes care of everything else that's needed to run and deploy real React server-rendered apps. Under the hood, react-server is doing a bunch of clever optimizations, many borrowed from the ideas behind Facebook's Big Pipe, to make sure that your site shows up as quickly as humanly possible for your users.

Once you're hungry for more, dig into the docs.

Changelog

v0.3.3 (2016-06-30)

Enhancement

• babel-plugin-react-server, babel-preset-react-server
  • #301 Add babel module tagging. (@doug-wade)
• react-server-gulp-module-tagger, react-server-module-tagger
  • #300 Add react server module tagger. (@doug-wade)

Performance

• react-server
  • #288 Reduce nodeArrival calls by taking in range of node indices. (@SteveVitali)

Bug fix

• babel-plugin-react-server
  • #322 add dev dependency on babel-cli to babel plugin. (@doug-wade)
• react-server-cli
  • #318 Downgrade webpack-dev-server to 1.13.0. (@gigabo)
• generator-react-server
  • #298 Validate project name in generator to ensure it's a valid npm package name. (@latentflip)

Security

• react-server-cli
  • #308 Resolve nsp 118 for react-server-cli. (@doug-wade)
• generator-react-server
  • #307 Exempt nsp 120. (@doug-wade)
• react-server
  • #305 Adding X-Content-Type-Options: nosniff header. (@roblg)

Commiters: 6

• Bo Borgerson (gigabo)
• Douglas Wade (doug-wade)
• Philip Roberts (latentflip)
• Robert Gay (roblg)
• Sasha Aickin (aickin)
• Steve Vitali (SteveVitali)