[feature] allow substitution paths to be set
[refactor] cleanup code and add scaladoc
[bugfix] dont forget to show the validator button