@b-side/cli

Installing b-side CLI

Can also be used with npx, that will allow you get the latests updates available at each use.

npm install -g @b-side/cli

Initialization

The initialization process allow you to jump start a project using @b-side. No options are available for the moment. Modify the created files for further customisations.

npx @b-side/cli init

bs init

Update

Allows you to keep the configuration file up-to-date.

npx @b-side/cli update

Build

The build process will look recursively in configured directory for .js files extending HTMLElement, check for .html having the same name, and combine/transpile the files in one or more javascript package.

npx @b-side/cli build --production --output=public/js

bs build --production --output=public/js

Command line options

• output (default build)
• production

Configuration file (b-side.config.json)

The configuration file will allow you deeper options for you build.

• elements.prefix : prefix added to the custom-elements HTML names (ie <bs-test>)
• input.directory : folder in witch to look for components, relative to root of the project.
• output.prefix :
• output.chunks : manage how files will be packaged.
  • directory : create a package for every folders contained in the input.directory.
  • file : create a package for every component contained in the input.directory.
  • none : (default) create a single package file.
• output.directory :

Default options, if not configured otherwise :

 {
	elements: {
		prefix: "bs"
	},
	input: {
		directory: "elements"
	},
	output: {
		prefix: "bs",
		chunks: "none",
		directory: "build",
	}
}