# budo-chrome

> an extension of budo dev server that supports live script injection

Latest version **3.0.0** (published 2015-11-20) · MIT license · 0 weekly downloads

## Install

```sh
npm install budo-chrome
pnpm add budo-chrome
yarn add budo-chrome
bun add budo-chrome
```

Provides the command `budo-chrome`.

## Health

**Score 15/100 (F)** — status: abandoned.

Positive: no vulnerabilities.

Warnings: low downloads; no types; no esm support.

Negative: abandoned; low maintenance score.

## Facts

| | |
|---|---|
| Version | 3.0.0 |
| Published | 2015-11-20 |
| First published | 2015-02-21 |
| Weekly downloads | 0 |
| License | MIT |
| TypeScript types | none |
| Module format | CommonJS |
| Dependencies | 8 |
| Known vulnerabilities | 0 (+2 in 1 direct dependencies) |
| Install scripts | no |
| GitHub stars | 40 |
| Author | Matt DesLauriers |
| Maintainers | mattdesl |

## Links

- npm: https://www.npmjs.com/package/budo-chrome
- Repository: https://github.com/mattdesl/budo-chrome
- Issues: https://github.com/mattdesl/budo-chrome/issues
- npm.io page: https://npm.io/package/budo-chrome

## Dependencies (8)

- [tmp](https://npm.io/package/tmp.md) 0.0.25
- [bole](https://npm.io/package/bole.md) ^2.0.0
- [budo](https://npm.io/package/budo.md) ^6.0.4
- [xtend](https://npm.io/package/xtend.md) ^4.0.0
- [rimraf](https://npm.io/package/rimraf.md) ^2.3.2
- [minimist](https://npm.io/package/minimist.md) ^1.1.1
- [chrome-launch](https://npm.io/package/chrome-launch.md) ^1.1.3
- [chrome-remote-interface](https://npm.io/package/chrome-remote-interface.md) ^0.6.1

## Recent versions

- 3.0.0 (latest) — 2015-11-20
- 2.2.0 — 2015-04-26
- 2.1.0 — 2015-04-24
- 2.0.0 — 2015-04-13
- 1.0.7 — 2015-03-30
- 1.0.6 — 2015-03-28
- 1.0.5 — 2015-03-28
- 1.0.4 — 2015-02-22
- 1.0.3 — 2015-02-21
- 1.0.2 — 2015-02-21
- 1.0.1 — 2015-02-21
- 1.0.0 — 2015-02-21

## README

# budō-chrome

[![experimental](http://badges.github.io/stability-badges/dist/experimental.svg)](http://github.com/badges/stability-badges)

[![screenshot](http://i.imgur.com/LJP7d9I.png)](https://www.youtube.com/watch?v=cfgeN3G_Gl0)

<sup>[(click for demo)](https://www.youtube.com/watch?v=cfgeN3G_Gl0)</sup>

A browserify dev server on top of [budō](https://github.com/mattdesl/budo), providing live script injection for Chrome. On filesave, this can make updates to animations and graphics without destroying application state. 

Under the hood, this uses v8 LiveEdit through Chrome's Remote Debugging protocol. The technology is still experimental, and may not be suitable yet for widespread production use. 

```sh
# install the tool
npm install -g budo-chrome

# now run our dev server
budo-chrome index.js --open
```

> :bulb: You may need to quit all running instances of Chrome before continuing.

This should open Chrome with the remote debugger attached. Changing `index.js` will incrementally update a `bundle.js` file and inject the new source into Chrome. 

Props to [@caspervonb](https://twitter.com/caspervonb) for the early groundwork.

## about

See [the docs](docs/README.md) for information on how to get set up. See [the demo](https://www.youtube.com/watch?v=cfgeN3G_Gl0) and its [source code](https://github.com/mattdesl/budo-ball-example) for an example of how it looks in practice. 

## Usage

[![NPM](https://nodei.co/npm/budo-chrome.png)](https://www.npmjs.com/package/budo-chrome)

```sh
Usage:
    budo-chrome [entries] [opts]

Options:
    --open          open a new instance of Chrome
    --remote-port   remote debugging port, default 9222
```

The other options are passed along to [budō](https://github.com/mattdesl/budo) and browserify/watchify.

## License

MIT, see [LICENSE.md](http://github.com/mattdesl/budo-chrome/blob/master/LICENSE.md) for details.

---
_Source: https://npm.io/package/budo-chrome · Machine-readable twin of the npm.io package page. Health data is recomputed on every publish._
