Structure Icons are deprecated. Please use icons provided by https://github.com/hashicorp/design-system.

structure-icons

Icons for the HashiCorp Structure design system.

Installation

npm i @hashicorp/structure-icons or yarn add @hashicorp/structure-icons depending on your flavor of package management.

Versioning

The versions of this package are meant to track releases of Structure as closely as possible.

Usage in your application

Generally speaking, you install the package and then SVG files will be located at @hashicorp/structure-icons/dist/name-of-icon.svg. If you need a list of icons, one is available for import at @hashicorp/structure-icons/dist/index.js.

ember-svg-jar

After installation, add the following to your ember-cli-build.js:

var app = new EmberApp({
  svgJar: {
    // Icons have already been optimized via SVGO,
    // so we don't need to optimize them again.
    optimize: false,

    paths: [
      'path/to/node_modules/@hashicorp/structure-icons/dist',
      // ... additional paths
    ]
  }
});

Updating icons

For each release of Structure, we should update the icons in this library:

Go to the Icon System page in Figma. Note: This link might be out of date, so check with someone in Design if you're not sure.
Highlight all of the icons under the "Icons" and "Logos" headers to the right of the sticker sheet
Use the right panel to export the icons in SVG format to the /src folder in this repo (if you delete any files from /src, be careful not to delete the "run" or "loading" SVG files or their CSS).
Run npm run generate
Review /dist/index.html to make sure your updates were added correctly
Commit your changes and follow the "New releases" instructions below

New releases

Prerequisites

In order to publish packages, you must:

Be added to the HashiCorp organization on npm
Enable 2-factor authentication on your npm account
Log into to npm in your CLI with npm login

Publishing

To release a new version of @hashicorp/structure-icons you should:

ensure the src folder contains all of the CSS and SVG files you want to publish
bump version number in the package.json
commit & merge changes after review
run npm publish - this will run the prepublishOnly hook which will re-generate all of the optimized SVGs from the src folder and copy them to a dist folder.