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

slush-aw-webapp

v0.2.3

Published

Slush generator for webapps

Downloads

35

Readme

Generator for the aw-webapp workflow

Use the generator to start developing a webapp or an bower/npm component

Usage

Prequisits

  • npm i -g bower slush gulp-cli
  • Python 2.7 installed and added to path

Installation

  • $ npm i -g slush-aw-webapp
  • Create a working directory and enter into it
  • $ slush aw-webapp
  • Start coding Check the trouble shooting section if you run into any problems

Update

Want to use the latest version of the workflow on an existing project which was generated with this generator?

  • $ npm i -g slush-aw-webapp
  • Navigate to the project directory
  • $ slush aw-webapp:update
  • $ bower install
  • $ npm install

Gulp commands

  • $ gulp - Starting the development workflow. Reloads browser on change, Compiles SASS to CSS, injects dependencies and runs unit tests.
  • $ gulp build - Creates a build in the specified build folder. Change the production flag in gulp.config.json to create a preproduction build.
  • $ gulp serveCoverage - Serves the coverage report of our unit tests.

Configuration

  • gulp.config.json - Used for settings of the workflow. Overwrites any defaults set in gulpfile.js/gulp.config.js.
  • karma.conf.js - Holds configuration concerning unit testing. Which files should be tested and which frameworks and plugins karma should use in our tests.

Unit testing

We use Karma testrunner and Jasmine as a testing framework. Just add any file with a .spec.js extention and the workflow will start running the tests automagically.

Snippets

For our team there are snippets available in a gist. Ask for the snippets as they hold code conventions and will make your work a lot faster. There are snippets for Angular and Jasmine.

publish to bower

To publish to bower we use github. As this is a public repo please make sure there is no reference to arteries the code base.

IMPORTANT: Before you build, remove the inject statement from your index.html and make sure only the files which are needed for your component to run are added to the build.

  • Set the right name of your component in the bower.json
  • Ensure the right files are in the ignore & main property in you bower.json
  • $ gulp build
  • $ git remote add bower <github-url>
  • $ bower version <patch|minor|major> (google semver for more info)
  • $ git push bower master --tags (after add & commit)
  • $ bower register aac-<name> <github-url>

After this use bower search to check or your component is registrered well. E.g. bower search <component-name>

Trouble shooting (windows only)

Npm installation errors

First of all check or you have Python 2.7 installed and added to your path. Run $ npm cache clean and after $ npm install again.

Build errors

If you experience build errors (MSBUILD) after this you might have to install Visual Studio including the C SDK and .NET (2 & 3)

Missing Dependencies

In case you get any errors concerning missing dependencies try running $ npm install again. If you still run in to problems try installing some problematic manually e.g. $ npm install <package-name>. Installing template cache node module ($ npm install gulp-angular-templatecache) has solved this issue sometimes.

Still having problems?

Cry and buy a mac or install linux.