The Angular-Ratpack generator

A Yeoman generator for AngularJS and Ratpack.

Ratpack is a Groovy-based micro-framework. For AngularJS integration with other micro-frameworks, see https://github.com/rayokota/MicroFrameworkRosettaStone.

Installation

Install Git, node.js, JDK 8, and Groovy.

Install Yeoman:

npm install -g yo

Install the Angular-Ratpack generator:

npm install -g generator-angular-ratpack

The above prerequisites can be installed to a VM using the Angular-Ratpack provisioner.

Creating a Ratpack service

In a new directory, generate the service:

yo angular-ratpack

Run the service:

./gradlew run

Your service will run at http://localhost:8080.

Creating a persistent entity

Generate the entity:

yo angular-ratpack:entity [myentity]

You will be asked to specify attributes for the entity, where each attribute has the following:

• a name
• a type (String, Integer, Long, Float, Double, Boolean, Date, Enum)
• for a String attribute, an optional minimum and maximum length
• for a numeric attribute, an optional minimum and maximum value
• for a Date attribute, an optional constraint to either past values or future values
• for an Enum attribute, a list of enumerated values
• whether the attribute is required

Run the service:

./gradlew run

A client-side AngularJS application will now be available by running

grunt server

The Grunt server will run at http://localhost:9000. It will proxy REST requests to the Ratpack service running at http://localhost:8080.

At this point you should be able to navigate to a page to manage your persistent entities.

The Grunt server supports hot reloading of client-side HTML/CSS/Javascript file changes.