generator-spring-gae-react

generator-spring-gae-react

Yeoman generator for a React app that runs atop Spring on Google App Engine

Release history

See the Change Log.

Installation

First, install Yeoman and generator-spring-gae-react using npm (we assume you have pre-installed node.js).

npm install -g yo
npm install -g generator-spring-gae-react

Then generate your new project:

yo spring-gae-react

Development

It's always best to work on a generated project when updating. Each time you generate, do the following.

In this project directory

npm link

Then run this each time to generate a project Note that this cleans your working directory, creates a new one, generates project and creates a local commit. The last part is important to help easily track your changes - you can compare your local filesystem to the last commit and then know what updates you did.

Change the working dir to suit your environment.

WORKING_DIR=~/dev/3wks; cd $WORKING_DIR && rm -rf $WORKING_DIR/tmp/test-spring && mkdir $WORKING_DIR/tmp/test-spring && cd $WORKING_DIR/tmp/test-spring && yo spring-gae-react && git init && git add . && git commit -m "initial commit"

Publishing

npm version patch
npm publish
git push

To Do

Client

• LESS
• Autoprefixer
• Minification
• Hot Module Reloading
• Add README doc to generated project
• Generate favicon set
• Split vendor and application bundles and use chunkhash
• Compress images
• Error handling + reporting

Server

• Sample API endpoint
• Sample frontend tests
• Basic login and user management
• Static ref data support

Getting To Know Yeoman

• Yeoman has a heart of gold.
• Yeoman is a person with feelings and opinions, but is very easy to work with.
• Yeoman can be too opinionated at times but is easily convinced not to be.
• Feel free to learn more about Yeoman.

License

MIT © 3wks