Aqua Help

How to move from VS Code to Aqua

In this section, you’ll find some tips on how to migrate from VS Code to Aqua.

Configure shortcuts

If you’ve never used Aqua or other JetBrains IDEs before, getting used to new shortcuts can be challenging. Here are a few tips that can help you with that.

Switch to the VS Code keymap

If you aren’t ready to say goodbye to VS Code shortcuts just yet, you can switch to the VS Code keymap. To do so, go to Settings | Keymap, set VSCode or VSCode (macOS) as your default keymap, and save the changes.

Set the VS Code keymap as default

Learn Aqua shortcuts

Learning Aqua shortcuts will come in handy even if you decide to switch to another JetBrains IDE later on – the shortcuts are the same in almost all of them. Here’s what can help you learn them faster:

  • Memorize Aqua’s most universal shortcut – double Shift or Search Everywhere. You can use it to find any file, action, class, or symbol, and see all the matches in one place.

  • Install Key Promoter X – this extension helps you learn essential shortcuts while working. When you use the mouse on a button inside the IDE, Key Promoter X shows you the shortcut you could have used instead.

Set up your work environment

One of the key differences between Aqua and VS Code is that you don’t need to install a lot of extensions to make Aqua more powerful. Just about everything is already there: language support, VCS, the debugger, support for web frameworks and databases.

For a general overview of the features Aqua offers, check out this page.

Replicate common VS Code workflows

Let’s see how you can set up a few things to work like they do in VS Code.

Opening/creating projects

One of the first things that you’ll notice once you download and install Aqua is that you need a project to get started.

To start with your first project, choose one of these options:

  • Open – Open a project stored on your machine.

  • New Project – Create a project using one of the predefined templates.

  • Get from VCS – Get an existing project from a version control system like Git or GitHub.

Once you’ve opened a project, you can start coding right away.

Welcome screen

Command Palette

Search Everywhere is your replacement for VS Code’s Command Palette. You can use it to find any file, action, class, or symbol, and see all matches in one place. Open it by double-pressing Shift – we usually abbreviate this as the Shift + Shift shortcut.

Customize Aqua: Command Palette

Search and replace

Although Aqua’s search and replace workflow is slightly different from the one in VS Code, the principles are the same. Aqua lets you find and replace text strings within both specific files and entire projects.

To get started, select Edit | Find from the main menu, then choose either Find to search only through the current file or Find in Files to search across the entire project. To replace a text string, select Replace or Replace in Files under the same submenu instead.

Customize Aqua: search and replace

Running code

Just like VS Code, Aqua allows you to run binaries, tests, and benchmarks from the gutter.

Run from the gutter menu

Aqua provides various ways to run your code. Under the hood, all of them rely on run/debug configurations. By creating a custom run/debug configuraion you gain the utmost freedom and flexibility. Learn more in Run/debug configurations.

Change the defaults for the Project view

Aqua has its own Explorer, the Project view, and it works a bit differently. For instance, you need to double-click a file to open it in the editor. To change the default Project view settings, select any or all of the following options:

  • Open Files with Single Click – Open files in the editor with one click.

    The Open Files with Single Click option
  • Always Select Opened File – Auto-select the file that’s currently open in the Project view.

    The Always Select Opened File option
  • Enable Preview Tab – Preview files you have selected in the Project view in the editor.

    The Enable Preview Tab option

How to get support

You can always get in touch with our support team if you get stuck. To submit a new ticket, select Help | Contact Support from Aqua’s main menu. To report a bug or ask for a new feature, create a new issue here.

Last modified: 07 March 2024