> Markdown version of [Basic Routing and Navigation](https://vaadin.com/docs/v23/application/routing-navigation). Section index: [llms.txt](https://vaadin.com/docs/v23/application/llms.txt)

# Basic Routing and Navigation

You can navigate around the views in an application in two basic ways: either by interacting with the UI or by entering a URL to directly navigate to a specific view. When navigating with buttons or other components in a UI, the browser URL can be updated to reflect the current view. The user can then copy or link the URL to give direct access to the specific view.

[Image: routing navigation]

Routing URLs to content

*Routing* maps URLs to views or resources to navigate directly to the desired content or functionality. Typically, the root route `/` shows a main view, a route such as `/users` could show a sub-view that displays a list of users, and a route with the user ID as a parameter, such as `/users/dadams`, would show a specific user.

You can have routes to views written in either Java or TypeScript, and you can mix them in the same application. While Java views require a server connection, TypeScript views also work offline.

In Java views, use the `@Route` annotation to define a route for a view.

**Java** — `LoginScreen.java`

```java
@Route("/login")
public class LoginScreen extends Div {
    public LoginScreen() {
        LoginForm loginForm = new LoginForm();
        // Implementation details omitted
        add(loginForm);
    }
}
```

In TypeScript, the routes are normal custom elements. Routes to the elements are defined in the `index.ts`. You need to give the router a list of all routes. Routes to server-side Flow views are generated automatically, so that you only need to import them.

**TypeScript** — `index.ts`

```typescript
import { Router } from '@vaadin/router';
import { Flow } from '@vaadin/flow-frontend';

// Get automatically generated routes to server-side views
const { serverSideRoutes } = new Flow({
  imports: async () => import('../../../../../target/frontend/generated-flow-imports'),
});

export const router = new Router(document.querySelector('#outlet'));

// List all the application routes here
router.setRoutes([
  {
    path: 'routing-login',
    component: 'routing-login',
    action: async () => {
      await import('./routing-basic');
    },
  },
  {
    path: 'routing-registration',
    component: 'routing-registration',
    action: async () => {
      await import('./routing-registration');
    },
  },
  // For server-side, the next magic line sends all unmatched routes:
  ...serverSideRoutes, // IMPORTANT: this must be the last entry in the array
]);
```

**TypeScript** — `routing-basic.ts`

```typescript
import { html, LitElement } from 'lit';
import { customElement } from 'lit/decorators.js';
import '@vaadin/button';
import '@vaadin/form-layout';
import '@vaadin/password-field';
import '@vaadin/text-field';
import '@vaadin/vertical-layout';

@customElement('routing-login')
export class LoginView extends LitElement {
  protected override render() {
    return html`
      <vaadin-vertical-layout style="width: 15em">
        <vaadin-form-layout>
          <vaadin-text-field label="Username" clear-button-visible></vaadin-text-field>
          <vaadin-password-field label="Password" clear-button-visible></vaadin-password-field>
        </vaadin-form-layout>

        <a href="routing-registration">Register</a>
      </vaadin-vertical-layout>
    `;
  }
}
```

See [Creating a Main View](https://vaadin.com/docs/v23/application/main-view.md) for an introduction to creating a main view with a menu bar to select from a set of sub-views. To navigate to a view, you need to get a link to the view.

The following features are supported:

- Child routes, such as `/main/users` and `/main/premises`.

- Route aliases, such as showing `/main/users` as the default view when `/main` is entered.

- Fallback routes, such as showing an error page for a path such as `/users/invaliduser`.

- Route parameters, such as `/users/:userid` to catch URLs such as `/users/dadams`.

- Redirects, such as redirecting root route `/` to `/login`.

`99AFCB95-B7F9-4C8A-898F-7FFF7BDA0743`
