Skip to content
Official open source SVG icon library for Bootstrap.
JavaScript
Branch: master
Clone or download
XhmikosR and mdo Update _index.md
Add missing alt attribute
Latest commit 76f84ab Dec 2, 2019

README.md

Bootstrap logo

Bootstrap Icons

Official open source SVG icon library for Bootstrap.
Explore Bootstrap Icons »

Bootstrap · Themes · Blog

200+ icons

Bootstrap Icons full set

Also available in Figma.

Install

Bootstrap Icons are packaged up and published to npm. We only include the processed SVGs in this package—it's up to you and your team to implement. Read our docs at for usage instructions.

npm i bootstrap-icons --save

Development

Build Status

Clone the repo, install dependencies, and start the Hugo server locally.

git clone https://github.com/twbs/icons/
cd icons
npm i
npm start

Then open http://localhost:4000 in your browser.

Adding SVGs

Once a new SVG icon has been added to the icons directory, you'll need to optimize them. An npm script is used to:

  1. Optimize our SVGs with SVGO.
  2. Modify the SVGs source HTML, removing all attributes before setting new attributes and values in our preferred order.

Use npm run icons to run the script, then commit the results in a new branch for updating.

Publishing

Docs are published via an npm script that builds the Hugo site, creates a temporary Git repo, and force pushes that to our gh-pages branch. This circumvents issues with GitHub Pages not working with Hugo.

npm run publish

License

MIT

Author

@mdo

You can’t perform that action at this time.