8.9 | User guide | Project page

On this page

Project page

The Project homepage is the entry point of any project showing:

  • the releasability status of the project.
  • the current state of its quality.
  • the quality of what has been produced since the start of your new code.

The Project homepage answers two questions:

  • Can I release my project today?
  • If I cannot release it today, what should I improve to make the project pass it's quality gate?

Quality gate

Since the quality gate is your most powerful tool to enforce your quality policy, the page starts with the project's current quality gate status. If the project passes, the Quality Gate Status will show a simple, green all-clear banner.

If not, details and drill-downs are immediately available to quickly identify what went wrong, with a section for each error condition showing what the current project value is and what it should be. As usual, you'll be able to click through on current values to get more details about each issue.

Prioritizing issues

Because the best way to improve a project's quality is to catch and fix new problems before they become entrenched, the first view of a project is centered around new code which is highlighted in yellow on the right of the project homepage. The project space page shows a high-level summary of critical metrics, including current values, and their new code values.

Just below the quality gate information, you have the numbers of old and new issues in the reliability and security domains and then the maintainability domain. Clicking on any figure on the page will take you to a detailed view, either on the Measures page or the Issues page.

The most important thing a developer must do is to ensure the new issues in the yellow part of the screen are acknowledged, reviewed, and fixed to make sure that new code is covered by tests that help prevent future regressions. Regardless of how many Issues were introduced in the past or how little test coverage there is overall, focusing on newly added issues will ensure that the situation won't degrade versus the version you previously released in production.

Which issues should you go after first? Bugs, vulnerabilities or code smells? The correct answer depends on the nature of your issues. Let's say you have issues with a block of code that is duplicated 5 times, and inside this duplicated block of code, you have 3 bugs and 5 security issues. The best approach is probably to fix the duplication first, then resolve the bugs and vulnerabilities in the new centralized location, rather than fixing each bug and vulnerability 5 times.

This is why you need to review your new issues before jumping into resolving each.

Viewing project measures at a lower level

The project-level Measures menu item takes you to a dedicated sub-space where you see all project measures. Select a measure for more details. Both list and tree views are available for each measure, and treemaps are available for percentages and ratings.

Viewing all issues in a project

The project-level Issues menu item takes you to a project-specific issues page, where you can perform all the same actions you can at the higher level. On this page, you can easily narrow the list to the new issues as set by your new code definition, by selecting New Code in the Creation Date facet.

Viewing project structure and code

The project-level Code menu item takes you to an outline of your project structure. Drill down to see files in a directory, and choose a file to see its code.

If your project is too large for easy exploration via drilling, the search feature on this page will help. While the global search in the main menu returns results from throughout the SonarQube instance, the localized search on the code page is restricted to files and directories in the current project.

Viewing project activity and history

The project-level Activity menu item takes you to the full list of code scans performed on your project since it was created in SonarQube. By going there you can follow the evolution of the quality gate, see the changes in quality profiles, and know when a given version of your code has been scanned.

Spotting risks with visualizations

Visualizations allow you to compare project components and quickly spot the ones that represent the greatest risks. The Activity page offers several pre-defined visualizations, and you can also create custom visualizations with the metrics of your choice.

Using project badges to promote project health

You can promote your project's status in third-party tools and external websites using project badges. You can find the project badges by opening the Project Information menu in the upper-right corner of the project home page and clicking Get project badges. From here, you can choose and fine-tune your badge then copy the markdown text or image URL for it.

Using project badges can expose sensitive information like your security rating and other metrics. Because of this, you should only use them in trusted environments.

Note that it is not possible to create project badges for private projects.

© 2008-2024 SonarSource SA. All rights reserved. SONAR, SONARSOURCE, SONARLINT, SONARQUBE, SONARCLOUD, and CLEAN AS YOU CODE are trademarks of SonarSource SA.

Creative Commons License