Get started with Kotlin
Before you start working with Kotlin, make sure that the plugin is enabled. The plugin is bundled with IntelliJ IDEA and is activated by default. If the plugin is not activated, enable it on the Plugins page of the IDE settings CtrlAlt0S as described in Install plugins.
IntelliJ IDEA provides first-class support for Kotlin. It includes Kotlin-specific project templates, coding assistance, refactorings, debugging, analysis tools, and so on. Most of the Java tools are available for Kotlin, so, for example, if you know how to use Java debugger or refactorings, your experience will be enough to use these in Kotlin. In this topic, you will find the instructions to get started with Kotlin in IntelliJ IDEA.
note
This page covers Kotlin support in IntelliJ IDEA. For the language itself, refer to Kotlin documentation.
This is a general-purpose project without specific frameworks. You will be able to add the necessary frameworks and technologies later at any time.
On the Welcome screen, click New Project. Otherwise, from the main menu, select File | New | Project.
From the list on the left, select New Project.
Name the new project and change its location if necessary.
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.
From the Language list, select Kotlin.
Select the IntelliJ build system. It's a native builder that doesn't require downloading additional artifacts.
If you want to create a more complex project that needs further configuration, select Maven or Gradle. For Gradle, choose a language for the build script: Groovy or Kotlin.
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.
Enable the Add sample code option to create a file with a sample
Hello World!
application.Click Create.
On the Welcome screen, click New Project. Otherwise, from the main menu, select File | New | Project.
In the left-hand menu, select Kotlin Multiplatform.
Select the project template. The template defines the project structure and dependencies. The following project templates are available:
JVM
Console Application: console application with Kotlin/JVM. Use it for prototyping or testing purposes.
tip
For such applications, you can also create projects without frameworks.
Multiplatform
Full-Stack Web Application: full-functional web application using Kotlin/JS for the frontend and Kotlin/JVM for the backend.
Library: library for sharing common code among different platforms.
Native Application: application with Kotlin/Native that works as a standalone application under a specific platform.
Kotlin/JS
Browser Application: frontend application with Kotlin/JS and non-Kotlin backend for browser. If you use Kotlin for backend, the better option is Full-Stack Web Application.
React Application: frontend application with Kotlin/JS and React UI framework for browser.
Node.JS Application: a standalone application with Kotlin/JS for the Node.js runtime.
Select the build system that you are going to use in the project.
note
Some project templates only support specific build systems.
Specify the JDK that will be used in the project (version 1.8 or later is recommended). The JDK:
is essential for projects built with IntelliJ IDEA build system.
used for coding assistance in projects built with Gradle and Maven
If you don't have a JDK installed, you can download it right in the dialog.
Specify coordinates of the primary artifact: Group ID, Artifact ID, and Version. Not applicable for IntelliJ build system.
Click Next to proceed to configuring the module structure. For detailed information, see New Project Wizard.
You can call Java code from Kotlin and vice versa. This enables you to gradually transition a project to Kotlin or use both languages in parallel, for example, by using Kotlin for testing an existing Java codebase.
note
The peculiarities of Kotlin/Java interop at the language level are not covered in this topic. For detailed information, refer to Calling Java from Kotlin and Calling Kotlin from Java in the Kotlin language documentation.
In order to start using Kotlin in your project, make sure that the Kotlin plugin is enabled and the Kotlin dependency is added to your project.
IntelliJ IDEA allows you to automatically convert your Java code to Kotlin. The resulting code is not supposed to be perfect, however, it may be helpful in some situations.
If you are not satisfied with the result of conversion, you can roll it back with Ctrl0Z.
Paste Java code in a Kotlin file. In the dialog that appears, click Yes.
With a Java file open in the editor, go to main menu and select Code | Convert Java File to Kotlin File or press CtrlAltShift0K.