A view-agnostic router that uses MobX to manage its internal state. Built to handle the complex requirements of modern-day, universal web applications.
Our development team use MobX as the state management library for most of our applications.
Routing has become increasingly complex in recent times, and we believe that routing libraries should be updated to reflect this reality. We've tried several existing routers in the React + MobX ecosystem, but none has met our requirements or functioned exactly the way we want it to. And so we built our own router.
Here are what you get from mobx-little-router out of the box.
-
State management and change detection that lives completely within MobX, so you have one source of truth for all data in your application, and one way for data to change.
-
Support for dynamically loaded routes on both client and server environments. This is key for building modern-day progressive web apps.
-
View-agnostic routing capabilities. This means adapters other than React can be created by hooking into the router state.
-
Extensible
dataobjects that is provided on each route node. This allows additional data and behaviour to be created for future use cases. -
Static type support for Flow.
For more information, you may refer to the README files for each of the packages under MobX Little Router.
This project is a monorepo that contains several smaller packages.
To manage the different packages, lerna and yarn workspaces are used.
Make sure you have yarn >= 0.28.0 and workspace enabled.
npm install -g yarn@">=0.28"
yarn config set workspaces-experimental true
Run git clone and install.
git clone git@github.com:mobx-router/mobx-router.git mobx-router
cd mobx-router
yarn install
To build packages, run yarn build from either the root, or a package directory.
To run tests, run yarn test from either the root or a package directory.