API Reference

Components

Export	Summary	Package	More
`Router`	Root container. Renders the active screen.	`@flemo/react`	Router
`Route`	Maps a path (or paths) to an element.	`@flemo/react`	Router
`Screen`	Per-route screen container with app/nav/safe-area slots.	`@flemo/react`	Screen
`LayoutScreen`	Screen variant for shared `layoutId` morphs across screens.	`@flemo/react-layout`	LayoutScreen
`LayoutConfig`	Wraps motion children with the current screen's transition timing.	`@flemo/react-layout`	LayoutScreen

Hooks

Export	Returns	More
`useNavigate()`	`{ push, replace, pop }`	Navigation
`useParams<T>()`	The current route's params (path + query merged)	Navigation
`useStep<T>()`	`{ pushStep, replaceStep, popStep }` for sub-states	Navigation
`useScreen()`	Current screen meta (`id`, `isActive`, `zIndex`, …)	—
`useViewportScrollHeight()`	Visual-viewport scroll metrics, useful for mobile keyboards	—

Transition factories

Export	When to use
`createTransition`	Six-phase transitions (idle / enter / exit / enterBack / exitBack)
`createRawTransition`	Full control over every navigate state
`createDecorator`	Six-phase decorator (e.g., overlays between screens)
`createRawDecorator`	Decorator with full per-state control

See Transitions for examples.

Built-in transition names

"cupertino" · "material" · "layout" · "none"

Built-in decorator names

"overlay"

Type registries

Interface	Purpose
`RegisterRoute`	Register your routes for type-safe `navigate.push` and `useParams`
`RegisterTransition`	Register custom transition names
`RegisterDecorator`	Register custom decorator names

declare module "@flemo/react" {
  interface RegisterRoute {
    /* … */
  }
  interface RegisterTransition {
    /* … */
  }
  interface RegisterDecorator {
    /* … */
  }
}

Type exports

ScreenProps · TransitionName · RegisterTransition · DecoratorName · RegisterDecorator

Peer dependencies

@flemo/react requires only react ^19 and react-dom ^19. @flemo/react-layout adds motion ^12 as a peer dependency — install it when you use <LayoutScreen> or <LayoutConfig>.

On this page