Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

https://github.com/yeoman/generator-chromeapp

Scaffold out a Chrome app
https://github.com/yeoman/generator-chromeapp

Last synced: 3 months ago
JSON representation

Scaffold out a Chrome app

Lists

README

        

# Chrome App generator [![Build Status](https://secure.travis-ci.org/yeoman/generator-chromeapp.svg?branch=master)](http://travis-ci.org/yeoman/generator-chromeapp)

Maintainer: [Jimmy Moon](https://github.com/ragingwind)

> Chrome Apps boilerplate generator that creates everything you need to get started with development. To test, go to: chrome://extensions, enable Developer mode and load `app` as an unpacked extension.

## Getting Started

- First make a new directory, and `cd` into it: mkdir my-new-chromeapp && cd $_
- Install the generator: `npm install -g generator-chromeapp`
- Run: `yo chromeapp`

## Generators

Available generators:

* [chromeapp](#app) (aka [chromeapp:app](#app))
* [chromeapp:permission](#permission)
* [chromeapp:samples](#samples)

### App

![](http://i.imgur.com/vh7uo4X.gif)

Sets up a new Chrome App, generating all the boilerplate you need to get started.

Example:
```bash
yo chromeapp
```

### Permission

![](http://i.imgur.com/O6LrhEB.png)

Create manifest.json or append permission into manifest.json. You can choose permission to put into manifest.json

Example:
```bash
yo chromeapp:permission
```

### Samples

![](http://i.imgur.com/OgPhpfA.gif)

You can create a new Chrome App with the [google-chrome-app samples](https://github.com/GoogleChrome/chrome-app-samples) on GitHub.

Example:
```bash
yo chromeapp:samples
```

## Build

Creates a production build, production files to zip file. You can publish zip file to Chrome Web Store.

Examples:
```bash
grunt build
```

## Debug

Support two preview mode. LiveReload/run/debug your Chrome App on Chrome browser and Chrome app container.

* `grunt debug` - Default, run you Chrome App on Chrome app container

![](http://i.imgur.com/DGxbvBY.gif)

* `grunt debug:server` - Run you Chrome App on Chrome browser like 'serve' task of webapp.

![](http://i.imgur.com/GxVDqVp.gif)

## Options

* `--skip-install`

Skips the automatic execution of `bower` and `npm` after
scaffolding has finished.

* `--test-framework=[framework]`

Defaults to `mocha`. Can be switched for
another supported testing framework like `jasmine`.

* `--skip-pull`

Skips the `pull` command of `git` which checks the [google-chrome-app samples](https://github.com/GoogleChrome/chrome-app-samples) on GitHub

* `--coffee`

Add support for [CoffeeScript](http://coffeescript.org/).

* `--compass`

Add support for [Compass](http://compass-style.org/).

> WARN, Compiled files that generated by coffee or compass will be remained if your Chrome App running on Chrome App container (with `grunt debug`). You should remove or ignore that files if you don't want to commit to repo.

## Contribute

See the [contributing docs](https://github.com/yeoman/yeoman/blob/master/contributing.md)

## License

[BSD license](http://opensource.org/licenses/bsd-license.php)