Plugins You can find out about all the publicly available Grails plugins.

Grails Runtime Docs

3 votes
compile ":grails-runtime-docs:1.0.0"

 Documentation  Source  Issues


Grails Runtime Docs is a Grails Documentation Tool that generates API documentation of the project from runtime including the dynamic methods and properties.


Declare a dependency on the plugin in your grails-app/conf/BuildConfig.groovy file:

compile ":grails-runtime-docs:1.0.0"


The Runtime Docs plugin generates both Java and Groovy documentation for your Grails Project. The groovy documentation is generated from runtime which facilitates to capture the dynamic methods and properties added to the grails artifacts from various sources. The HTML docs follows Java 7 API documentation template and adds "Dynamic Method Summary & Dynamic Method Detail" providing the source information of the dynamic methods.

The plugin also helps to easily navigate through the grails artifacts by further categorizing the classes into Commands, Configs, Controllers, Domains, Services and Tag Libraries.


Generate the documentation for your Grails Project by simply executing the following command:

grails runtime-docs

Java and Groovy documentation is then generated in target/docs directory of your project.

Java Documentation Scope

The default scope set for Java documentation is Protected, which means documentation will be generated for all public/protected classes.

Note: To change the default scope, modify the 'access' property in 'RuntimeDocs.groovy' under 'javadoc' target to one of these available modes : public, protected, package, or private.

Groovy Documentation Scope

The default properties for Groovy documentation allows the plug-in to generate documentation for all classes including package/private classes.

Note: To enable/disable generation of documentation for a particular scope, set the values for the available publicScope, protectedScope, packageScope, and privateScope to true or false in 'RuntimeDocs.groovy' under 'groovydoc' target.