# Routing

Routing in Gravity depends on your architecture:

**Next.js**

* Routing is file-based inside the `/app` directory.
* Each folder or file in `/app` becomes a route automatically.
* Layouts, server actions, and views can be co-located for simpler imports and faster development.
* Permissions and private routes can be implemented using middleware or wrapper components around page components.
* Adding a new route is as simple as adding a new file. 

**Node.js**  

* Routing is handled **client-side** with `react-router-dom`.
* All routes are defined in `/client/src/routes` and should be imported in `/client/src/app/app.js`.

## **Defining a New Route (Node.js)**

Routes are defined in their respective file inside `/client/src/routes`. To add a new route,  import the [View](https://docs.usegravity.app/gravity-native/components/view) component and add a new object to the route array.

```javascript
  {
    path: '/account/password',
    view: Password,
    layout: 'app',
    permission: 'user',
    title: 'Your Password'
  },
```

Public routes without a permission (such as the auth pages) are generated using the standard  `<Route>` component included with React Router.

```javascript
<Route path={ route.path } element={
  <View display={ route.view } layout={ route.layout } title={ route.title  } />
}/>
```

### Props

| name    | description                   |          |
| ------- | ----------------------------- | -------- |
| title   | page title                    | string   |
| layout  | name of view layout component | string   |
| display | view component with child     | function |

Gravity also contains a  **\<PrivateRoute>** component that enables you to protect routes with a user permission. **\<PrivateRoute>** accepts an optional **permission** prop.

```javascript
<Route path={ route.path } element={
  <PrivateRoute permission={ route.permission }>
    <View display={ route.view } layout={ route.layout } title={ route.title }/>
  </PrivateRoute>
}/>
```

## Code Splitting

If you would like to introduce route splitting to create separate bundles in your application, you can do so by simply lazy loading the view in the route file.

{% hint style="warning" %}
You will need to ensure that your relevant view component is exported as the default export for this to work.
{% endhint %}

```javascript
const Routes = [{
 path: '/dashboard',
 view: lazy(() => import('views/dashboard')),
 layout: 'app',
 permission: 'user',
 title: 'Your Dashboard'
}]
```