npm package discovery and stats viewer.

Discover Tips

  • General search

    [free text search, go nuts!]

  • Package details

    pkg:[package-name]

  • User packages

    @[username]

Sponsor

Optimize Toolset

I’ve always been into building performant and accessible sites, but lately I’ve been taking it extremely seriously. So much so that I’ve been building a tool to help me optimize and monitor the sites that I build to make sure that I’m making an attempt to offer the best experience to those who visit them. If you’re into performant, accessible and SEO friendly sites, you might like it too! You can check it out at Optimize Toolset.

About

Hi, 👋, I’m Ryan Hefner  and I built this site for me, and you! The goal of this site was to provide an easy way for me to check the stats on my npm packages, both for prioritizing issues and updates, and to give me a little kick in the pants to keep up on stuff.

As I was building it, I realized that I was actually using the tool to build the tool, and figured I might as well put this out there and hopefully others will find it to be a fast and useful way to search and browse npm packages as I have.

If you’re interested in other things I’m working on, follow me on Twitter or check out the open source projects I’ve been publishing on GitHub.

I am also working on a Twitter bot for this site to tweet the most popular, newest, random packages from npm. Please follow that account now and it will start sending out packages soon–ish.

Open Software & Tools

This site wouldn’t be possible without the immense generosity and tireless efforts from the people who make contributions to the world and share their work via open source initiatives. Thank you 🙏

© 2024 – Pkg Stats / Ryan Hefner

generator-thundr-gae

v5.0.3

Published

Yeoman generator for thundr-gae - Creates a Java Google Appengine on the thundr framework - http://3wks.github.io/thundr/

Downloads

22

Readme

generator-thundr-gae Build Status

thundr Logo

This Yeoman generator will create application scaffolding for a thundr/AngularJS application ready for Google AppEngine which is setup up to use Maven, Grunt and Bower.

This is the java hipster's toolchain of choice for modern web apps.

Once you're done, you will be able to:

Build all your source and assets with maven:

mvn package

Deploy to appengine

mvn appengine:update -PenvironmentName

Have live changes to your css, javascript, less, fonts, images watch and processed in realtime

grunt while running your app.

Run the appengine locally
mvn appengine:devserver
Debug in Eclipse using the GPE and grunt watch

Create a run-config in Eclipse using the GPE for a standard maven webapp on port 8080. Run grunt on the command line using grunt

Debug in IntelliJ using the Google Plugin and grunt watch

Create a run config in IntelliJ on port 8081 Run grunt on the command line or IntelliJ's grunt integration grunt. This circumvents issues with IntelliJ not sycning file changes properly without frame deactivation followed by reactivation.

Required dependencies

This toolchain requires:

  • Java in JDK fashion
  • Maven
  • Node
  • Bower (installed globally using npm - npm install -g bower)
  • Grunt (installed globally using npm - npm install -g grunt)
  • This generator installed (npm install -g generator-thundr-gae)
  • ImageMagick installed (as per grunt-favicons)

Then just run the generator in your desired project directory and answer the questions: mkdir my-project; cd my-project; yo thundr-gae

What does it do:

Projects generated have a tip-top build pipeline

Java Dependencies

  • manages maven dependencies based on your pom.xml
  • Includes your java source in an output war - /src/main/java/
  • Includes your application resources - /src/main/resources/
  • Includes your application web assets - /src/main/webapp/
  • Runs unit tests with surefire, all classes ending in *Test.java in /src/test/java/
  • Runs integration tests with failsafe, all classes ending in *IT.java in /src/int-test/java/
  • Creates a standard thundr-gae application layout, including ApplicationModule, Routes, a placeholder controller and matching jsp and a reusable layout.tag

Bower Dependencies

  • manages bower dependencies based on bower.json
  • copies bower dependencies to output war to /src/main/webapp/static/lib/
  • automatically injects bower resources (js, css) into your page template(s) (layout.tag by default)
  • watches for changes automatically updating your war on the fly during debug
  • Creates a standard angularjs application rooted in app.js, using ui-router, ui-bootstrap, angular-moment and bootstrap and font-awesome.

Manages application CSS

  • Copies CSS to your output war from /src/main/static/css/
  • Generates CSS from less in /src/main/static/less/styles/
  • automatically injects application css into your page template(s) (layout.tag by default)
  • watches for changes automatically updating your war on the fly during debug

Manages application JS

  • Minifies and concatenates javascript to your output war from /src/main/static/javascript
  • automatically puts angular dependencies into AMD style array, e.g. you can write a controller as function($scope, $stateParams...){} and it will be converted to ['$scope', '$stateParams', ... function($scope, $stateParams...){}]
  • runs jshint on application javascript
  • automatically injects application js into your page template(s) (layout.tag by default)
  • watches for changes automatically updating your war on the fly during debug

Manages application images

  • Generates your favicon and apple/android/microsoft variants off a single png image /src/main/static/images/favicon/original.png

  • automatically injects favicons and variants into your page template(s) (layout.tag by default)

  • Copies images to output war from /src/main/static/images

Project layout

The resulting project will be a standard maven project, with the addition of extra source folders.

  • src/main/java contains all your application code

  • src/main/java/ApplicationModule.java your thundr application module

  • src/main/java/controllers/Routes.java your thundr application routes

  • src/main/webapp/ your standard maven webapp folder

  • src/test/java/ java unit tests

  • src/int-test/java/ java integration tests

  • src/main/static contains all your web assets. The grunt build will copy/process these to src/main/webapp/static when you run.

  • src/test/static contains tests for your web assets.

  • src/main/static/css contains any css files that you want output, these are injected into layout.tag for you

  • src/main/static/font contains your font files (css, eot, svg, ttf, woff etc)

  • src/main/static/images contains image files

  • src/main/static/images/favicon contains 'original.png' - this will be generated into favicon and applicaiton icons automatically

  • src/main/static/javascript contains application javascript, they'll be minified, concatenated and injected into layout.tag for you. Any angular code that uses dependency injection will be processed so that injections works after minification

  • src/main/static/less/styles contains any less files that should result in an output css file, injected into layout.tag for you

  • src/main/static/less/mixins contains less mixins used by the less files in styles, but shouldn't result in css themselves

  • src/main/static/templates contains partials, templates and html files

What is Yeoman?

Trick question. It's not a thing. It's this guy:

Basically, he wears a top hat, lives in your computer, and waits for you to tell him what kind of application you wish to create.

Not every new computer comes with a Yeoman pre-installed. He lives in the npm package repository. You only have to ask for him once, then he packs up and moves into your hard drive. Make sure you clean up, he likes new and shiny things.

$ npm install -g yo

Yeoman Generators

Yeoman travels light. He didn't pack any generators when he moved in. You can think of a generator like a plug-in. You get to choose what type of application you wish to create, such as a Backbone application or even a Chrome extension.

To install generator-thundr-gae from npm, run:

$ npm install -g generator-thundr-gae

Finally, initiate the generator:

$ yo thundr-gae

Getting To Know Yeoman

Yeoman has a heart of gold. He's a person with feelings and opinions, but he's very easy to work with. If you think he's too opinionated, he can be easily convinced.

If you'd like to get to know Yeoman better and meet some of his friends, Grunt and Bower, check out the complete Getting Started Guide.

License

MIT