kotlin-navigation-compose-multiplatform

Guide Kotlin developers in implementing navigation in Compose Multiplatform projects.

1|Updated Apr 10, 2026
One-click install
npx skills add https://github.com/huneyoliv/ubus-ui --skill kotlin-navigation-compose-multiplatform-huneyoliv
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: kotlin-navigation-compose-multiplatform
Source: https://github.com/huneyoliv/ubus-ui/tree/main/.agents/kotlin-navigation-compose-multiplatform
Command: npx skills add https://github.com/huneyoliv/ubus-ui --skill kotlin-navigation-compose-multiplatform-huneyoliv

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) and references (resource) components.

What problem does it solve?

This Skill addresses the challenges of designing, implementing, and reviewing navigation in Compose Multiplatform projects, ensuring clear route modeling, controlled navigation side effects, and minimal argument passing.

Core Features & Use Cases

  • Navigation Modeling: Provides guidance on explicit and typed route models.
  • NavController Ownership: Ensures a single owner for NavController and controlled navigation events.
  • Back Stack Management: Helps in managing back stack ownership and state.
  • Navigation Policy: Offers recommendations for navigation policies like popUpTo, inclusive, saveState, and restoreState.
  • Argument Passing: Focuses on minimal and stable argument payloads.
  • Conditional Navigation: Suggests shared state-based conditional navigation.
  • Deep Links: Guides on explicit and non-overlapping deep-link patterns.
  • Adaptive UI: Recommends adaptive navigation UI for different window sizes.
  • Navigation Host Architecture: Provides advice on navigation host and app shell decomposition.
  • Animated Transitions: Offers best practices for animated transitions.
  • Destination Isolation: Emphasizes meaningful UI boundaries for each destination.
  • Testability: Ensures navigation architecture is testable.
  • Use Case: For a KMP project, this Skill can help streamline the navigation architecture, making it more robust and maintainable.

Quick Start

Run the skill on your Compose Multiplatform project to ensure adherence to best navigation practices.

Frequently Asked Questions about kotlin-navigation-compose-multiplatform

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I design navigation architecture for a Compose Multiplatform project?

Design navigation architecture in Compose Multiplatform by establishing explicit route models, enforcing a single NavController owner, and applying stack shaping rules like saveState and restoreState for robust back stack management.

What is the best way to manage the NavController in Compose Multiplatform?

Managing the NavController in Compose Multiplatform requires establishing a single owner to control navigation events, which prevents side effects and maintains a predictable back stack state across destinations.

How do I handle deep links and argument passing in Kotlin Compose Multiplatform?

Handle deep links in Kotlin Compose Multiplatform by defining explicit, non-overlapping patterns, and maintain argument passing discipline by sending only minimal, stable payloads to destinations.

Does this navigation guidance apply to Jetpack Navigation 2 and KMP projects?

Yes, this navigation guidance applies to Kotlin Multiplatform (KMP) projects, specifically requiring familiarity with Compose Multiplatform and Jetpack Navigation 2 to implement route modeling and adaptive UI correctly.

When should I use popUpTo and saveState for back stack management in Compose Multiplatform?

Use popUpTo, inclusive, saveState, and restoreState as navigation policies in Compose Multiplatform to precisely shape your back stack, manage state restoration, and control destination clearing.