Neonatal Penguin March


    0.1.5 • Public • Published

    The Angular-Spin generator

    A Yeoman generator for AngularJS and Spin.

    Spin is a Racket-based micro-framework. For AngularJS integration with other micro-frameworks, see


    Install Git, node.js, and Racket. The development mode also requires SQLite.

    Install Yeoman:

    npm install -g yo

    Install the Angular-Spin generator:

    npm install -g generator-angular-spin

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

    Creating a Spin service

    In a new directory, generate the service:

    yo angular-spin

    Install dependencies:

    raco pkg install racquel

    Run the service:

    racket app.rkt

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

    Creating a persistent entity

    Generate the entity:

    yo angular-spin:entity [myentity]

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

    • a name
    • a type (String, Integer, Float, 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

    Files that are regenerated will appear as conflicts. Allow the generator to overwrite these files as long as no custom changes have been made.

    Run the service:

    racket app.rkt

    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 Spin 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.


    npm i generator-angular-spin

    DownloadsWeekly Downloads






    Last publish


    • rayokota