How-To's Tips & Tricks Tutorials

Five Things To Love About the New UI

Read this post in other languages:

Are you using the New UI yet? Not yet? Let me tell you why it’s the best thing since sliced bread!

Let’s get it enabled and take a look around. The easiest way to do that is from the Settings cog at the top-right of the UI:

Menu bar on the top-right to enable the new UI

PyCharm will need to restart, but that’s it; you’re done!

In this interface update, we have introduced more blank space around the various elements. This is to help separate content without adding elements such as dividers on the screen. If you prefer to have the UI elements a little bit smaller, you can select Compact in the Meet the New UI tool window (or later in your Settings by searching for “new ui”). This setting removes some white space and padding around interface elements.

There are a couple of themes that you might notice straight away, including the use of colour and element size to denote information hierarchy. 

For example, in the Dark theme, we have a dark gray bar at the top for common entry points to functionality such as VCS actions and Run actions and a black background for the editor. 

The new UI in full screen and dark mode

Let me give you a tour of the lovable little landmarks in this UI. 

#1 – The Main Toolbar

The Main toolbar is cleaner and has a more succinct layout. It has all the functionality you know and love. It is your one-stop shop for project-related information:

The main toolbar

Let’s go from left to right. The first area I want to talk about is the Project widget. This is where you can see the name of your current project, switch between recent projects, create new projects and open existing ones.

To the right of the Project widget is the VCS widget. This lets you quickly see the status of your project in version control, including the branch and if there are any outgoing (shown in green) or incoming (shown in blue) changes:

The VCS widget is right next to the name of the project, and it is now a clear entry point for functionality related to your project and version control when you click the drop-down arrow. You’ll see lots of these so-called “entry points” for functionality groups as we continue our tour.

Over to the right is your Run widget, which has been redesigned, so I’ll go into more detail in the next section.

Finally, on the very right-hand side of the Main toolbar, you have your more general icons, including Code With Me, Search Everywhere, and Settings. It’s worth noting if you like using your mouse, the Settings cog icon takes you to some top-level options that you’ll probably use most frequently, including Plugins, Theme, Keymap, and View Mode. I hope you don’t want to, but you can also switch back to the Classic UI here!

#2 – The Run Widget

Let’s look at the Run toolbar widget in more detail. The first thing you’ll notice is the bigger, bolder icons. These are great because they give you immediate visual feedback as to the state of your application. For example, before you run or debug your application, your Run widget looks like this:

If you click the Run icon, it’ll change to this:

Now you can see your application is running, and you can stop and re-run it, or stop it entirely. You could also click the debug icon, which will prompt you to stop the currently running application so you can run it with PyCharm’s debugger instead. 

If you run the application with PyCharm’s debugger, the widget will change to this:

You can still access all your run configurations from the drop-down menu, and for each one, choose how you want to run it as well:

Accessing your run configurations from the drop-down menu

The functionality for the currently selected run configuration is available from the vertical ellipse button too. 

#3 – The Tool Windows

The New UI brings you new icons, an improved layout, and the option to see more tool windows at any time. The new larger icons help reduce the cognitive load of trying to find what you are looking for because there’s less on the screen. 

I’ll show you how to customize where they are in the UI so you can quickly find them when you need them:

Tool windows highlighted on the left and right-hand side of the interface

You have the option to split your tool windows vertically. For example, in the screenshot below, the Commit tool window is below the horizontal separator bar. Tool windows can be dragged below the separator to open them in a vertical split:

Splitting tool windows vertically on the left-hand side of the interface

You can also split tool windows on the right-hand side in this way, too:

Splitting tool windows vertically on the right-hand side of the interface

Finally, if you want to split your tool windows on the bottom so one is on the left, and the other is on the right, drag the tool window you want to appear on the right-hand side to the right-hand bar. In the screenshot below, I’ve dragged my Problem tool window icon over to the right and then opened it alongside the Terminal tool window:

Splitting tool windows horizontally on the bottom of the interface

All the tool windows now use outline monochrome icons, which are more modern and don’t clutter the interface with any additional unnecessary information. If you do want to see the name and keyboard shortcut of any tool window, hover over the icon. Remember, the handy shortcut to hide all your toolbars is ⌘⇧F12 (macOS), or  Ctrl+Shift+F12 (Windows/Linux).

#4 – Run and Debug Tool Windows

Both the Run and Debug tool windows are now available from the window tab on the left. This is great from a standardisation perspective as it allows you to quickly access both the tool windows to manage the state of your application.

In addition, the Debug tool window has been updated to have one toolbar that contains the most common actions based on usage statistics. This might mean that some actions you’re used to clicking aren’t where you expect them to be! We haven’t removed any functionality, everything is still accessible, but for example, you may notice that the Evaluate Expression icon is gone. 

There are still plenty of ways to evaluate an expression. You can:

  • Use ⌥F8 (macOS), or Ctrl+F8 (Windows/Linux)
  • Use Shift Shift (macOS/Windows/Linux) for Search Everywhere and then type in “evaluate expression”
  • Select Evaluate Expression from the right-click context menu in the Debug tool window

There is also a dedicated field for evaluation in the Debug tool window:

Evaluate expression option when debugging

In addition to those changes, there are new tabs for switching between the Threads & Variables and Console views if there’s a single running configuration.

The Threads & Variables tab in the debugging tool window

#5 – The Editor

Last but not least, the editor has had a number of updates in line with the design choices we’ve made. It would be easy to overlook these changes in terms of what to love in the New UI, but these themes that run throughout have given the whole interface a fresh, clean, professional look as you move through your codebase.

The Light and Dark colour themes have improved contrast and a consistent colour palette to brighten up (or darken) your day:

Light theme in the editor with a breakpoint set

The iconography has been overhauled in the editor, too with more distinguishable shapes and colours. You will see these changes in the editor and the wider IDE. This has, in my opinion, given PyCharm a fantastic face-lift:

Icons in the Project tool window and editor

Breakpoints are now placed over the line numbers, saving horizontal space:

Setting a breakpoint on the line numbers in the margin

If, on the other hand, you prefer to have your breakpoints next to the line numbers, you can still do that by right-clicking in the gutter and then selecting Appearance > Breakpoints Over Line Numbers.

The colour palette for annotations for Git Blame has been updated. The lighter the shade, the older the change is. Conversely, the darker the shade, the newer the change is:

Git blame annotations with different shading, lightest is oldest, darkest is newest

Summary

Finally, this blog post wouldn’t be complete without talking about why we have updated the interface for JetBrains IDEs. We have gathered a lot of feedback from our users over the past few years, and we learned that our current (Classic) UI is associated with words such as cluttered, outdated, and less visually appealing

Given that, we knew we needed to update our user interface, but how did we decide what it would look like? Fundamentally, we started out by implementing the user experience patterns that I’ve spoken about in this blog post. We subsequently undertook several rounds of rigorous internal and external review cycles and updated the New UI based on your feedback. 

That’s all for today. I hope this has convinced you to try the New UI and that you fall in love with it as much as I have! Remember, you can enable the New UI from the Settings cog at the top left of the IDE window. There’s a link in the Settings to share your feedback with us!

image description