README

Yii Framework

Bootstrap 6

Bootstrap 6 widgets, forms, and asset bundles for Yii2
ESM-only Bootstrap bundle installed through Foxy, plugins loaded without a global

Important

This package pins Bootstrap 6.0.0-alpha.1. Its classes, markup, and plugin options may change before beta. Supported browsers start at Chrome/Edge 130, Firefox 132, and Safari 18.

Features

Quick start

Installation

Select the native manager in the application's root composer.json:

{
  "config": {
    "foxy": {
      "manager": "native"
    }
  }
}

Then install the extension:

composer config allow-plugins.php-forge/foxy true
composer require php-forge/foxy:^0.4 yii2-extensions/bootstrap6:^0.1

Foxy's native manager installs the frontend assets with PHP and ext-zlib; Node.js is unnecessary. Configure it in the application's root composer.json before requiring the extension. Its default install directory is node_modules. Point @npm to that actual directory; use @app/node_modules only when the application base path is the Composer project root. For Yii2 2.0.x, native installation into vendor/npm matches its default alias. See installation for the complete configuration and optional package managers.

Basic usage

Place this in a Yii view. The button opens a native dialog with a title, content, and a working close action:

use yii2\extensions\bootstrap6\{Dialog, Html};
use yii2\extensions\bootstrap6\enum\DialogSize;

Dialog::begin(
    [
        'title' => 'Welcome to your next project',
        'size' => DialogSize::LG,
        'toggleButton' => ['label' => 'Preview welcome'],
        'footer' => Html::button(
            'Start exploring',
            [
                'class' => 'btn-solid theme-primary',
                'data' => ['bs-dismiss' => 'dialog'],
            ]
        ),
    ],
);

echo '<p class="fs-5">Build clear interfaces with <strong>Yii2 and Bootstrap 6</strong>.</p>';

Dialog::end();

Widgets load their CSS and JavaScript on demand. The JavaScript bundle uses type="module" and exposes no window.bootstrap by default; use the registered bundle's importJs() helper for custom plugin code. Titles and labels are encoded by default, while body and footer content require encoding when they contain user data.

Documentation

Practical guides and complete examples, with API details generated from PHPDoc.

📚 Installation Guide: packages, aliases, assets, and CDN delivery.
⚙️ Configuration Guide: practical choices for plugins, items, forms, and icons.
💡 Usage Examples: widget gallery and complete view recipes.
🔄 Migration from Bootstrap 5
🧪 Testing Guide
📖 Generated API Reference

AI assistance

AI agents: read https://yii2-framework.github.io/docs/llms.txt, the index of the documentation site, and fetch the Markdown version of a page by appending index.md to its URL, for example https://yii2-framework.github.io/docs/extensions/bootstrap6/installation/index.md. For the Yii conventions this package builds on, install the yii2-framework agent skill with npx skills add yii2-framework/docs --skill yii2-framework.