Imarc Boilerplate 4 Components
This is a framework for frontend development. It includes
- Support for Sass,
- A Pattern Library (powered by Fractal), and
- A Front End Build (powered by Laravel Mix.)
This pairs with imarc/boilerplate as a version that contains with many of the components that were originally just part of that project.
imarc/boilerplate provides a basic pattern library, folder structure, and build files. This repository, imarc/boilerplate-components, provides that along with a set of basic components.
While we encourage you to read the builtin documentation, some highlights are
Some components were carried over from version 3, but were not updated to the latest practices and syntax. These are flagged as DEPRECATED within the pattern library, and may be removed entirely in a future release.
Within a new project, make sure you first have an existing
package.json. If you don't have one, you can create one by running
npm init -y
After that, run
NPX should automatically copy the resource folder to your project, add dependencies to your package.json, and even add scripts to your package.json file.
npx above, your project will be automatically setup so you can run
npm run devto run the development build (make sourcemaps, don't minify, etc.)
npm run prodto run the production build.
npm run watchto watches files for changes and automatically re-run the development build.
To locally serve the pattern library:
npm run fractal start -wto run a local server and watch for changes
And lastly, to build the pattern library:
npm run fractal build
You can customize this behavior further by editing either the
fractal.js files per the Laravel Mix or Fractal documentation respectively.