bower-browser

0.6.2 • Public • Published

bower-browser

GUI Bower manager runs on web browser

NPM Version Build Status Dependency Status

bower-browser

Features

  • Search from the Bower registry
  • Install packages with various options
  • Monitor log in realtime
  • Manage local Bower components

Features

Installation

Install via npm.

$ npm install -g bower-browser

Install with -g option for command line interface, --save or --save-dev for using module API.
Grunt plugin is also available.

Requirements

bower-browser executes bower in background.
Make sure to install Bower if you haven't: $ npm install -g bower

Usage

cd path/to/your-project
$ bower-browser

Then, web browser will open http://localhost:3010 automatically.
Manage your Bower components in the web GUI! :-)

CLI Options

  • --path <directory>
    Location of bower.json. (default: use process.cwd())

  • --port <number>
    Port number of bower-browser server. (default: 3010)

  • --cache <seconds>
    Cache TTL for package list API. Set 0 to force to fetch API. (default: 86400 = 24hours)

  • --skip-open
    Prevent opening web browser at the start.

  • --silent
    Print nothing to stdout.

  • -h, --help
    Output usage information.

  • -V, --version
    Output the version number.

Integration with Build Systems

Gulp

Use bower-browser module directly.

var bowerBrowser = require('bower-browser');
 
gulp.task('bower-browser', function () {
  bowerBrowser({
    // Options here.
  });
});
 
// Alias for running preview server and bower-browser at the same time.
gulp.task('serve', ['connect', 'bower-browser', 'watch'], function () {
  // ...
});

Grunt

Use grunt-bower-browser plugin.

API

Quick Start

// Run bower-browser using default config.
require('bower-browser')();

Advanced

var bowerBrowser = require('bower-browser');
 
// Start app with options you like.
var app = bowerBrowser({
  path: 'path/to/project',  // Location of bower.json. default: null (use process.cwd())
  port: 8080,               // Port number. default: 3010
  cache: 0,                 // Cache TTL. Set 0 to force to fetch API. default: 86400 (24hrs)
  open: false,              // Prevent opening browser. default: true (open automatically)
  silent: true              // Print nothing to stdout. default: false
});
 
// Events
app.on('start', function () {
  console.log('Started bower-browser!');
});
 
// Methods
app.close();

NOTE: Events and methods are experimental for now. They might be updated.

Events

  • on('start', callback)
    When the web server is started.

  • on('close', callback)
    When the web server and all wathers are closed.

  • on('log', callback(message))
    When log message is received from bower execution.

Methods

  • close()
    Close web server and all watchers.

License

Copyright (c) 2014-2015 Rakuten, Inc. Licensed under the MIT License.

Readme

Keywords

Package Sidebar

Install

npm i bower-browser

Weekly Downloads

2

Version

0.6.2

License

none

Last publish

Collaborators

  • htanjo