Getting Started

Config-based routing

Edit this page

Solid Router allows for configuration-based routing, where JSX is not needed to set up routes.

To define a single route, a route definition object can be passed to the <Router> component:

import { render } from "solid-js/web";
import { Router } from "@solidjs/router";
const routes = {
path: "/",
component: import("/routes/index.js"),
}
render(() => <Router>{routes}</Router>, document.getElementById("app"));

In the route definition object, a path property must be provided to define the path to match and a component property that specifies the component (or element) to render when the path matches.

To define multiple routes, an array of route definition objects can be passed to the <Router>] component:

import { render } from "solid-js/web";
import { Router } from "@solidjs/router";
const routes = [
{
path: "/",
component: import("/routes/index.js"),
},
{
path: "/hello-world",
component: <h1>Hello, World!</h1>
},
{
path: "/about",
component: import("/routes/about.js"),
}
]
render(() => <Router>{routes}</Router>, document.getElementById("app"));

Each path in the array of route definition objects will be matched against the current URL, and the corresponding component will be rendered when a match is found. In the example above, the root path (/) renders the Home page, the path /hello-world renders an h1 element, and the path /about renders the About component.

Report an issue with this page