The form itself is of very limited importance; it becomes the grammar for the total work. In fact it is best that the basic unit be deliberately uninteresting so that it may more easily become an intrinsic part of the entire work. Using complex basic forms only disrupts the unity of the whole. Using a simple form repeatedly narrows the field of the work and concentrates the intensity to the arrangement of the form. This arrangement becomes the end while the form becomes the means.

Sol LeWitt, Paragraphs on Conceptual Art

Sol is a front-end (JS/CSS) library, developed by MoMA’s Digital Product team for use across the organization’s various products. It takes an “atomic” approach of providing simple utility functions and classes which incorporate the basic design paradigms for MoMA’s brand, (mostly) agnostic of their specific usage.

Classes and available modules are documented on the Wiki. You can see an example of how to include in your site in the example folder, and for more examples of how to use various classes and components check sol-101.

1. To install, make sure you have homebrew installed, and then run this install Dart Sass
   yarn install-sass

2. To build for development, run the first command. Or if you want to build and watch, use the second command
   yarn run build-dev or yarn run watch

3. To make build for distribution, run the following. This builds the css and the compressed css yarn run build

To link with moma-go, in the project folder, run yarn link. In moma-go, run yarn link sol. This creates a symlink to your local version.

To create a release, merge all PRs that will be part of it into main.

Then with main checked out, run yarn release 1.0.0, replacing 1.0.0 with the release version number.

Once the artifact files have been generated and the release has been tagged, go to Github and draft a new release, using the tag version that was created.

More on semantic versioning here.

You should just get dist/sol.css or dist/sol.min.css. Fonts are also provided in the dist folder.

To add to your package manager, such as yarn, do yarn add github:MuseumofModernArt/sol. If you would like to lock to a specific version, append #v1.0.0 to the end. More on all this here.

To update your version of the MoMA Style to the latest release, yarn upgrade sol. To update to a specific version, run yarn upgrade sol#[version].