to-build

1.1.0 • Public • Published

Name

to-build is a quick build generator


Description

to-build parses an index.html in development and generates a new build from it.


Installation

$> npm install to-build

Usage

Generate builds in the ./out directory with .css and .js minified
Two builds were generated in two different folders:

./out/staging => Contains minified files + sourcemaps

./out/production => Contains minified files with no sourcemaps (partially flattened folder)

$> to-build src/index.html

Options

Options Description Expect Default
--development Only launch the server against your development folder boolean
--staging Do a build for staging boolean
--production Do a build for production boolean
--all Do a build for staging and production at once boolean
--noserver Do not run servers after builds boolean
--output The folder to hold the build string
--root Folders the engine will look up to, to resolve extracted uris
including the current working
directory and the node_modules folder
string[] [
, user defined
, <node_modules>]
--static Extra Folders the engine will look up to, to resolve extracted uris if not found in the --root ones string[]
--minifyCss Whether to minify css boolean
--minifyJs Whether to minify js boolean
--minifyHtml Whether to minify html boolean
--sourcemaps Whether to generate sourcemaps boolean
  • Sourcemaps are not generated in production

Servers

By default, the development server runs on port 10000, staging on port 10002 and production on port 10004.

To have a quick report:

$> npx genserve scan --namespace to-build

To edit ports, locate the configuration file with:

# To get the servers configuration path 
$> npx genserve path servers --namespace to-build

To stop servers

$> npx genserve stop all --namespace to-build

Examples

Generate build in a folder called "target"
$> to-build src/index.html --output target

Generate build with no source map
$> to-build src/index.html --sourcemaps false

Generate build with non-minified css
$> to-build src/index.html --minifyCss false

Generate build with non-minified html
$> to-build src/index.html --minifyHtml false

Generate build with non-minified js
$> to-build src/index.html --minifyJs false

Generate build only for production
$> to-build src/index.html --production

Generate build only for staging
$> to-build src/index.html --staging

Generate build only for development
$> to-build src/index.html --development

Changelog

current:
  • Add the directive [to-build remove] to remove code from generated html files
  • Fix generated html
  • Fix files containing special characters in uris not processed
  • Add one second pause after starting a server
  • Remove duplicated log ids
  • Do not start all builds automatically
  • Use AnaLogger module to display logs
  • Add --noserver option to prevent launching servers automatically
  • Run all servers at start
  • Fix generation for production assets
  • Generate build for production
  • Add --static options to add extras static directories
  • Scan css to add more linked files to the build directory
  • Start server after build
  • Add missing library source-finder
  • Fix build missing resource files
  • Fix build generation for script module types
  • Minify module type js with to-esm
  • Minify HTML
  • Generate css files with options from html
  • Fix missing css files processing
  • Run from CLI

Readme

Keywords

Package Sidebar

Install

npm i to-build

Weekly Downloads

2

Version

1.1.0

License

MIT

Unpacked Size

61.3 kB

Total Files

9

Last publish

Collaborators

  • thimpat