source-map plugin for Browserify
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Failed to load latest commit information.
lib
test
.editorconfig
.eslintrc.yml
.gitignore
.travis.yml
LICENSE
README.md
appveyor.yml
package-lock.json
package.json

README.md

sourcemapify

source-map plugin for Browserify

Build Status Windows Build Status

Coverage Status Codacy Score Inline docs Dependencies

npm License

The default sourcemap that Browserify generates uses paths that are relative to the current directory, which may not always be what you want. This plugin lets you change the relative path, or use absolute paths.

This plugin was inspired by browserify-sourcemap-root-transform, so check that one out if this one doesn't meet your needs.

Related Projects

  • simplifyify - A simplified Browserify and Watchify CLI
  • globify - Run browserify and watchify with globs - even on Windows
  • browserify-banner - Add a comment (and/or code) to the top of your Browserify bundle

Installation

Install using npm:

npm install sourcemapify

Usage

Command Line

Use Browserify's sub-argument command-line syntax, like this:

browserify -p [ sourcemapify --root "../../" ] --debug

Browserify API

Use the plugin programmatically like this: full example

var browserify = require('browserify');
var sourcemapify = require('sourcemapify');

browserify({debug: true})
  .plugin(sourcemapify, {base: 'www/js'})
  .bundle()
  .pipe(fs.createWriteStream('www/js/bundle.js', 'utf8'));

Options

The following options can be set via the API or command-line:

root (string)

The root path for all files in the source map. It can be an absolute or relative path. This string will be prepended as-is to each file path.

base (string)

The base path of the bundle (i.e. the bundle file's directory, relative to cwd). This path will be used to determine the relative path of each file. It can be an absolute or relative path.

Contributing

I welcome any contributions, enhancements, and bug-fixes. File an issue on GitHub and submit a pull request.

Building

To build the project locally on your computer:

  1. Clone this repo
    git clone https://github.com/bigstickcarpet/sourcemapify.git

  2. Install dependencies
    npm install

  3. Link the module to itself (so Browserify can find the plugin)
    npm link
    npm link sourcemapify

  4. Run the tests
    npm test

License

sourcemapify is 100% free and open-source, under the MIT license. Use it however you want.