Skip to content
A simple middleware-style router for isomorphic JavaScript web apps
TypeScript JavaScript
Branch: master
Clone or download

Latest commit

Fetching latest commit…
Cannot retrieve the latest commit at this time.

Files

Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
.github Upgrade path-to-regexp from v3 to v6 (#183) Feb 27, 2020
.vscode Upgrade path-to-regexp from v3 to v6 (#183) Feb 27, 2020
dist Fix typings: `router.resolve()` and `context.next()` always return a … Mar 11, 2020
docs Upgrade path-to-regexp from v3 to v6 (#183) Feb 27, 2020
src Fix typings: `router.resolve()` and `context.next()` always return a … Mar 11, 2020
tools Upgrade path-to-regexp from v3 to v6 (#183) Feb 27, 2020
.editorconfig Fix context.next() to throw Route not found instead of TypeError (#169) Jul 19, 2019
.eslintignore Upgrade path-to-regexp from v3 to v6 (#183) Feb 27, 2020
.eslintrc.js Upgrade path-to-regexp from v3 to v6 (#183) Feb 27, 2020
.gitattributes Fix context.next() to throw Route not found instead of TypeError (#169) Jul 19, 2019
.gitignore Upgrade path-to-regexp from v3 to v6 (#183) Feb 27, 2020
.huskyrc Upgrade path-to-regexp from v3 to v6 (#183) Feb 27, 2020
.prettierrc.js Upgrade path-to-regexp from v3 to v6 (#183) Feb 27, 2020
.travis.yml Update .travis.yml Nov 7, 2019
CHANGELOG.md 9.0.1 Mar 11, 2020
LICENSE.txt Update Babel and reduce library size Jan 28, 2018
README.md Upgrade path-to-regexp from v3 to v6 (#183) Feb 27, 2020
jest.config.js Upgrade path-to-regexp from v3 to v6 (#183) Feb 27, 2020
logo.svg Add logo Jan 28, 2018
package.json 9.0.1 Mar 11, 2020
tsconfig.json Upgrade path-to-regexp from v3 to v6 (#183) Feb 27, 2020

README.md

Universal Router

NPM version NPM downloads Library Size Online Chat

Visit Universal Router Website

A simple middleware-style router that can be used in both client-side and server-side applications.

Visit Quickstart Guide (slides)  |  Join #universal-router on Gitter to stay up to date

Features

What users say about Universal Router

Just switched a project over to universal-router. Love that the whole thing is a few hundred lines of flexible, easy-to-read code.

-- Tweet by Greg Hurrell from Facebook

It does a great job at trying to be universal — it's not tied to any framework, it can be run on both server and client, and it's not even tied to history. It's a great library which does one thing: routing.

-- Comment on Reddit by @everdimension

Installation

Using npm:

npm install universal-router --save

Or using a CDN like unpkg.com or jsDelivr with the following script tag:

<script src="https://unpkg.com/universal-router/universal-router.min.js"></script>

You can find the library in window.UniversalRouter.

How does it look like?

import UniversalRouter from 'universal-router'

const routes = [
  {
    path: '', // optional
    action: () => `<h1>Home</h1>`
  },
  {
    path: '/posts',
    action: () => console.log('checking child routes for /posts'),
    children: [
      {
        path: '', // optional, matches both "/posts" and "/posts/"
        action: () => `<h1>Posts</h1>`
      },
      {
        path: '/:id',
        action: (context) => `<h1>Post #${context.params.id}</h1>`
      }
    ]
  }
]

const router = new UniversalRouter(routes)

router.resolve('/posts').then(html => {
  document.body.innerHTML = html // renders: <h1>Posts</h1>
})

Play with an example on JSFiddle, CodePen, JS Bin in your browser or try RunKit node.js playground.

Documentation

Books and Tutorials

Browser Support

We support all ES5-compliant browsers, including Internet Explorer 9 and above, but depending on your target browsers you may need to include polyfills for Map, Promise and Object.assign before any other code.

For compatibility with older browsers you may also need to include polyfills for Array.isArray and Object.create.

Contributing

Anyone and everyone is welcome to contribute to this project. The best way to start is by checking our open issues, submit a bug report or feature request, participate in discussions, upvote or downvote the issues you like or dislike, send pull requests.

Support

Related Projects

  • React Starter Kit — Boilerplate and tooling for building isomorphic web apps with React and Relay.
  • Node.js API Starter Kit — Boilerplate and tooling for building data APIs with Docker, Node.js and GraphQL.
  • ASP.NET Core Starter Kit — Cross-platform single-page application boilerplate (ASP.NET Core, React, Redux).
  • Babel Starter Kit — Boilerplate for authoring JavaScript/React.js libraries.
  • React App SDK — Create React apps with just a single dev dependency and zero configuration.
  • React Static Boilerplate — Single-page application (SPA) starter kit (React, Redux, Webpack, Firebase).
  • History — HTML5 History API wrapper library that handle navigation in single-page apps.
  • Redux-First Routing — A minimal, framework-agnostic API for accomplishing Redux-first routing.

Sponsors

Become a sponsor and get your logo on our README on Github with a link to your site. [Become a sponsor]

Backers

Support us with a monthly donation and help us continue our activities. [Become a backer]

License

Copyright © 2015-present Kriasoft. This source code is licensed under the MIT license found in the LICENSE.txt file. The documentation to the project is licensed under the CC BY-SA 4.0 license.


Made with ♥ by Konstantin Tarkus (@koistya, blog), Vladimir Kutepov and contributors

You can’t perform that action at this time.