Welcome to your first GeoTools project! We are going to set up a project using GeoTools to quickly display a shapefile on screen.

This tutorial is available for:

If you are interested in porting this tutorial to an additional IDE please contact us on the users list.

Notes and Errata

  • If you’re running under OS X you may run into an issue where the file chooser dialog never appears and the application hangs. This is a known issue with the native OS X Swing look and feel. As a workaround you can use the cross platform look and feel; either use the following static block in your files:

    static {
      // Set System L&F
      try {
      } catch (Exception e) {

    or run your applications with the following VM argument -Dswing.defaultlaf=javax.swing.plaf.metal.MetalLookAndFeel

  • At the time of writing the CRSLab application may fail if you try to change the projection a second time. There is no workaround or fix for this at the time.