Welcome to FitNesse, the fully integrated stand-alone acceptance testing framework and wiki.

To get started, check out https://fitnesse.org!

• A One-Minute Description of FitNesse
• Download FitNesse and Plugins
• The FitNesse User Guide

Have a bug or a feature request? Please open a new issue.

Have a question that's not a feature request or bug report? Join the Gitter Community.

The latest stable build of FitNesse can be downloaded here by clicking the latest workflow and clicking the libs artifact.

Note: the libs artifact contains 2 jars. fitnesse.jar is for use in Maven or Ivy. Users who just want to run FitNesse by itself should use fitnesse-standalone.jar instead of fitnesse.jar.

Issues and pull requests are administered at GitHub.

A proper internet connection is sufficient to build FitNesse. The build process will bootstrap itself by downloading Gradle and from there will download the dependencies required to build and test FitNesse.

To build and run all tests, run the command

$ ./gradlew

which builds the all target.

NB. On windows call gradlew.bat instead of ./gradlew.

To start the FitNesse wiki locally, for example to browse the local version of the User Guide

$ ./gradlew run

To run the unit tests:

$ ./gradlew test

To run the acceptance tests:

$ ./gradlew acceptanceTest

Direct any questions to the Gitter Community..

There are a few things to keep in mind when working from an IDE:

1. The Gradle build does some extra things apart from compiling the code.

   • It sets the FitNesse version in a META-INF/FitNesseVersion.txt
   • It copies the dependencies to the lib folder so they can be used by the acceptance tests.

   Perform a

   $ ./gradlew copyRuntimeLibs
   

   to execute the copy action. In your IDE it is possible to define "post-compilation" steps. If you set the "post-compile" target from the build file, you won't have any trouble with cleaning, building and executing tests from your IDE.

1. Clone the FitNesse Git repository from https://github.com/unclebob/fitnesse.
2. Import FitNesse via File -> Import... -> Gradle Project.
3. Select the just cloned project folder. Follow the wizard.
4. Ensure the project properties have a Java 8 compiler or newer set.

1. Clone the FitNesse Git repository from https://github.com/unclebob/fitnesse.
2. From the welcome screen (the one you get when all projects are closed), click Import Project.
3. Select the file build.gradle in the fitnesse folder.
4. Follow the wizard. Deselect the option Create separate module per source set. You can use the Use gradle wrapper task configuration. Use Java 8 or newer. It should find source and test folders and show you two modules: fitnesse and :buildSrc; import both.
5. Open the Gradle Build tool, select the task copyRuntimeLibs and (right-click) mark it as Execute After Make.

FitNesse releases are deployed to Maven Central via OSS Sonatype.

Sufficient permissions are required to perform a release.

Release builds denote "blessed" releases. Those are tagged in Git along with being released. The releases will be available from Maven Central.

$ ./gradlew release

For this to work you'll need to add some properties to your ~/.gradle/gradle.properties

sonatypeUsername=...
sonatypePassword=...

signing.keyId=...
signing.password=...
signing.secretKeyRingFile=...

Details on what values to provide can be found on Deploy to Maven Central using API key and the documentation of the Signing Plugin.