What is compose-nav-graph?

Compose Navigation Graph is an Android Studio and IntelliJ IDEA plugin that turns an entire app's navigation flow, meaning every screen and every way a user can move between screens, into one visual, interactive map. Instead of a developer having to mentally piece together the flow from scattered code that defines routes and screen transitions across many files, the plugin shows every screen as a small rendered preview thumbnail and every transition between screens as an arrow that can be followed, with a double click jumping straight to the relevant source code. It works with apps built using Jetpack Compose, including both the newer Navigation 3 and the older Navigation 2 libraries, other Compose navigation libraries, and even apps that still use plain Android Activities instead of Compose screens. The toolkit is made up of four cooperating pieces. A set of annotations lets a developer mark which composable functions are navigation destinations, which connections exist between them, and which one is the root of the graph. A compiler plugin called a KSP processor reads those annotations and statically extracts each module's navigation graph into a JSON file at compile time, without needing to run the app in an emulator. A Gradle plugin renders device-free preview thumbnails of each screen, merges the graphs from all of a project's modules together, and adds several build tasks for generating, dumping, and checking the navigation graph. Finally, the IDE plugin itself draws the merged flow as an interactive diagram inside a dedicated tool window in Android Studio or IntelliJ. Beyond visualization, the project supports saving a navigation baseline file that can be committed to version control, so that pull requests can be checked against it, catching any unreviewed changes to destinations or transitions before they are merged. The README also mentions that its setup can be automated by feeding a bundled guide document directly to an AI coding assistant such as Claude Code, Cursor, or Gemini CLI, which can then apply the Gradle plugin, add the annotations to existing screens, and generate the first navigation graph automatically. The project is written in Kotlin, distributed through Maven Central and the JetBrains Marketplace, supports Android API level 24 and above, and is released under the Apache 2.0 license.