ichava/icon-sets-bootstrap

Bootstrap Icons for the Ichava Laravel icon ecosystem: 2,078 SVGs, flat, vendored from bootstrap-icons 1.13.2.

Requires ichava/core ^0.1 on PHP ^8.4.1 || ^8.5 and Laravel ^13.

Install

This pack requires ichava/core and nothing else. Nothing in the Ichava family is on Packagist yet, so the application's composer.json first names the repositories: core's installation guide holds the one block that lists them, core's dependencies included, and this pack's line in it is https://github.com/ichava/icon-sets-bootstrap.

Then require the pack:

composer require ichava/icon-sets-bootstrap

The service provider is discovered automatically. Core's installation guide covers core's own setup.

Quick start guide and usage

Getting started

Seed the pack once after installing it, and again after upgrading it:

php artisan ichava::ichava-core.database seed --package=ichava/icon-sets-bootstrap

The seed is not optional: until it runs the registry holds no rows for this pack and every lookup returns nothing. No configuration is needed; the defaults are merged without publishing anything.

Usage

Icons are addressed as ichava/icon-sets-bootstrap::<name>. In Blade, through core's component:

<x-ichava::icon name="ichava/icon-sets-bootstrap::house" class="w-6 h-6" />

Or from PHP, through core's helper:

{{ ichava('ichava/icon-sets-bootstrap::heart-fill')->class('w-5 h-5') }}

See Getting started for the full walkthrough, and the Documentation index below for everything else.

Documentation

The full documentation lives in this repository, under docs/, and is indexed below.

This pack

• Installation — requirements, the repositories block, seeding
• Getting started — your first icon from this pack
• Configuration — why there is no config file, and the kind keys in config.json
• Architecture — what it ships, what it delegates, and why
• Release — how a version is cut, and how the icons are refreshed
• Variants — the one flat style, and how icons are named
• Customisation — sizing, colour and accessibility
• Attribution — upstream project, licence terms and where the vendored version is recorded

Shared across every pack

• Use an icon pack — addressing icons, in Blade and in PHP
• Seed pack icons — the seeding pipeline and its options
• Check pack updates — the update checker and what its statuses mean
• Serve icons from a CDN — reading this pack's CDN templates out of config.json

Its upstream is bootstrap-icons; run core's check pack updates recipe to see whether a newer release exists.

Contributing & security

See CONTRIBUTING.md. Report vulnerabilities privately through security policy — never in a public issue.

License

The package code is MIT, © Simtabi LLC. See LICENSE.

The icons are Bootstrap Icons, © The Bootstrap Authors, under their own MIT licence. Simtabi LLC claims no authorship of them. Their notice is in ATTRIBUTION.md, which ships with the package and must accompany any copy of the icons.