PHPackages                             forme/crosswise - 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. forme/crosswise

ActiveLibrary

forme/crosswise
===============

v1.0.0(3y ago)02.2kMITPHP

Since Jan 16Pushed 1y ago1 watchersCompare

[ Source](https://github.com/formewp/forme-crosswise)[ Packagist](https://packagist.org/packages/forme/crosswise)[ RSS](/packages/forme-crosswise/feed)WikiDiscussions main Synced 1mo ago

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

Forme Crosswise
===============

[](#forme-crosswise)

Adds End To End helper routes to a [Forme Framework](https://github.com/formewp/forme-framework) project.

Overview
--------

[](#overview)

Crosswise provides a set of protected endpoints that are only available in testing environments. These endpoints help facilitate common testing operations like user creation, database migrations, and running arbitrary PHP code from your front end during end to end tests.

Crosswise is inspired by and derived from [laracasts/cypress](https://github.com/laracasts/cypress).

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

[](#installation)

```
composer require forme/crosswise --dev
```

Available Endpoints
-------------------

[](#available-endpoints)

All endpoints are prefixed with `/__e2e__` and are only accessible when `WP_ENV=testing`.

### Create (`POST /__e2e__/create`)

[](#create-post-__e2e__create)

Creates a new model instance with the given attributes.

```
{
    "model": "App\\Models\\Post",
    "attributes": {
        "title": "Test Post",
        "content": "Test Content"
    }
}
```

### Login (`POST /__e2e__/login`)

[](#login-post-__e2e__login)

Creates and/or logs in a user. Returns the user object.

```
{
    "id": 1,              // optional - specific user ID
    "role": "subscriber"  // optional - defaults to "subscriber"
}
```

### Current User (`GET /__e2e__/current-user`)

[](#current-user-get-__e2e__current-user)

Returns the currently logged-in user.

### Migrate (`GET /__e2e__/migrate`)

[](#migrate-get-__e2e__migrate)

Runs all pending database migrations.

### Rollback (`GET /__e2e__/rollback`)

[](#rollback-get-__e2e__rollback)

Rolls back all database migrations.

### Run PHP (`POST /__e2e__/run-php`)

[](#run-php-post-__e2e__run-php)

Executes arbitrary PHP code and returns the result.

```
{
    "command": "App\\Models\\Post::count()"
}
```

Security
--------

[](#security)

All endpoints are protected by Forme's `TestOnlyMiddleware` which ensures they can only be accessed when `WP_ENV=testing`. The Rollback endpoint has an additional redundant check to make double sure of this.

It goes without saying that you should *never* install or enable Crosswise in production environments.

Usage Examples
--------------

[](#usage-examples)

```
// basic usage
await axios.post('/__e2e__/login', {
    role: 'administrator'
});

await axios.post('/__e2e__/create', {
    model: 'App\\Models\\Post',
    attributes: {
        title: 'Test Post',
        status: 'publish'
    }
});
```

```
// Cypress command example
/**
 * create a model instance
 *
 * @example cy.create('App\\Models\\Post', { title: 'Test Post', status: 'publish'});
 */
Cypress.Commands.add('create', (model: string, attributes: { [key: string]: any } = {}) => {
    let requestBody = { model, attributes };
    return cy.request({
        method: 'POST',
        url: '/__e2e__/create',
        body: { ...requestBody },
        log: false,
    }).
        then(({ body }) => {
            Cypress.log({
                name: 'create',
                message: model + ' created successfully',
                consoleProps: () => ({ result: body }),
            });
        }).
        its('body', { log: false });
});

// then use it in your tests
cy.create('App\\Models\\Post', { title: 'Test Post', status: 'publish' });
```

License
-------

[](#license)

The MIT License (MIT). Please see [License File](LICENSE.md) for more information.

```

```

###  Health Score

28

—

LowBetter than 54% of packages

Maintenance33

Infrequent updates — may be unmaintained

Popularity15

Limited adoption so far

Community7

Small or concentrated contributor base

Maturity47

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

Total

2

Last Release

1160d ago

Major Versions

v0.1.0 → v1.0.02023-03-13

### Community

Maintainers

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

---

Top Contributors

[![moussaclarke](https://avatars.githubusercontent.com/u/13017858?v=4)](https://github.com/moussaclarke "moussaclarke (5 commits)")

###  Code Quality

Static AnalysisPHPStan

Type Coverage Yes

### Embed Badge

![Health badge](/badges/forme-crosswise/health.svg)

```
[![Health](https://phpackages.com/badges/forme-crosswise/health.svg)](https://phpackages.com/packages/forme-crosswise)
```

PHPackages © 2026

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