# toi

> A tiny headless React utility for building imperative dialogs/toasts.

## Guide

- [Introduction](/toi/guide/start/introduction.md): What toi is, the problem it solves, and how mounting, resolving, and exit animations fit together.
- [What "toi" Means](/toi/guide/start/name.md): The Japanese word behind the name — 問い (toi), a question — how to say it, what the kanji 問 is made of, and how the logo grew out of it.
- [Quick Start](/toi/guide/start/quick.md): Install toi, mount ToiHost, and await your first component.
- [Mounting the Host](/toi/guide/basic/mounting.md): Why ToiHost is required, where components mounted by toi actually render, and its built-in accessibility semantics.
- [Resolving](/toi/guide/basic/resolving.md): Resolving with or without a value, rejecting instead, calling resolve or reject multiple times, and how exit animations delay unmounting.
- [Closing on Navigation](/toi/guide/basic/navigation.md): Why components mounted by toi stay open across page transitions, and how to close them on navigation with the currententrychange event or @praha/react-kit.
- [Reusable Functions](/toi/guide/basic/reusable-functions.md): Using toi.fn to bind a component to toi once and reuse the resulting function, optionally with default props.
- [Additional Props](/toi/guide/basic/additional-props.md): Passing a component props beyond ref, resolve, and reject, and how the required-versus-optional shape of those props is inferred.
- [Guide](/toi/guide/index.md): An overview of toi's guide — getting started, mounting the host, resolving, reusable functions, and additional props.