Skip to content
The Grails Web Application Framework
Java Groovy CSS HTML Shell PostScript
Find file
Pull request Compare This branch is 246 commits behind grails:master.
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Failed to load latest commit information.
buildSrc/src/main/groovy
gradle
grails-async
grails-bom
grails-bootstrap
grails-codecs
grails-compat
grails-console
grails-core
grails-databinding
grails-dependencies
grails-docs
grails-encoder
grails-gradle-model
grails-gradle-plugin
grails-gsp
grails-logging
grails-plugin-async
grails-plugin-codecs
grails-plugin-controllers
grails-plugin-converters
grails-plugin-databinding
grails-plugin-datasource
grails-plugin-domain-class
grails-plugin-events
grails-plugin-filters
grails-plugin-gsp
grails-plugin-i18n
grails-plugin-interceptors
grails-plugin-mimetypes
grails-plugin-rest
grails-plugin-services
grails-plugin-testing
grails-plugin-url-mappings
grails-plugin-validation
grails-shell
grails-spring
grails-taglib
grails-test-suite-base
grails-test-suite-persistence
grails-test-suite-uber
grails-test-suite-web
grails-test
grails-validation
grails-web-boot
grails-web-common
grails-web-databinding
grails-web-fileupload
grails-web-gsp-taglib
grails-web-gsp
grails-web-jsp
grails-web-mvc
grails-web-sitemesh
grails-web-taglib
grails-web-url-mappings
grails-web
media
travis
.gitignore
.springBeans
.travis.yml
INSTALL
LICENSE
NOTICE
README.md
build.gradle
gradle.properties
gradlew
gradlew.bat
pubring.gpg.enc
secring.gpg.enc
settings.gradle
settings.xml.enc
travis-after-failure.sh
travis-build.sh
trigger-dependent-build.sh

README.md

Waffle.IO Board

  • Stories in Acknowledged
  • Stories in Progress

Build Status

  • Build Status

Slack Signup

  • Slack Signup

Grails

Grails is a framework used to build web applications with the Groovy programming language. The core framework is very extensible and there are numerous plugins available that provide easy integration of add-on features.

Grails is sponsored by Object Computing Inc. in St. Louis Missouri. Please contact info@ociweb.com for support inquiries.

Getting Started

You need a Java Development Kit (JDK) installed, but it is not necessary to install Groovy because it's bundled with the Grails distribution.

To install Grails, visit http://grails.org/Download and download the version you would like to use. Set a GRAILS_HOME environment variable to point to the root of the extracted download and add GRAILS_HOME/bin to your executable PATH. Then in a shell, type the following:

grails create-app sampleapp
cd sampleapp
grails run-app

To build Grails, clone this GitHub repository and execute the install Gradle target:

git clone https://github.com/grails/grails-core.git
cd grails-core
./gradlew install

If you encounter out of memory errors when trying to run the install target, try adjusting Gradle build settings. For example:

export GRADLE_OPTS="-Xmx2G -Xms2G -XX:NewSize=512m -XX:MaxNewSize=512m -XX:MaxPermSize=1G"

Performing a Release

Releases of Grails are automated by Travis CI.

To create a release perform the following steps.

First check that the tests are passing and all is well on Travis.

Next, update the Grails version in build.gradle and grails-core/src/test/groovy/grails/util/GrailsUtilTests.java and then push the changes to git:

$ git add build.gradle grails-core/src/test/groovy/grails/util/GrailsUtilTests.java
$ git commit -m "Release Grails 3.0.1"
$ git tag v3.0.1
$ git push --tags
$ git push

By tagging the release Travis will perform all the necessary steps to release a new version of Grails, just wait for the build to complete.

The Travis CI build will automatically upload the tagged release to Github and be available on the Releases page.

License

Grails and Groovy are licensed under the terms of the Apache License, Version 2.0.


YourKit is kindly supporting Grails open source projects with its full-featured Java Profiler. YourKit, LLC is the creator of innovative and intelligent tools for profiling Java and .NET applications. Take a look at YourKit's leading software products: YourKit Java Profiler and YourKit .NET Profiler.

Something went wrong with that request. Please try again.