1.1.0 • Public • Published


    Connect middleware that rewrites select requests to the site root, allowing your client-side pushstate router to handle them.

    Requests including a file extension are left untouched so site assets like your images, stylesheets, and JavaScripts will load unaffected, while requests without a file extension, presumably pages or actions within your site, are rewritten to point at the root, with the original URL intact.

    You can also specify regular expressions to specifically allow or disallow additional paths from being affected.

    This functionality is commonly needed by single page web-apps.

    Getting Started

    Install package

    npm install connect-pushstate --save

    Load the middleware by adding the following line of JavaScript.

    var pushState = require('connect-pushstate');

    Add the pushState middleware call to your server definition, amongst your other middleware.


    The pushState method accepts an options object as an optional parameter with the following properties.

    • root - The location where requests will be rerouted to. Defaults to '/'. e.g. pushState({ root: '/foo' })
    • allow - A pattern that will allow requests matching it to pass through without being redirected. e.g. pushState({ allow: '^/api' }) You might need this option if your client app and API are on the same server.
    • disallow - A pattern that will disallow requests matching it to pass through without being redirected. e.g. pushState({ disallow: '^/version/1.2.3' })
    'use strict';
    var connect = require('connect');
    var morgan = require('morgan');
    var serveStatic = require('serve-static');
    var pushState = require('connect-pushstate');
    var port = process.env.PORT || 3000;
    var app = connect()
    .listen(port, function() {
        console.log('Application server stated on port', port);

    Note that serve-static is needed in order to actually serve your files.


    For a quick demo, see the examples directory, or run the test suite.

    cd examples
    node server.js


    Execute the test suite

    npm test


    In lieu of a formal styleguide, take care to maintain the existing coding style. Add unit tests for any new or changed functionality. Lint and test your code.

    Release History

    • 1.1.0 Add "disallow" option. Add grunt package to devDependencies.
    • 1.0.0 Introduce options object. Add "allow" option. Simplify directory structure. Update dependencies. Other minor housekeeping.
    • 0.1.0 Initial release


    npm i connect-pushstate

    DownloadsWeekly Downloads






    Last publish


    • brentertz