Introduction
Carafe Bundle Creator is an NPM initializer which you can use to bootstrap a new Carafe Bundle project. The initializer will bootstrap a new bundle project using a starter template and include Carafe Bundler as a devDependency.
Prerequisites
You will need to have Node.js installed to use this utility via Node Package Manager (NPM).
Create A New Bundle
Start a brand new Bundle project in your preferred editor or IDE
npm init @carafe-fm/bundle my-new-bundle
cd my-new-bundle
This command will create a new my-new-bundle
directory containing a starter project. You need to cd into the newly created Bundle directory to be in the proper context to run the included Carafe Bundler utility scripts. Open the README for detailed instructions on how to work with Carafe Bundler in your local development environment.
Work On An Existing Bundle
You can also use the Carafe Bundle Creator to customize or configuring any existing Bundle in your preferred editor or IDE.
To work on an existing Bundle, you should first initialize a new project just like above, but with an appropriate project name for the existing bundle you want to work on.
npm init @carafe-fm/bundle my-existing-bundle
cd my-existing-bundle
After you've cd'd into it, and then import the Bundle. This extracts the bundle into source files to make it easier to work on.
npm run import path/to/existing-bundle.json
After you've imported a bundle into a Carafe Bundle Creator project, you can work on it as if you had the original source files.