gitter-badger / iso

Tiny helper function for rendering JS on the server side and then bootstrapping on the client

Iso

Barebones isomorphic JavaScript helper

Iso only has two methods client and server

API

function server(html: string, data = {}: object, meta = {}: object): string

You provide the markup to server and some data you wish to pass down, and iso will return the markup needed to render.

function client(cb: function): undefined

client only takes in a callback which calls back with the data, meta, and a reference the container node on the DOM.

Usage

Iso is very barebones leaving some implementation details to the developer. There is a React plugin included which makes creating isomorphic React components easier.

Examples

datetime

Datetime is a minimal example showing how to render a React component on the server and then picking it back up on the client. It includes a click handler which updates the time, this click handler is initialized on the client. This example makes use of the react plugin.

datetime-flux

Datetime-flux is the same datetime example but using flux implementation alt. It seeds the stores with initial data on the server and then bootstraps them back on the client. The interaction is the same, a click handler is included which changes the time onClick.

react-router-flux

React-router-flux is a minimal example showing how to use react-router and alt in order to build isomorphic applications. The client file which handles the routing of components and the bootstrapping of stores is only 17 LOC.

License

MIT