Gecko [ fernandoquevedodop.com ]

Name	Size	Permission
examples	[ DIR ]	drwxr-xr-x
CHANGELOG-historical.md.gz	28.74 KB	-rw-r--r--
CODE_OF_CONDUCT.md	3.14 KB	-rw-r--r--
README.md.gz	2.26 KB	-rw-r--r--
advanced.md.gz	5.58 KB	-rw-r--r--
api.md.gz	15 KB	-rw-r--r--
browser.md	781 B	-rw-r--r--
bundling.md	1.44 KB	-rw-r--r--
changelog.Debian.gz	1005 B	-rw-r--r--
contributing.md	1.04 KB	-rw-r--r--
copyright	3.15 KB	-rw-r--r--
examples.md.gz	2.05 KB	-rw-r--r--
tricks.md	2.21 KB	-rw-r--r--
typescript.md	1.44 KB	-rw-r--r--

Code Editor : bundling.md

## Bundling yargs

This document outlines how to bundle your libraries that use yargs into
standalone distributions.

### You might not need to bundle

Newer releases of yargs can run directly in modern browsers, take a look at
[Running yargs in the browser](https://github.com/yargs/yargs/blob/master/docs/browser.md).

## ncc

If you are targeting Node.js with your bundle, we recommend using
[`@vercel/ncc`](https://www.npmjs.com/package/@vercel/ncc).

Given a CommonJS file, **index.js**:

```js
const yargs = require('yargs/yargs')
const chalk = require('chalk')
require('yargs/yargs')(process.argv.slice(2))
  .option('awesome-opt', {
    describe: `my awesome ${chalk.green('option')}`
  })
  .parse()
```

You can simply run: `ncc build index.js`.

### Webpack

Given a CommonJS file, **index.js**:

You can create a CommonJS bundle with the following `webpack.config.js`:

```js
module.exports = {
  mode: "development",
  entry: {
    index: "./index.js",
  },
  output: {
    filename: './index.js'
  },
  resolve: {
    extensions: ['.js', '.cjs', '.json']
  },
  target: 'node',
  devtool: "source-map-inline",
  externals: {
    'cliui': 'commonjs2 cliui',
    'y18n': 'commonjs2 y18n',
    'yargs-parser': 'commonjs2 yargs-parser',
  },
};
```

${this.title}

Code Editor : bundling.md