PHPackages                             elitedevsquad/sidecar-laravel - 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. [Framework](/categories/framework)
4. /
5. elitedevsquad/sidecar-laravel

ActiveLibrary[Framework](/categories/framework)

elitedevsquad/sidecar-laravel
=============================

v3.0.2(1mo ago)759.1k↓27.6%MITPHPPHP ^8.2CI passing

Since Sep 5Pushed 1w ago1 watchersCompare

[ Source](https://github.com/elitedevsquad/sidecar-laravel)[ Packagist](https://packagist.org/packages/elitedevsquad/sidecar-laravel)[ RSS](/packages/elitedevsquad-sidecar-laravel/feed)WikiDiscussions 3.x Synced 2d ago

READMEChangelog (10)Dependencies (35)Versions (35)Used By (0)

DevSquad Sidecar
================

[](#devsquad-sidecar)

A Laravel library that lets developers and QA test Laravel apps directly from the browser — run Tinker code, artisan commands, manipulate the fake clock, and impersonate users.

**Requirements:** PHP `^8.2`, Laravel `^11`

---

Install
-------

[](#install)

Run from inside your Laravel project root:

```
bash
```

---

User Mapping
------------

[](#user-mapping)

In `AppServiceProvider.php`, configure Sidecar inside a `class_exists()` guard so the app does not break when the package is absent (e.g. production with `--no-dev`):

```
public function boot(): void
{
    if (class_exists(\EliteDevSquad\SidecarLaravel\Sidecar::class)) {
        \EliteDevSquad\SidecarLaravel\Sidecar::$userMap = [
            'id'    => 'id',
            'name'  => 'first_name',
            'role'  => 'role.name',
            'email' => 'email',
        ];

        \EliteDevSquad\SidecarLaravel\Sidecar::$userBuilder = \App\Models\User::with('role');
    }
}
```

---

Environment Variables
---------------------

[](#environment-variables)

The install script writes these automatically. Reference for manual setup or code review:

```
# DevSquad Sidecar
DS_SIDECAR_ENABLED=true
VITE_DS_SIDECAR_ENABLED="${DS_SIDECAR_ENABLED}"
DS_SIDECAR_TINKER_ENABLED=true
DS_SIDECAR_TINKER_USE_BATCH=true
DS_SIDECAR_COMMANDS_ENABLED=true
DS_SIDECAR_FAKE_CLOCK_ENABLED=true
DS_SIDECAR_ALLOWED_IPS="127.0.0.1"
DS_SIDECAR_BRANCH_URL=https://github.com/your-org/your-repo/tree/
DS_SIDECAR_LINK_MAIL=http://localhost:8025
DS_SIDECAR_LINK_ENVOYER=""
```

**`DS_SIDECAR_ALLOWED_IPS`** supports exact IPs, CIDR ranges, and prefix matching:

```
DS_SIDECAR_ALLOWED_IPS="127.0.0.1,192.168.1.0/24,10.0.0"
```

**`HEADER_BRANCH_NAME`** — on servers without git (e.g. Envoyer), inject via release hook:

```
cd {{ release }}
sed -i '/HEADER_BRANCH_NAME/d' .env
echo HEADER_BRANCH_NAME="{{ branch }}" >> .env
```

---

Frontend
--------

[](#frontend)

**Laravel apps (auto-inject enabled):** no action needed. The Sidecar JS is injected automatically before `` on every non-production HTML response.

**Laravel apps with Vite (auto-inject disabled):** if you set `DS_SIDECAR_AUTO_INJECT_ASSETS=false` in your `.env`, load Sidecar manually in your JavaScript entry point:

```
touch resources/js/devsquad-sidecar.js
```

```
// resources/js/devsquad-sidecar.js
import { Sidecar } from "../../vendor/elitedevsquad/sidecar-laravel/resources/js/index.js";

if (import.meta.env.VITE_DS_SIDECAR_ENABLED === "true") {
    document.addEventListener("DOMContentLoaded", () => new Sidecar());
}
```

```
// resources/js/app.js
import "./devsquad-sidecar";
```

Then build your assets:

```
npm run build
```

**External apps (Next.js, Nuxt, etc.):** the bundle is served by the Laravel route `GET /__devsquad-sidecar/assets/js` and reads `window.__sidecarBaseUrl` at runtime to prefix all API calls.

```
// e.g. pages/_app.js, app/layout.js, plugins/sidecar.js
if (process.env.NODE_ENV !== 'production') {
    window.__sidecarBaseUrl = process.env.NEXT_PUBLIC_APP_URL ?? 'https://your-laravel-app.com';
    const s = document.createElement('script');
    s.src = window.__sidecarBaseUrl + '/__devsquad-sidecar/assets/js';
    s.defer = true;
    document.head.appendChild(s);
}
```

###  Health Score

54

—

FairBetter than 96% of packages

Maintenance96

Actively maintained with recent releases

Popularity36

Limited adoption so far

Community11

Small or concentrated contributor base

Maturity60

Established project with proven stability

 Bus Factor1

Top contributor holds 93.8% 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 ~11 days

Total

26

Last Release

10d ago

Major Versions

v1.3.0 → v2.0.02026-02-04

2.x-dev → v3.0.02026-05-30

### Community

Maintainers

![](https://www.gravatar.com/avatar/737d15503c2277f2e6f023c1ddb827b2524e7e23dde1f97310cf3bc4a2aba02e?d=identicon)[teamdevsquad](/maintainers/teamdevsquad)

---

Top Contributors

[![devsquad-luan-freitas](https://avatars.githubusercontent.com/u/83706873?v=4)](https://github.com/devsquad-luan-freitas "devsquad-luan-freitas (151 commits)")[![Copilot](https://avatars.githubusercontent.com/in/1143301?v=4)](https://github.com/Copilot "Copilot (4 commits)")[![teamdevsquad](https://avatars.githubusercontent.com/u/33907040?v=4)](https://github.com/teamdevsquad "teamdevsquad (4 commits)")[![r2luna](https://avatars.githubusercontent.com/u/23129218?v=4)](https://github.com/r2luna "r2luna (2 commits)")

###  Code Quality

TestsPest

Static AnalysisPHPStan

Code StyleLaravel Pint

### Embed Badge

![Health badge](/badges/elitedevsquad-sidecar-laravel/health.svg)

```
[![Health](https://phpackages.com/badges/elitedevsquad-sidecar-laravel/health.svg)](https://phpackages.com/packages/elitedevsquad-sidecar-laravel)
```

###  Alternatives

[laravel/octane

Supercharge your Laravel application's performance.

4.0k26.6M223](/packages/laravel-octane)[unopim/unopim

UnoPim Laravel PIM

10.5k2.4k](/packages/unopim-unopim)[code16/sharp

Laravel Content Management Framework

79164.7k8](/packages/code16-sharp)[ecotone/laravel

Ecotone for Laravel — CQRS, Event Sourcing, Sagas, Durable Workflows, and Outbox on top of Laravel Queue, via PHP attributes.

21318.6k3](/packages/ecotone-laravel)[codewithdennis/larament

Larament is a time-saving starter kit to quickly launch Laravel 13.x projects. It includes FilamentPHP 5.x pre-installed and configured, along with additional tools and features to streamline your development workflow.

3891.8k](/packages/codewithdennis-larament)[r2luna/brain

Brain: A process-driven architecture alternative for your Laravel Application.

6338.7k1](/packages/r2luna-brain)

PHPackages © 2026

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