Troubleshooting

An app is missing#

Check that its package manifest is inside a content root and that workspace globs include it. Inspect the Project panel for detected packages and framework hints.

The route tree is stale#

Run the project’s route-generation script and review Route Health again. Do not hand-edit generated route-tree files to satisfy a warning.

A script runs from the wrong directory#

Open the run configuration and select the intended nested app and package manager. Compare its environment file and arguments with the command that works in a terminal.

Report an issue#

Use email support and include:

• Your IDE edition and full build number from Help → About.
• The installed plugin version; this manual covers 2026.1.4.
• Relevant external-tool versions, the failing action, and a small reproducible example.
• The error message and relevant log excerpt, with credentials and private project data removed.

Use Help → Show Log in Finder/Explorer to locate IDE logs when requested. Describe what you expected to happen and whether the same operation works from a terminal.