You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
Starbeamrainbowlabs bf05f58f4d
Merge branch 'master' of
1 month ago
Client Fix resolution logic & tree-shaking 1 year ago
Server Add more code examples 9 months ago
Shared Use default exports & imports to try to avoid tree-shaking issues 1 year ago
examples Add parse post data middleware example 9 months ago
lantern-build-engine @ 617fcdb5b9 Start setting up for CI 1 year ago
.gitignore Start setting up for CI 1 year ago
.gitmodules Start setting up for CI 1 year ago
.npmignore Add parse post data middleware example 9 months ago
.tern-project Import from Nibriboard-Panel 1 year ago
Client.mjs Fix resolution logic & tree-shaking 1 year ago
FUNDING.yml Add FUNDING.yml 5 months ago
LICENSE Initial commit 1 year ago Add more code examples 9 months ago
Server.mjs Fix resolution logic & tree-shaking 1 year ago
build Alter git remote url when rendering docs to fix github urls 1 year ago
docs.css Change placeholder text colour 1 year ago
index.mjs Add logo & licence 1 year ago
logo-large.png Fix resolution logic & tree-shaking 1 year ago
logo.piskel Add logo & licence 1 year ago
logo.png Fix resolution logic & tree-shaking 1 year ago
package-lock.json Merge branch 'master' of 1 month ago
package.json Update dependencies to fix security issues 1 month ago


Client and server-side routing micro frameworks

Powahroot is a pair of micro routing frameworks, presented as an ES6 module:

  • The first is for client-side single-page web applications
  • The other is for handling server-side Node.js requests

It’s based on rill (see the npm package bearing the name), but stripped down and simplified.

Getting Started

Install powahroot as a dependency with npm:

npm install --save powahroot

If your build process supports tree-shaking, only the router(s?) you need will be included in the final output of your build - as powahroot uses ES6 modules.



Powahroot supports multiple syntax bells and whistles when defining routes. These are documented below:

Syntax Meaning
/index.html Regular route. Matches exactly what it says on the tin.
* Special key(word?) that matches any route. Must be present on its own without any other characters.
/add/vegetable/:name/:weight Parameters. Match values an pull them into an object automatically. Does not like forward slashes in parameter values.
/images/::path Parameter values with forward slashes. If you want to use parameters, but need values to be able to contain forward slashes /, this is for you. Don’t forget you can mix-and-match this with the previous example!


Initialise a new router like this:

import ClientRouter from 'powahroot/Client.mjs';

// ....

const router = new ClientRouter({
	// Options object. Default settings:
	verbose: false, // Whether to be verbose in console.log() messages
	listen_pushstate: true, // Whether to react to browser pushstate events (excluding those generated by powahroot itself, because that would cause an infinite loop :P)

// Add a page
router.add_page("/add/vegetable/:name/:weight", (params) => {
    console.log(`We added a ${} with a weight of ${params.weight}g.`);

// Explicitly navigate to a page:


The server router works slightly differently, to account for the different environment it’s designed for. Here’s how to use it:

import ServerRouter from 'powahroot/Server.mjs';

// ....

const router = new ServerRouter();
// Logging middle ware
router.on_all(async (context, next) => {
    await next();
// Regular handlere
router.get("/files/::filepath", (context, _next) => context.send.plain(200, `You requested ${context.params.filepath}`));
// .....

// Later, when you've got a request / response pair to handle:
router.handle(request, response);

The context argument there is of type RouterContext. Check out the API reference (link below) to learn about the other useful properties it has.


API docs are generated automatically. View them here:

It contains full documentation on how to use everything, along with code examples to help you get started.


Contributions are welcome! Simply fork this repository, make your changes, and submit a Pull Request (issues are welcome too!).

All contributions must be declared to have the Mozilla Public License 2.0 (the same license that this repository is under).


Everything in this repository except the logo is licenced under the _Mozilla Public License 2.0.

The logo itself is © Copyright Starbeamrainbowlabs 2019. All rights reserved - though you may use it when linking to this project (or to advertise usage in a ‘powered by’ logo).