Getting Started

The Lift app is installed and managed through the GitHub marketplace at https://github.com/apps/sonatype-lift. Getting started with Lift is as easy as:

  1. Installing the GitHub app
  2. Selecting a few repositories to analyze
  3. Viewing any bugs found in the Lift Console

NOTE: These steps let you quickly see existing issues within your code base. Lift normally runs automatically at each pull request and reports only on new errors, delivering results as inline code review comments. Learn about our developer-centric approach to code analysis at Running Lift for more information.

GitHub App Installation

  1. Login to your GitHub account and go to the application settings page. Click install.

  2. Lift can be configured to analyze all of your repositories, or a select subset of them. Chose one of these options from the dialog, as show below. Click install.

image

  1. Review the application permissions and click Authorize Lift-Dev by LiftDev.

  2. Once the app is installed, you will be redirected to the Lift Console. Lift will now attempt to analyze pull requests for your repositoriies.

Analyze Your First Repository

When visiting the Lift Console, you will see a list showing all repositories you have installed the Lift app on (for each organization seperately).

From this screen, you can select any repository for Lift to get started analyzing. Simply click the “Analyze Now” button. You will then be forwarded to the analysis view where you can watch Lift inspect your code.

If you want to try out Lift, but you don’t have a suitable repository on-hand, see this guide to clone a test repo and see Lift working.

The yellow color of the page indicates that Lift is building and analyzing your code. This can take some real time (roughly twice the normal build time of your project), so feel free to stretch, grab a cup of coffee, or whatever. Lift will take it from here. Once Lift has finished analysis, you will be able to view the results by clicking on the results tab. If there is a problem with analysis you may also click to see the failing build log. See Troubleshooting page for help if there is a build error.

If you made it here, you’re all good to go! You can see the existing bugs that Lift found in your repositories, and any installed repositories will be analyzed every time you create a pull request in GitHub. For more information on that workflow see Running Lift. Happy Lifting!