Aqua Help

Create a new project

New project without frameworks

This is a general-purpose project without specific frameworks. You will be able to add the necessary frameworks and technologies later at any time.

  1. Launch Aqua.

    If the Welcome screen opens, click New Project. Otherwise, go to File | New | Project in the main menu.

  2. From the list on the left, select the language that you want to use in your application.

    If you want to use a language that is not available in Aqua out of the box (for example, Python or PHP), click More via plugins and select the necessary option.

    The IDE will open a dialog in which you can select and install the necessary language plugin. After that, you can close the dialog and keep configuring the new project.

    Creating a new project
  3. Name the new project and change its location if necessary.

  4. Select the Create Git repository checkbox to place the new project under version control.

    You will be able to do it later at any time.

  5. Select the build system that you want to use in your project: the native IntelliJ builder, Maven, or Gradle.

    For Gradle, you will also need to select a language for the build script: Groovy or Kotlin.

  6. From the JDK list, select the JDK that you want to use in your project.

    If the JDK is installed on your computer, but not defined in the IDE, select Add JDK and specify the path to the JDK home directory.

    If you don't have the necessary JDK on your computer, select Download JDK.

  7. Enable the Add sample code option to create a class with a sample HelloWorld application.

    Select the Generate code with onboarding tips option to create a basic sandbox project with tips demonstrating some of the IDE’s essential features.

New empty project

This is a basic project that allows you to work with different languages, Java or Kotlin classes without a predefined SDK, which could be useful for adhoc developing, creating mockups, and testing.

  1. Launch Aqua.

    Do one of the following:

    • Click New Project on the Welcome screen.

    • Select File | New | Project from the main menu.

    • (Available in the new UI) Click the Project widget in the main window header and select New Project.

  2. From the list on the left, select Empty Project.

  3. Name the new project and change its location if necessary.

  4. Select the Create Git repository to place the new project under version control.

    You will be able to do it later at any time.

  5. Click Create.

New framework-based project

These are framework-based projects. Select one of the provided project types to create a project from a pre-defined template.

Maven Archetype

If you are creating a project using a Maven archetype, Aqua displays the Maven settings that you can use to set the Maven home directory and Maven repositories. Also, you can check the archetype properties.

Name

Specify a name for your project.

Location

Specify the path to the directory in which you want to create the project. By default, the IDE creates a directory with the same name as the project.

Create Git repository

Place the new project under version control.

You will be able to do it later at any time.

JDK

From the JDK list, select the JDK that you want to use in your project.

If the JDK is installed on your computer, but not defined in the IDE, select Add JDK and specify the path to the JDK home directory.

If you don't have the necessary JDK on your computer, select Download JDK.

Catalog

Specify which Maven repository you want to use in your project.

The internal Maven catalog is a default one. You can also select the local repository that is located in the .m2 directory, or you can select Maven central repository.

Moreover, you can click Manage Catalogs and add a custom repository if you need.

Archetype

Select the needed Maven archetype. Click Add to specify the custom archetype.

Version

The version is specified automatically.

Additional Properties

In this area, you can specify additional properties on top of the built-in ones

Advanced Settings

Specify the following Maven coordinates that are added to the pom.xml file:

  • GroupId: a package of a new project.

  • ArtifactId: a name of your project.

For more information about Maven coordinates, refer to Maven naming conventions.

HTML

Name

Specify a name for your project.

Location

Specify the path to the directory in which you want to create the project. By default, the IDE creates a directory with the same name as the project.

Project type

Select the framework that you want to use in your application.

Version

Specify the version of the template in accordance to which the stub will be generated. Click the Refresh button to refresh the list of available template versions.

React

Name

Specify a name for your project.

Location

Specify the path to the directory in which you want to create the project. By default, the IDE creates a directory with the same name as the project.

Project type

Select the framework that you want to use in your application.

Node interpreter:

Specify the Node.js interpreter that you want to use in this project. You can select a configured interpreter from the list or click Add to configure a new one.

If you have no Node.js on your computer, select Download Node.js from the list.

create-react-app

Select npx create-react-app.

Alternatively, for npm version 5.1 and earlier, install the create-react-app package yourself by running npm install --g create-react-app in the Terminal Alt+F12. When creating an application, select the folder where the create-react-app package is stored.

AngularCLI

Name

Specify a name for your project.

Location

Specify the path to the directory in which you want to create the project. By default, the IDE creates a directory with the same name as the project.

Node interpreter

Specify the Node.js interpreter that you want to use in this project. You can select a configured interpreter from the list or click Add to configure a new one.

If you have no Node.js on your computer, select Download Node.js from the list.

Angular CLI

Select npx --package @angular/cli ng.

Alternatively, for npm version 5.1 and earlier, install the @angular/cli package yourself by running npm install -g @angular/cli in the Terminal Alt+F12. When creating an application, select the folder where the @angular/cli package is stored.

Additional parameters

(Optional) Specify the extra ng new options to pass to Angular CLI.

Code completion is available in this field: as you start typing the name of an option or press Ctrl+Space, Aqua shows you the available options and their description.

Vue.js

Name

Specify a name for your project.

Location

Specify the path to the directory in which you want to create the project. By default, the IDE creates a directory with the same name as the project.

Node interpreter

Specify the Node.js interpreter that you want to use in this project. You can select a configured interpreter from the list or click Add to configure a new one.

If you have no Node.js on your computer, select Download Node.js from the list.

Vue CLI

From the Vue CLI list, select npx --package @vue/cli vue.

Alternatively, for npm version 5.1 and earlier, install the @vue/cli package yourself by running npm install --g @vue/cli in the Terminal Alt+F12. When creating an application, select the folder where the @vue/cli package is stored.

Use the default project setup (babel, elint)

To bootstrap your application with babel and ESLint, select the Use the default project setup checkbox.

Vite

Name

Specify a name for your project.

Location

Specify the path to the directory in which you want to create the project. By default, the IDE creates a directory with the same name as the project.

Node interpreter

Specify the Node.js interpreter that you want to use in this project. You can select a configured interpreter from the list or click Add to configure a new one.

If you have no Node.js on your computer, select Download Node.js from the list.

Vite

From the Vite list, select npx create-vite.

Alternatively, for npm version 5.1 and earlier, install the create-vite package yourself by running npm install --g create-vite in the Terminal Alt+F12. When creating an application, select the folder where the create-vite package is stored.

Template

Select the community maintained Vite template that targets the framework you are going to use in your application.

Last modified: 08 April 2024