bstudio is a node.js command line application which presents an interface to Bootstrap Studio through the command line. Its purpose is to automate various tasks like automatically generating Bootstrap Studio components (.bscomp files) from scripts.

You need to have Bootstrap Studio running on the same computer in order to use this utility. The communication happens through a UNIX domain socket (under Linux and OS X) or through a named pipe (under Windows).

The script is available on npm. To install it:

npm install -g bstudio

This will create a global bstudio command which you can call from the terminal.

bstudio doesn't export any library functions currently, so there is no point in require()-ing it in node.js scripts.

The utility is structured around passing commands to Bootstrap Studio. To run it, call bstudio from your terminal while passing one of the available commands:

bstudio <command> [options]

The only command implemented right now is create-component, for programatically generating .bscomp files. More will be added in the future according to user feedback.

Generating .bscomp files is done with the create-component command:

bstudio create-component -i definition.json

# Alternatively, omit the -i flag and pass the json through stdin:
# cat definition.json | bstudio create-component

The resulting .bscomp file will be placed in the current working directory.

definition.json is a specially structured JSON file that, as a minimum, has the following structure:

{
  "name": "My Sweet Component",
  "html": "<p>The HTML of your component.</p>"
}

If you wish to add CSS, JS, fonts or images to your component, you can add these to the JSON:

{
  "name": "My Sweet Component",
  "framework": "4",
  "html": "<p class=\"custom\">The HTML of your component.</p>",
  "js": [ "alert(1);" ],
  "css": [ ".custom { font-size:20px;color:red; }" ],
  "fonts": { 
    "Open Sans": "https://fonts.googleapis.com/css?family=Open+Sans:400,700"
  },
  "images": [ "/path/to/image.png" ]
}

The framework property indicates which version of the Bootstrap framework to use. By default it is set to Bootstrap 3.

You can add more values to the arrays if you wish your component to contain multiple files of that type. The images array should contain paths to images on your computer. If you are on Windows, this path should look like C:\\Users\\xxxx\\picture.jpg.

To report bugs or ask for help, use our forum.

Released under the MIT license.

Zine EOOD (c) 2019