html-builder-cli

3.0.0 • Public • Published

html-builder-cli

The fastest way to package an HTML project into a fully native desktop app

Installation

Requires npm.

Install from npm

In the command line, run npm install html-builder-cli -g

Build from source

  1. Clone this repository
  2. Run npm install -g

Usage

In your HTML project's directory, create a file called manifest.json. manifest.json should be a JSON file (not just a JS Object literal). It can have the following keys:

  • name (required): the name of the application.
  • platforms (required): an array of operating systems to build for. Each element of the array must be a string that is either linux, mac, or windows;
  • desc (optional): a short description of the application.
  • version (optional): the application's version. Must be a string in the format x.x.x. Defaults to 1.0.0.
  • icon (optional): the relative location of the icon file (preferably a PNG of size >= 512x512px). Defaults to icon.png. AN ICON FILE MUST BE PROVIDED.
  • indexFile (optional): the relative location of the main HTML file to be displayed by the app. Defaults to index.html.
  • colorScheme (optional): dark, light, or system. Defaults to system.

Here is an example manifest.json file:

{
    "name": "Cool App",
    "desc": "An awesome desktop app I made!",
    "platforms": [
        "linux",
        "mac"
    ],
    "version": "1.1.1",
    "icon": "logo.png"
}

Once you have finished creating your manifest.json file, open the command line in the same directory and run html-builder-cli.

Package Sidebar

Install

npm i html-builder-cli

Weekly Downloads

1

Version

3.0.0

License

MIT

Unpacked Size

9.17 kB

Total Files

6

Last publish

Collaborators

  • yikuansun