A library for creating swing based step-by-step wizards with Java 7+
Branch: master
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Type Name Latest commit message Commit time
Failed to load latest commit information.
.gitignore NOJIRA version bump, resolves slf error message when runnin the demos Jan 24, 2019


License Build Status

CJWizard is a library for creating swing based wizard dialogs in Java.

This library was spurred by my use of the Java Wizard library at Java.net (which appears to be gone now; it was previously at https://wizard.dev.java.net/). That library offers a good framework for simple wizards, but it dictates a great deal of what you can do--justified by the java usability guidelines. However, I don't believe all the restrictions actually are justified by those guidelines. For example, it is particularly difficult to change the type of widget used on the left side of the wizards (it is initially an image with the list of wizard pages displayed over top of it). Making this area interactive, as a global navigation tool, is non-trivial.

I also found it to be extremely cumbersome to define complex wizards that change their branching behavior at runtime. Generally, I found the Java Wizard API to be difficult to use and at times contradictory.

That said, I learned a lot from the Java Wizard API, and some of those ideas have been incorporated into CJWizards (I had to call it something.)

Take a look at the FAQ and QuickStartGuide to get going, and send me questions if you have any.


This shows CJWizard in action, with a custom PageTemplate (drawing the list of dialog pages on the left) that wraps around a !TitledPageTemplate (drawing the underlined title of the !WizardPage). The Windows L&F was used to make it look like a native app. (The Finish button is enabled because the surrounding app is robust to missing data, and allows for the user to come back to the wizard at a later date, if needed. Generally, and by default, the Finish button is disabled if it is not explicitly enabled, which often happens in the render() method of the last !WizardPage)

sample dialog

Maven coordinates / JCenter

CJWizard is hosted on JCenter: https://bintray.com/cjwizard/CJWizard/cjwizard

The dependency section for your pom.xml is:


For gradle and ivy users: See "build settings" in https://bintray.com/cjwizard/CJWizard/cjwizard


See docs folder


To use this library you need

  • Java 7 or later


This library depends on

  • slf4j-api