JSPM

octicons

4.4.0
  • ESM via JSPM
  • ES Module Entrypoint
  • Export Map
  • Keywords
  • License
  • Repository URL
  • TypeScript Types
  • README
  • Created
  • Published
  • Downloads 10358
  • Score
    100M100P100Q37117F
  • License (OFL-1.1 OR MIT)

A scalable set of icons handcrafted with <3 by GitHub.

Package Exports

  • octicons
  • octicons/build/font/octicons.css
  • octicons/build/octicons.css
  • octicons/index.js

This package does not declare an exports field, so the exports above have been automatically detected and optimized by JSPM instead. If any package subpath is missing, it is recommended to post an issue to the original package (octicons) to support the "exports" field. If that is not possible, create a JSPM override to customize the exports field for this package.

Readme

GitHub Octicons

NPM version Build Status

Octicons are a scalable set of icons handcrafted with <3 by GitHub.

Install

NPM

This repository is distributed with npm. After installing npm, you can install octicons with this command.

$ npm install --save octicons

Usage

The source files included are written in Sass (scss) You can simply point your sass include-path at your node_modules directory and import it like this.

@import "octicons/index.scss";

Changing, adding, or deleting icons

  1. Open the Sketch document in /lib/. Each icon exists as an artboard within our master Sketch document. If you’re adding an icon, duplicate one of the artboards and add your shapes to it. Be sure to give your artboard a name that makes sense.
  2. Once you’re happy with your icon set, choose File > Export…
  3. Choose all the artboards you’d like to export and then press “Export”
  4. Export to /lib/svg/

You’ll next need to build your Octicons.

Building Octicons

All the files you need will be in the /build/ directory already, but if you’ve made changes to the /lib/ directory and need to regenerate, follow these steps:

  1. Open the Octicons directory in Terminal
  2. Run the command script/bootstrap. This will install any necessary dependencies for generating the Octicons font and SVGs.
  3. Run the command grunt. Running the grunt task will generate the font and SVGs, placing them in the /build/ directory.

Publishing

If you have access to publish this repository, these are the steps to publishing. If you need access, contact #design-systems.

  1. Update the CHANGELOG.md with relevant version number and any updates made to the repository.
  2. npm version <newversion> Run npm version inputing the relevant version type. The versioning is semver, so version appropriately based on what has changed.
  3. npm publish This will publish the new version to npmjs.org
  4. git push && git push --tags Push all these changes to origin.

License

(c) 2012-2016 GitHub, Inc.

When using the GitHub logos, be sure to follow the GitHub logo guidelines.

Font License: SIL OFL 1.1
Applies to all font files and SVG files

Code License: MIT
Applies to all other files