https://github.com/max-mapper/wzrd

Super minimal browserify development server
https://github.com/max-mapper/wzrd

Last synced: 28 days ago
JSON representation

Super minimal browserify development server

• Host: GitHub
• URL: https://github.com/max-mapper/wzrd
• Owner: max-mapper
• Created: 2014-12-24T19:53:17.000Z (almost 10 years ago)
• Default Branch: master
• Last Pushed: 2020-09-04T22:17:27.000Z (about 4 years ago)
• Last Synced: 2024-09-10T11:02:00.834Z (2 months ago)
• Language: JavaScript
• Size: 27.3 KB
• Stars: 250
• Watchers: 8
• Forks: 17
• Open Issues: 7
• Metadata Files:
  • Readme: readme.md

Awesome Lists containing this project

README

        
# wzrd

Super minimal browserify development server. Inspired by [beefy](http://npmjs.org/beefy) but with less magic

[![Build Status](https://travis-ci.org/maxogden/wzrd.svg?branch=master)](https://travis-ci.org/maxogden/wzrd)

## installation

```

npm install wzrd -g

```

**note** that you must have a copy of `browserify` installed as well. It can be either local (preferred) or global.

```

npm install browserify --save

```

## usage

```

wzrd app.js

```

This will start a local development server (default of `localhost:9966`) that serves all files in the current folder with the exception of `app.js`, which will be browserified instead. `wzrd` will spawn the command `browserify app.js` and send the output bundle back to the client.

If no `index.html` is present in the directory you run `wzrd` in, one will be generated for you that has a `` in it.

### mappings

You can also specify a mapping:

```

wzrd app.js:bundle.js

```

This means if a request to the server comes in for `bundle.js`, `wzrd` will run the command `browserify app.js` and serve that.

### multiple entries

```

wzrd app.js:bundle.js foo.js:bar.js baz.js

```

### https

```

wzrd app.js --https

```

this will start a local https server (by default `https://localhost:4443`) and generate a self signed SSL certificate. You will get a certificate error in your browser, but if you ignore the error the app should load.

### passing extra args to browserify

```

wzrd app.js -- -t brfs

```

anything after `--` will get passed directly to `browserify` as arguments. so the example above would spawn the command `browserify app.js -t brfs`

### pushstate server support

```

wzrd app.js --pushstate

```

if you want to leverage the html5 pushstate and support natural urls in your frontend application you can use the `--pushstate` flag. This flag will instruct the wzrd server to always return index.html for any file not found request from your server.