Prepare your project

When Qodana runs on your project, it tries to figure out the build system and project structure by itself. If Qodana cannot figure out the project structure, it will run the inspections nevertheless, but some inspections may report that they cannot find classes, packages, files or cannot resolve references. In these cases, Qodana needs a bit of help. Typical actions to prepare the project for Qodana are:

Install third-party packages or libraries
Run a program that sets up the build environment

These actions are carried out using the bootstrap key of the qodana.yaml file contained in the root directory of your project:

bootstrap: |+
  set -eu
  # For PHP projects that use Laravel:
  #composer require --dev barryvdh/laravel-ide-helper

  # For JavaScript projects that use Node.js:
  #npm install

To be able to use syntax highlighting and validation in your IDE, you can create the prepare-qodana.sh shell script and save it to the root directory of your project:

#! /bin/sh
# Example bootstrap steps, see https://jetbrains.com/help/qodana/before-running-qodana.html
set -eu

# For PHP projects that use Laravel:
#composer require --dev barryvdh/laravel-ide-helper

# For JavaScript projects that use Node.js:
#npm install

Run the script within a Qodana Docker container using the bootstrap key:

bootstrap: sh ./prepare-qodana.sh

Last modified: 30 April 2024