README.md

UI Suite Bootstrap

A site-builder friendly Bootstrap theme for Drupal 8 and 9, using the UI Suite.

Use Bootstrap directly from Drupal backoffice (layout builder, manage display, views, blocks, flags...).

How it works

Components chapter implemented with UI Patterns

Each component is a folder in templates/pattern/.

You can browse the pattern libraries directly inside Drupal: /patterns; for example, the 'card' pattern is available here: /patterns/card.

Thanks to the ui_patterns ecosystem, patterns are automatically available directly for site building in many Drupal entities, as layout plugins, views row plugins, field formatter plugins, views styles plugins...

Utilities chapter implemented with UI Styles

Utilities are implemented as styles in ui_suite_bootstrap.ui_styles.yml

You can browse the styles libraries directly inside Drupal: /styles.

The styles are automatically available for site building inside layout builder's components (blocks) & sections (layouts).

Layouts chapter implemented with Layout Options

A simple grid_row component is already set as a pattern for simple use cases.

For more complex use cases, layouts are implemented in ui_suite_bootstrap.layout.yml and ui_suite_bootstrap.layout_options.yml

Those layouts are automatically available as configurable layout plugins.

Examples section implemented with UI Examples

4 example pages are integrated using only render arrays, inside ui_suite_bootstrap.ui_examples.yml:

• album
• pricing
• carousel

You can browse the example pages directly inside Drupal: /examples

Installation

$ composer require 'drupal/ui_suite_bootstrap:4.x'

Manual installation

By default, the theme use https://www.bootstrapcdn.com/

If you prefer a local instalaltion, you need to override the libraries and place the Bootstrap library in the libraries folder:

{
  "require": {
    "asset/bootstrap": "4.6.1",
    "composer/installers": "2.*"
  },
  "repositories": {
    "asset-bootstrap": {
      "type": "package",
      "package": {
        "name": "asset/bootstrap",
        "version": "4.6.1",
        "type": "drupal-library",
        "extra": {
          "installer-name": "bootstrap"
        },
        "dist": {
          "type": "zip",
          "url": "https://api.github.com/repos/twbs/bootstrap/zipball/043a03c95a2ad6738f85b65e53b9dbdfb03b8d10",
          "reference": "043a03c95a2ad6738f85b65e53b9dbdfb03b8d10"
        }
      }
    }
  },
  "extra": {
    "installer-paths": {
      "web/libraries/{$name}": [
        "type:drupal-library"
      ]
    }
  }
}

If you are using Asset Packagist, the composer.json can be like:

{
  "require": {
    "asset/bootstrap": "4.6.1",
    "composer/installers": "2.*",
    "oomphinc/composer-installers-extender": "2.*"
  },
  "repositories": {
    "asset-packagist": {
      "type": "composer",
      "url": "https://asset-packagist.org"
    }
  },
  "extra": {
    "installer-paths": {
      "app/libraries/{$name}": [
        "type:drupal-library",
        "type:bower-asset",
        "type:npm-asset"
      ]

    },
    "installer-types": [
      "bower-asset",
      "npm-asset"
    ]
  }
}

Demo

See ui_suite_bootstrap_demo installation profile.