PHPackages                             twbs/bootstrap-icons - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. [Utility &amp; Helpers](/categories/utility)
4. /
5. twbs/bootstrap-icons

ActiveLibrary[Utility &amp; Helpers](/categories/utility)

twbs/bootstrap-icons
====================

Official open source SVG icon library for Bootstrap

v1.13.1(1y ago)7.9k2.0M—9.8%1.1k[457 issues](https://github.com/twbs/icons/issues)[16 PRs](https://github.com/twbs/icons/pulls)20MITTypeScriptCI passing

Since Oct 13Pushed 1mo ago136 watchersCompare

[ Source](https://github.com/twbs/icons)[ Packagist](https://packagist.org/packages/twbs/bootstrap-icons)[ Docs](https://icons.getbootstrap.com/)[ RSS](/packages/twbs-bootstrap-icons/feed)WikiDiscussions main Synced 1mo ago

READMEChangelog (10)DependenciesVersions (42)Used By (20)

 [ ![Bootstrap logo](https://camo.githubusercontent.com/fe1e9d8cbdd20505a54428b4123e6fda9cecaa50c05ec15e239b9738e1f19320/68747470733a2f2f676574626f6f7473747261702e636f6d2f646f63732f352e322f6173736574732f6272616e642f626f6f7473747261702d6c6f676f2d736861646f772e706e67) ](https://getbootstrap.com/)

### Bootstrap Icons

[](#bootstrap-icons)

 Official open source SVG icon library for Bootstrap with over 2,000 icons.
 [**Explore Bootstrap Icons »**](https://icons.getbootstrap.com/)

 [Bootstrap](https://getbootstrap.com/) · [Themes](https://themes.getbootstrap.com/) · [Blog](https://blog.getbootstrap.com/)

[![Bootstrap Icons preview](https://github.com/twbs/icons/raw/main/.github/preview.png)](https://icons.getbootstrap.com/)

Install
-------

[](#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](https://icons.getbootstrap.com/) for usage instructions.

```
npm i bootstrap-icons
```

For those [using Packagist](https://packagist.org/packages/twbs/bootstrap-icons), you can also install Bootstrap Icons via Composer:

```
composer require twbs/bootstrap-icons
```

[Also available in Figma](https://www.figma.com/community/file/1042482994486402696/Bootstrap-Icons).

Usage
-----

[](#usage)

Depending on your setup, you can include Bootstrap Icons in a handful of ways.

- Copy-paste SVGs as embedded HTML
- Reference via `` element
- Use the SVG sprite
- Include via CSS

[See the docs for more information](https://icons.getbootstrap.com/#usage).

Development
-----------

[](#development)

[![Build Status](https://camo.githubusercontent.com/189affefd3fed9790bc209cb9fcb740f66347669daa2015725bcab09a2eaae8e/68747470733a2f2f696d672e736869656c64732e696f2f6769746875622f616374696f6e732f776f726b666c6f772f7374617475732f747762732f69636f6e732f746573742e796d6c3f6272616e63683d6d61696e266c6162656c3d5465737473266c6f676f3d676974687562)](https://github.com/twbs/icons/actions/workflows/test.yml?query=workflow%3ATests+branch%3Amain)[![npm version](https://camo.githubusercontent.com/6cbed7f1cc0b5987bc65ca2b62e11284a2c480e63c2af6ffe68a59e39208291d/68747470733a2f2f696d672e736869656c64732e696f2f6e706d2f762f626f6f7473747261702d69636f6e733f6c6f676f3d6e706d266c6f676f436f6c6f723d666666)](https://www.npmjs.com/package/bootstrap-icons)

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.

### npm scripts

[](#npm-scripts)

Here are some key scripts you'll use during development. Be sure to look to our `package.json` or `npm run` output for a complete list of scripts.

ScriptDescription`start`Alias for running `docs-serve``docs-serve`Starts a local Hugo server`pages`Generates permalink pages for each icon with template Markdown`icons`Processes and optimizes SVGs in `icons` directory, generates fonts and spriteAdding SVGs
-----------

[](#adding-svgs)

Icons are typically only added by @mdo, but exceptions can be made. New glyphs are designed in Figma first on a 16x16px grid, then exported as flattened SVGs with `fill` (no stroke). Once a new SVG icon has been added to the `icons` directory, we use an npm script to:

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

Use `npm run icons` to run the script, run `npm run pages` to build permalink pages, complete those pages, and, finally, commit the results in a new branch for updating.

**Warning**: Please exclude any auto-generated files, like `font/**` and `bootstrap-icons.svg` from your branch because they cause conflicts, and we generally update the dist files before a release.

Publishing
----------

[](#publishing)

Documentation is published automatically when a new Git tag is published. See our [GitHub Actions](https://github.com/twbs/icons/tree/main/.github/workflows) and [`package.json`](https://github.com/twbs/icons/blob/main/package.json) for more information.

License
-------

[](#license)

[MIT](LICENSE)

Author
------

[](#author)

[@mdo](https://github.com/mdo)

###  Health Score

67

—

FairBetter than 100% of packages

Maintenance71

Regular maintenance activity

Popularity75

Solid adoption and visibility

Community53

Growing community involvement

Maturity62

Established project with proven stability

 Bus Factor2

2 contributors hold 50%+ of commits

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

###  Release Activity

Cadence

Every ~52 days

Recently: every ~1 days

Total

26

Last Release

374d ago

### Community

Maintainers

![](https://www.gravatar.com/avatar/f8bfb3e6a4f4ba5237bfe64b555fc2e6b6f33a2188dda5d1453da6f706debef4?d=identicon)[twbs](/maintainers/twbs)

---

Top Contributors

[![XhmikosR](https://avatars.githubusercontent.com/u/349621?v=4)](https://github.com/XhmikosR "XhmikosR (436 commits)")[![mdo](https://avatars.githubusercontent.com/u/98681?v=4)](https://github.com/mdo "mdo (384 commits)")[![dependabot[bot]](https://avatars.githubusercontent.com/in/29110?v=4)](https://github.com/dependabot[bot] "dependabot[bot] (286 commits)")[![dependabot-preview[bot]](https://avatars.githubusercontent.com/in/2141?v=4)](https://github.com/dependabot-preview[bot] "dependabot-preview[bot] (87 commits)")[![coliff](https://avatars.githubusercontent.com/u/1212885?v=4)](https://github.com/coliff "coliff (7 commits)")[![patrickhlauke](https://avatars.githubusercontent.com/u/895831?v=4)](https://github.com/patrickhlauke "patrickhlauke (6 commits)")[![ShaunRoselt](https://avatars.githubusercontent.com/u/5418178?v=4)](https://github.com/ShaunRoselt "ShaunRoselt (6 commits)")[![korki43](https://avatars.githubusercontent.com/u/213470064?v=4)](https://github.com/korki43 "korki43 (6 commits)")[![julien-deramond](https://avatars.githubusercontent.com/u/17381666?v=4)](https://github.com/julien-deramond "julien-deramond (5 commits)")[![ffes](https://avatars.githubusercontent.com/u/3225656?v=4)](https://github.com/ffes "ffes (5 commits)")[![kiehnek](https://avatars.githubusercontent.com/u/65349313?v=4)](https://github.com/kiehnek "kiehnek (4 commits)")[![bastienmoulia](https://avatars.githubusercontent.com/u/686196?v=4)](https://github.com/bastienmoulia "bastienmoulia (4 commits)")[![vanillajonathan](https://avatars.githubusercontent.com/u/10222521?v=4)](https://github.com/vanillajonathan "vanillajonathan (4 commits)")[![Proxy-99](https://avatars.githubusercontent.com/u/77501848?v=4)](https://github.com/Proxy-99 "Proxy-99 (3 commits)")[![inwardmovement](https://avatars.githubusercontent.com/u/9438102?v=4)](https://github.com/inwardmovement "inwardmovement (2 commits)")[![tjkuson](https://avatars.githubusercontent.com/u/12143269?v=4)](https://github.com/tjkuson "tjkuson (2 commits)")[![ZhangChengLin](https://avatars.githubusercontent.com/u/30773389?v=4)](https://github.com/ZhangChengLin "ZhangChengLin (1 commits)")[![jorimvanhove](https://avatars.githubusercontent.com/u/10433963?v=4)](https://github.com/jorimvanhove "jorimvanhove (1 commits)")[![kyletsang](https://avatars.githubusercontent.com/u/6854874?v=4)](https://github.com/kyletsang "kyletsang (1 commits)")[![leafac](https://avatars.githubusercontent.com/u/586813?v=4)](https://github.com/leafac "leafac (1 commits)")

---

Tags

bootstrapfonticonsspritesvgwoffwoff2iconssvgbootstrapicon font

### Embed Badge

![Health badge](/badges/twbs-bootstrap-icons/health.svg)

```
[![Health](https://phpackages.com/badges/twbs-bootstrap-icons/health.svg)](https://phpackages.com/packages/twbs-bootstrap-icons)
```

###  Alternatives

[simple-icons/simple-icons

SVG icons for popular brands

24.8k194.2k4](/packages/simple-icons-simple-icons)[driftyco/ionicons

The premium icon font for Ionic Framework.

18.0k87.8k8](/packages/driftyco-ionicons)[kartik-v/bootstrap-star-rating

A simple yet powerful JQuery star rating plugin for Bootstrap.

1.1k4.5M5](/packages/kartik-v-bootstrap-star-rating)[loganmarchione/homelab-svg-assets

Full-color SVG icons of homelab-related software, products, and brands

1.2k1.6k](/packages/loganmarchione-homelab-svg-assets)[mervick/material-design-icons

Google Material Design Icons For Using With Bootstrap

10191.4k7](/packages/mervick-material-design-icons)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)
