Skip to content

Getting started with Jeka

Install Intellij Plugin

  • Install plugin directly from here or search jeka in Intellij Marketplace.

As this plugin embeds its own version of Jeka, that's all we need to install on our machine.

Hello World !

The below example showcases how to write tasks executable both from IDE and the command line.

  • Create a new Jeka project in Intellij : New > Project ... > Jeka


Leave default (we might change the name) and press Create.


A Jeka structure (folders and files) can be created in an existing project of any type. On IntelliJ project window-tool : Select project > Click Left > Jeka ... > Scaffold ...


We get a workable Jeka project from which we can :

  • execute/debug methods from the IDE using editor gutter buttons or tool-windows explorer.
  • navigate to discover available KBeans on this project, and their content.
  • create Intellij run-configuration from existing methods
  • execute methods directly in the terminal (e.g. ./jekaw #hello #name=Joe)
  • create new methods/fields. If they do not appear in the tool-window, use the top menu button to refresh view.

Import 3rd Party libraries

We can also import 3rd-party libraries to use in our build classes by using the @JkInjectClasspathannotation.

Libraries referenced with coordinates will come into classpath along with all their dependencies.


Do not forget to refresh iml explicitly when the Jeka classpath has been changed.


Use Ctrl+space when editing @JkInjectClasspath to get dependency auto-completion.


Build a Java Project

  • Create a new Jeka project in Intellij : New > Project ... > Jeka

  • Select java project template and click Create


Now we have a workable Java project. We can :

  • Add dependencies using project.flatFacade().configureXxxDependencies() in Build class.
  • Add dependencies by editing project-dependencies.txt file
  • Customize project instance in order to fits your need.

After modifying your dependencies, do not forget to refresh Intellij by Right Click > Jeka Synchronise Iml File

Our project is ready to code. Invoke cleanPack to generate binary, sources, and javadoc jar files.


Navigate to the right-side Jeka Tool Window > Classpath KBeans > project to see all available methods.

Right-click on a method to run/debug it from IDE. It is possible to combine several methods using Run... or Debug...

For most standard projects, we may not need a build code, only a simple properties file. To scaffold such a project :

  • Create a new Jeka project in Intellij : New > Project ... > Jeka

  • Select java project - code.less template and click Create

We get :


Execute ./jekaw :build_quality to create a full build and perform Sonarqube analysis + code coverage.

Properties and code can be used in conjunction, a tough build class may override values defined in

We will find many project examples here

Learn more about Java project builds

Learn more about dependency management

Build a Springboot Project

  • Create a new Jeka project in Intellij : New > Project ... > Jeka

  • Select springboot project template and click Create


We now have a project ready to code, and already containing a workable RestController and its test counterpart.

Execute ./jekaw project#pack to generate the bootable jar.

Execute ./jekaw project#runJar to run the bootable.jar


As for java project, Springboot projects can be scaffolded with code.less flavor.

Visit JeKa sample projects to have concrete implementation examples.