by zackify

react router v4 async routing

130 Stars 5 Forks Last release: almost 3 years ago (0.2.2) 25 Commits 8 Releases

Available items

No Items, yet!

The developer of this repository has not created any items for sale yet. Need a bug fixed? Help with integration? A different license? Create a request here:

Async Routing

TODO: - server render - make route config optional

React router v4 is awesome, but one thing is missing! Async routes. There's a couple components out there but they all have the same problem, on route change, the component will return null, then load the page. This makes for an annoying user experience. This package will wait for the bundle before a route change, and also allow you to preload pages!

You must be using webpack 2 along with syntax-dynamic-import to use this package!


npm install react-router-async-routing


Create a routes file, with the pathname and path to your component files

export default [
    path: '/employers',
    dataPath: 'employers',
    path: '/test/:name',
    dataPath: 'test/index',

Create a

file that will export
, and
components for you to use in place of the built in components in v4:
import routes from './routes';
import AsyncSetup from 'react-router-async-routing'

const { Route, Link, Preload } = AsyncSetup(routes, path => import(./views/${path}.js));

export { Link, Route, Preload };

The first argument is your routes array, the second is a function that takes a path (the dataPath in the routes file) and load the component according to its location.

Now, render your routes using the components from the file you just created!

import { Route } from './router'

.... { => )}

Now, you can link to any page like you're used to, just

import { Link } from './router'

Preloading routes

Note: If you use a service worker, this isn't really needed. Except on older browsers.

If a user is on the homepage, and you'd like to load the about page ahead of time, just render this inside of your homepage:

export const Home = (



The route will be loaded in the background :)

Custom loading

If you need to do more than just async load a route, you can make your own loader by importing components directly:

import LinkBuilder from 'react-router-async-routing/link'

const CustomLink = LinkBuilder( async ({ path }) => await somePromise() )

The function passed will be

ed on any time a link is clicked.

We use cookies. If you continue to browse the site, you agree to the use of cookies. For more information on our use of cookies please see our Privacy Policy.