Cucumber for the JVM (successor of Cuke4Duke)

Cucumber-JVM is a pure Java implementation of Cucumber that supports the following programming languages:

  • Clojure
  • Groovy
  • Ioke
  • Java
  • JavaScript (Rhino)
  • Scala

Cucumber-JVM provides the following mechanisms for running Cucumber Features:

  • Ant
  • Command Line
  • JUnit (from an IDE)
  • Maven

Cucumber-JVM also integrates with the following Dependency Injection containers:

  • Guice
  • PicoContainer
  • Spring
  • CDI/Weld

Downloading / Installation

There are no downloadable releases yet. See the Hacking section for installation instructions. Downloadable releases will be made available when the time is right.


You will find an example under examples/java-calculator. You should be able to run basic_arithmetic.feature by running the JUnit test from your IDE. -Or simply by running it with Maven: mvn clean install -P examples once to build it all. Then cd examples/java-calculator followed by mvn test each time you make a change. Try to make the feature fail!


To hack on Cucumber-JVM you need a JDK, Maven and Git to get the code. You also need to set your IDE/text editor to use:

  • UTF-8 file encoding
  • LF (UNIX) line endings
  • 4 Space indent

If we get a pull request where an entire file is changed because of insignificant whitespace changes we cannot see what you have changed.

Building Cucumber-JVM

You’ll need Maven to build the Java code (we’re happily accepting patches for other build systems). To build and run tests, run:

mvn clean install

Running cross-platform Cucumber features

All Cucumber implementations (cucumber-ruby, cucumber-jvm, cucumber-js) share a common set of Cucumber features to ensure all implementations support the same basic features. To run these you need to clone the cucumber-features into your cucumber-jcm working copy:

git submodule update --init

Now you can run the cross-platform Cucumber features:

gem install bundler
bundle install

Code generation

StepDefinition APIs in all of Gherkin’s supported i18n languages are generated using Ruby. The i18n Java annotations (except English) are not added to the Git repo because Git on both OS X and Windows handles UTF-8 file names badly. In order to compile cucumber-java with all I18n annotations, you have to generate them yourelf. With Ruby installed and on your path, install some gems that are needed for code generation:

Using bundler

Try this first

gem install bundler
bundle install

Now you can generate the code:

rake generate

Without bundler

On Windows it might be tricky to install all the gems. (The listed gems are used for both code generation and for running the cross-platform features). If you only want to generate code, you can get away with:

gem install gherkin
rake generate SKIP_BUNDLER=true


Below are some common problems you might encounter while hacking on Cucumber-JVM - and solutions.

IntelliJ Idea fails to compile the generated I18n Java annotations

This can be solved by changing the Compiler settings: Preferences -> Compiler -> Java Compiler:

  • Use compiler: Javac in-process (Java6+ only)
  • Additional command line parameters: -target 1.6 -source 1.6 -encoding UTF-8

Contributing fixes

Fork the repository on Github, clone it and send a pull request when you have fixed something. Please commit each feature/bugfix on a separate branch as this makes it easier for us to decide what to merge and what not to merge.

Related Repositories



Cucumber for the JVM ...



Cucumber-jvm examples with Maven ...



Demonstrates how you can use Spring-MVC-Test-HTMLUnit with Cucumber-JVM ...



Contains the example code for my cucumber JVM post series ...



An example project for using Geb with cucumber-jvm ...

Top Contributors

aslakhellesoy torbjornvatn cedric-lamalle oc teigen ovstetun darrinholst aaronwalker olabini jesperronn rapaul senny bmabey conradthukral henningjensen tivold switzerland nealeu ckoenig hugojosefson mjul antifun gaffo nilswloka richardlawrence stuarthalloway tychobrailleur dhomann