Kickstart is a plugin for Grails in order to start your project with a good looking frontend. It is intended to be used in rapid application scenarios such as a Startup Weekend or a prototyping session with a customer. This plugin provides the following feature:
- Adapted scaffolding templates for standard CRUD pages using the Bootstrap web page template by Twitter.
- Initial set of webpages to describe the website (e.g., about.gsp, contact.gsp, and systeminfo.gsp)
- A language picker that adapts to the available property files in the i18n directory. Using the FamFamFam flag icons.
- A layout (non-/responsive) and less-based skin selector (switches between two different bootstrap versions in less format)
- The skin selector can change the design between the original (bright) Bootstrap and the free (dark) variant called "Cyborg"
- A minimal console logging filter (KickstartFilter.groovy) to help understand which actions are called and params are transmitted
- A script to calculate a simple build number and extract versioning build numbers (in _Events.groovy)
- A script to calculate simple code metrics (lines of code (LOC) and number of files) (in _Events.groovy)
|
|
|
| Kickstart uses Bootstrap to render web pages. Bootstrap is made by Mark Otto (@mdo) and Billy Gates (@fat). Bootstrap is designed to help people of all skill levels as a complete kit or to start something more complex. | Bootstrap is tested and supported in major modern browsers like Chrome 14, Safari 5+, Opera 11, Internet Explorer 7, and Firefox 5. | Bootstrap is based on elements of HTML 5, CSS 3, Javascript 1.8, and jQuery 1.7 with progressively enhanced components to enable a responsive design of the website. Kickstart is built using Groovy 2.0 and Java 7 integrated into the Grails 2.1 framework. |
After installation you must call the kickstart script "grails kickstart", which will copy several files into your project.
grails kickstart
Afterwards create your domain classes (or copy them into the project) and generate controllers and views - they will now use the Bootstrap framework!
The Kickstart script will (after asking you) overwrite a few files in the conf, src, and views directories of your project - you should use it only on fresh new Grails projects.
Affected files and directories (as of version 0.8.0; see script/Kickstart.groovy for current procedure):
- conf/UrlMappings.groovy
- conf/Config.groovy (will only get one line appended)
- src/templates
- /views/_common (contains common GSP entries such as buttons or modals)
- /views/_errors (contains error GSP for 404, 500, etc.)
- /views/_menu (contains menus or submenus)
- /views/home (contains the index.gsp)
- /views/layouts (contains layout files)
- /views/siteinfo (contains separated or static pages such as about.gsp)
- /views/index.gsp will be deleted!
- /views/error.gsp will be deleted!
- Web Layout: Bootstrap 2.1, from Twitter Licensed under the Apache License v2.0. Documentation licensed under CC BY 3.0. (@TwBootstrap , http://twitter.github.com/bootstrap/)
- Datepicker: Datepicker for Bootstrap, Copyright 2012 Stefan Petre, Improvements by Andrew Rowls, Licensed under the Apache License v2.0
- Flag Icons: FamFamFam Flag Icons by Mark James. They are "available for free use for any purpose with no requirement for attribution".
- Kickstart Plugins: Code licensed under the Apache License v2.0. Documentation licensed under CC BY 3.0.
- Copyright 2011 Joerg Rech
- see http://joerg-rech.com and follow @JoergRech
0.8.9 Fixed Bug with CloudFoundry and Tomcat which (now) need references to the plugin containing resources (e.g., images)
0.8.8 Fixed Bug with i18n directory when deploying. Removed domain Object for demo page.
0.8.7 Improved the date binding to use default.date.datepicker.format or default.date.format (removing non-Date items).
0.8.6 Changed solution for Less compilation problem (Switch is now in KickstartResources.groovy only). Fixed problem of SkinA alternative in responsive mode. In production mode only one skin is used.
0.8.5 Fixed a problem with CloudFoundry & Less: running in production will not compile less anymore but switch to files directly.
0.8.3 Introduced a demo page with all fields used by the scaffolding mechanism.
0.8.2 Corrected missing copy of resources.groovy.
0.8.1 Fixed error when copying UrlMappings.groovy, which was not packaged into the plugin.
0.8.0 Integrated less templates of two Bootstrap based designs. Corrected links in language selector and config menus.
0.7.2 Integrated a Bootstrap-based checkbox in the taglib and scaffolding templates.
0.7.1 Corrected datepicker problem with Java representation with month. Corrected missing ID in links to edit-actions.
0.7.0 Updated to Bootstrap 2.1.1 and Grails 2.1. Included FamFamFam icons for flags in language selector. Reorganized file structure for views.
0.6.1 Minor bug fix in _Events.gsp script.
0.6.0 Integration of Bootstrap DatePicker. Uses Grails 2.0 files as base for scaffolding, etc. Cleanup of code and scripts.
0.5.7 Added script to calculate or retrieve build numbers.
0.5.6 Empty commit to test Grails plugin publish mechanism
0.5.5 Minor bugfix (missing import) and correction of KickstartWithBootstrapGrailsPlugin.groovy
0.5.4 Added measurement of time to simple console logging in KickstartFilters
0.5.3 Improvement of error.gsp
0.5.2 Cleanup of code and scripts. Improvement of I18N
0.5.1 Minor bugfixes in Bootstrap and layout files
0.5.0 Initial shared version (February 11, 2012)
0.1.0 Initial version (September 21, 2011)