> For the complete documentation index, see [llms.txt](https://roudi.gitbook.io/guia-navigation/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://roudi.gitbook.io/guia-navigation/using-guia/express-lore/quick-start.md).

# Quick Start

First, let's declare some destinations, in Guia, they are called a [NavigationKey](/guia-navigation/using-guia/the-lore/navigation-key.md)

<pre class="language-kotlin"><code class="lang-kotlin"><strong>@Parcelize
</strong>class HomeKey: NavigationKey

@Parcelize
class ProfileKey(val profileId: String): NavigationKey
</code></pre>

Then we declare a [Navigator](/guia-navigation/using-guia/the-lore/navigator.md):

```kotlin
val navigator = rememberNavigator(initialKey = HomeKey()) // Initial Key is optional
```

To link a [NavigationKey](/guia-navigation/using-guia/the-lore/navigation-key.md) to a Composable we can use the `builder` parameter in `rememberNavigator`:

```kotlin
val navigator = rememberNavigator(initialKey = HomeKey()) {
    screen<HomeKey> { HomeScreen() }
    bottomSheet<ProfileKey> { key -> ProfileScreen(profileId = key.profileId) }
    dialog<DialogKey> { DialogScreen() }
}
```

Alternatively, a key can host its own Composable, called a [NavigationNode](/guia-navigation/using-guia/the-lore/navigation-node.md), then we don't need to declare it in our builder, the builder is convenient in [Multi Module projects](/guia-navigation/using-guia/the-lore/multi-module-navigation.md)

```kotlin
class DetailsBottomSheetKey(
    val item: String
) : NavigationKey.WithNode<BottomSheet> {

    override fun navigationNode() = BottomSheet {
        Text(text = "Item: $item")
    }
}
```

To get the instance of our navigator and do some navigation:

*(For a list of all default operations provided by Guia check* [*Navigation Operations*](/guia-navigation/using-guia/the-lore/navigator/navigation-operations.md)*)*

```kotlin
@Composable
fun HomeScreen() {
    val navigator = requireLocalNavigator()
    
    // On Button click or some other event
    navigator.push(ProfileKey("some_id"))
    
    // We can also go back by calling pop
    navigator.pop()
}
```

Finally we render the navigator's state:

```kotlin
navigator.NavContainer()
```

We can also add some [Transitions](/guia-navigation/using-guia/the-lore/navigator-config/transitions.md), type-safe [Results](/guia-navigation/using-guia/the-lore/results.md), [bottom-nav](/guia-navigation/using-guia/the-lore/navhost.md) behaviour and more. Check [The Lore](/guia-navigation/using-guia/the-lore.md) for more comprehensive usage of Guia.