Clone wiki

jbehave-bdd-plugin / Home

JBehave BDD Plugin

by Aman King

This is an IntelliJ IDEA 9 plugin that facilitates navigation of JBehave stories and steps.

JBehave is a Java-based framework for writing automated tests in a style known as Behaviour-Driven Development (BDD). At a high level, it involves writing specifications in the form of stories, each story containing multiple steps. These stories and steps, while specified in plain text files, are actually implemented as Java classes and methods.

While JBehave's popularity indicates its effectiveness, navigation support within the IDE will go a long way in streamlining working with the framework. This plugin is an attempt in that direction.

IntelliJ IDEA is an excellent IDE for Java-based development. Its extensibility in the form of plugins is extremely helpful. While IDEA does not come with built-in support for navigating JBehave stories and steps, it is possible after installing this plugin.

Support for

  • JBehave 3.x (and possibly above) : currently supports JBehave 3 default naming conventions only (plain text file ends with .story, and Java class is UpperCamelCase of plain text filename which is snake_case)
  • IntelliJ IDEA 9.x.x and above, both Community Edition and Ultimate Edition (tested on Windows, Linux, and Mac versions)

Available plugin actions

  1. Navigation to-and-fro between JBehave plain text file (.story) and Java story class (.java)
  2. Navigation from JBehave step text in plain text file (.story) to Java step method implementation in a Java steps class

Installation instructions

JBehave BDD Plugin is available via the official IntelliJ IDEA Plugins repository and hence can be installed from within IDEA via its "Plugins" settings (Available tab).


  1. Download the zip file in the dist folder, listed under the Source tab (make sure to use the "raw" link on the file's page)
  2. Shutdown IntelliJ IDEA if running
  3. Unzip the contents of the zip file in the plugins directory of your IntelliJ IDEA installation home directory
  4. Start IntelliJ IDEA
  5. Confirm that "JBehave BDD Plugin" is listed among the installed plugins in IntelliJ IDEA settings

Upcoming features

  • navigation from Java step method to step text in plain text file
  • prompting to create new Java story class when none found for story text file (maybe vice-versa too)
  • prompting to create new Java step method when none found for step text
  • refactoring support for step text and story filenames
  • configuration options to override JBehave 3 default naming conventions


Copyright 2010 Aman King

Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at

Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.