Get Guise Skeleton

Before using Guise Skeleton on your pages, you must first download the necessary CSS files so that you can include them on your site. The recommended approach is to download the archive with the pre-built target CSS files. If you'd rather build the files yourself, you can do this from the source files after retrieving them from GitHub or the npm Repository.

Downloading Pre-Built Artifacts (recommended)

Each release of Guise Skeleton comes with a set of pre-built target CSS files you can download as a single archive from its GitHub repository.

1. Go to the Guise Skeleton releases page on GitHub.
2. Find the release you want; preferably the latest.
3. Download the guise-skeleton-x.x.x.zip archive file associated with the release.

After extracting the archive the distributable CSS files will be in the css/ directory.

Downloading and Building from Source

If you choose to download the source files, you should first build the project and use the produced distributable CSS files, not the original source CSS files.

Installing from the npm Repository

If you have npm installed you can install the latest version directly from its npm repository. You will still need to build the project after installation.

1. Install Guise Skeleton using npm.

   npm i @guise/skeleton

2. Find the source code in the node_modules/@guise/skeleton/ directory.
3. Build the project as explained below.

Cloning from GitHub

You can also clone the GitHub repository to get the very latest version, and in fact the entire revision history. The latest version may not be stable. You will need Git to clone the repository and npm to build the project

1. Clone the Guise Skeleton Git repository.

   git clone https://github.com/globalmentor/guise-skeleton.git

2. Find the source code in the guise-skeleton/ directory.
3. Build the project as explained below.

Building the Project

After you have downloaded the source code, you should build the project and use the distributable files the build produces—not the source files themselves.

npm run build

Building the project produces the following files:

• dist/css/*.css: Source CSS files for distribution.
• dist/css/*-min.css: Minimized CSS files for distribution.
• dist/css/*-min.css.map: Map files for debugging minimized CSS files.
• target/guise-skeleton-x-x-x.zip: Archive of distributable files listed above.

Read the Getting Started guide to find out how to use these in your web page.