0.0.1 • Published 10 years ago

ferry v0.0.1

Weekly downloads
-
License
MIT
Repository
-
Last release
10 years ago

Ferry

Simple express middleware for server-side routing with React.

npm install ferry

Usage

##1. Call ferry.route with your configuration in the express app.use function to use ferry as middleware.

var Main = React.createFactory(require('./app/components/Main'));
var ferry = require('./ferry.js');
var app = express();

app.use(ferry.route({ /* config options */ }));

ferry.route options

ferry.route accepts an options object, with 3 required parameters:

  • parentComponentFactory is a React factory.
  • htmlPath is the file path of the layout HTML file.
  • routes is a JSON array of route objects consisting of a path and componentFactory.
app.use(ferry.route({
    parentComponentFactory: Main,
    htmlPath: __dirname + '/public/layout.html',
    routes: [
        {
            path: '/',
            componentFactory: Home
        },
        {
            path: '/work',
            componentFactory: Work
        },
        {
            path: '/contact',
            componentFactory: Contact
        }
    ]
}));

##2. Put "ferryTemplate" (without quotes) in the your HTML file. Ferry replaces this string with the HTML generated by your react component factory.

<!-- ... -->
<body>
    <div style="width:100%;height:100%;">
        ferryTemplate
    </div> 
</body>
<!-- ... -->

Running tests

npm test

License

MIT. Copyright (c) Sterling Whitley

reactreactroutingreactrouterreactexpressmiddlewarereactexpress
reactreact-dom
@everything-registry/sub-chunk-1659@zalastax/nolb-fer@infinitebrahmanuniverse/nolb-fer
0.0.1

10 years ago