Routing

Matching

Routes are matched with the following priority (highest at the top):

For a more thorough example, please check out the example router project.

Simple routes are routes with no variables. For example:

    pages
    ├── index.sh
    └── list.sh

Both of these are simple routes, matching requests to / and /list.

Dynamic routes have one or more variables, represented by files with square brackets.

    pages
    ├── multiple
    │   └── [variables]
    │       └── [route].sh

As an example, both requests to /multiple/a/b and /multiple/1/2 would match this route.

Catch-all routes have match one or more route segments.

    pages
    ├── catchall
    │   └── [...example].sh

As an example, both requests to /catchall/a and /catchall/a/b would match this route.

You can also make a catch-all segment optional to match 0 or more segments, like so:

    pages
    ├── catchall
    │   └── [[...example]].sh

This route would match all of the following request paths:

By default, bash stack will server files in the static/ folder. These files are available by making GET requests to /static/{filename}.