PHPackages                             monooso/craft-bolt - 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. [Testing & Quality](/categories/testing)
4. /
5. monooso/craft-bolt

AbandonedArchivedLibrary[Testing & Quality](/categories/testing)

monooso/craft-bolt
==================

Speed up your Craft plugin tests.

v0.1.1(5y ago)1177MITPHPPHP ^7.2|^8.0

Since Dec 30Pushed 5y ago1 watchersCompare

[ Source](https://github.com/monooso/craft-bolt)[ Packagist](https://packagist.org/packages/monooso/craft-bolt)[ Docs](https://github.com/monooso/craft-bolt)[ RSS](/packages/monooso-craft-bolt/feed)WikiDiscussions main Synced 1w ago

READMEChangelogDependencies (2)Versions (3)Used By (0)

Bolt
====

[](#bolt)

 [![Latest Stable Version](https://camo.githubusercontent.com/ef9866fbf4a5bdd0ff242dabb5a63c9987133a8ad0dd0fac42f2fbd1d8eeaee1/68747470733a2f2f706f7365722e707567782e6f72672f6d6f6e6f6f736f2f63726166742d626f6c742f762f737461626c652e737667)](https://packagist.org/packages/monooso/craft-bolt) [![License](https://camo.githubusercontent.com/4aa2450952a0d50dd5f755553747c685ef45af515b79a4779878cb47ad632e68/68747470733a2f2f706f7365722e707567782e6f72672f6d6f6e6f6f736f2f63726166742d626f6c742f6c6963656e73652e737667)](https://packagist.org/packages/monooso/craft-bolt)

About Bolt
----------

[](#about-bolt)

Bolt speeds up your Craft plugin tests. It's opinionated, and a work-in-progress. You probably shouldn't use it.

Bolt consists of two parts:

1. A Codeception module, which is a thin wrapper around the official `craft\test\Craft` module.
2. A Codeception extension, which loads a SQL dump of your choosing.

The extension relies on the module. You can use the module without the extension, but there's no reason to do so.

Requirements
------------

[](#requirements)

Bolt assumes that you're using Codeception 4. It has been tested with Craft 3.5 and PHP 7.4.

Installation
------------

[](#installation)

Install Bolt using [Composer](https://getcomposer.org/), as a development dependency:

```
composer require --dev monooso/craft-bolt
```

Configuration
-------------

[](#configuration)

### 1. Replace the Craft Codeception module

[](#1-replace-the-craft-codeception-module)

The Bolt Codeception module is a drop-in replacement for the Craft Codeception module. To use it, simply replace any references to `\craft\test\Craft` in your Codeception configuration files with `\Monooso\Bolt\BoltModule`.

For example:

```
modules:
    config:
        \Monooso\Bolt\BoltModule:
            configFile: "tests/_craft/config/test.php"
            # Other config...
```

Don't forget to update your `*.suite.yml` files as well.

### Step 2: Disable the database setup

[](#step-2-disable-the-database-setup)

The Bolt extension is responsible for loading a SQL dump, which means we don't need the Craft module to set up the database. Set the configuration options accordingly:

```
modules:
    config:
        \Monooso\Bolt\BoltModule:
            cleanup: true
            transaction: true
            dbSetup: { clean: false, setupCraft: false }
            fullMock: false
            # Other config...
```

### Step 3: Enable and configure the extension

[](#step-3-enable-and-configure-the-extension)

The extension requires a single configuration setting, specifying the SQL dump(s) to load.

For the sake of convenience, Bolt includes a SQL dump of a vanilla Craft 3.5 site. Use it as follows:

```
extensions:
    enabled:
        - \Monooso\Bolt\BoltExtension
    config:
        \Monooso\Bolt\BoltExtension:
            dump: "bolt:3.5"
```

You can also choose to load your own SQL dump, by specifying a path relative to the project root:

```
extensions:
    enabled:
        - \Monooso\Bolt\BoltExtension
    config:
        \Monooso\Bolt\BoltExtension:
            dump: "tests/_data/dump.sql"
```

Finally, you can specify multiple dump files, which will be loaded in the order specified. For example:

```
extensions:
    enabled:
        - \Monooso\Bolt\BoltExtension
    config:
        \Monooso\Bolt\BoltExtension:
            dump:
                - "bolt:3.5"
                - "tests/_data/extras.sql"
```

###  Health Score

24

—

LowBetter than 32% of packages

Maintenance20

Infrequent updates — may be unmaintained

Popularity12

Limited adoption so far

Community7

Small or concentrated contributor base

Maturity49

Maturing project, gaining track record

 Bus Factor1

Top contributor holds 100% of commits — single point of failure

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 ~41 days

Total

2

Last Release

1923d ago

PHP version history (2 changes)v0.1.0PHP ^7.2

v0.1.1PHP ^7.2|^8.0

### Community

Maintainers

![](https://avatars.githubusercontent.com/u/4369838?v=4)[Stephen Lewis](/maintainers/monooso)[@monooso](https://github.com/monooso)

---

Top Contributors

[![monooso](https://avatars.githubusercontent.com/u/4369838?v=4)](https://github.com/monooso "monooso (10 commits)")

---

Tags

testingcraftcms

### Embed Badge

![Health badge](/badges/monooso-craft-bolt/health.svg)

```
[![Health](https://phpackages.com/badges/monooso-craft-bolt/health.svg)](https://phpackages.com/packages/monooso-craft-bolt)
```

###  Alternatives

[phpunit/phpunit

The PHP Unit Testing framework.

20.0k910.7M134.8k](/packages/phpunit-phpunit)[phpunit/php-code-coverage

Library that provides collection, processing, and rendering functionality for PHP code coverage information.

8.9k892.4M1.5k](/packages/phpunit-php-code-coverage)[mockery/mockery

Mockery is a simple yet flexible PHP mock object framework

10.7k497.0M23.6k](/packages/mockery-mockery)[behat/behat

Scenario-oriented BDD framework for PHP

4.0k96.8M2.0k](/packages/behat-behat)[symfony/phpunit-bridge

Provides utilities for PHPUnit, especially user deprecation notices management

2.5k201.2M4.2k](/packages/symfony-phpunit-bridge)[brianium/paratest

Parallel testing for PHP

2.5k118.8M754](/packages/brianium-paratest)

PHPackages © 2026

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