PHPackages                             abrarali14/shard-ui - 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. [Utility &amp; Helpers](/categories/utility)
4. /
5. abrarali14/shard-ui

ActiveLibrary[Utility &amp; Helpers](/categories/utility)

abrarali14/shard-ui
===================

Shard UI – Distributed viewport package for Laravel

1.0.0(6mo ago)00MITBladePHP ^8.2

Since Dec 14Pushed 6mo agoCompare

[ Source](https://github.com/AbrarAli14/ShardUi)[ Packagist](https://packagist.org/packages/abrarali14/shard-ui)[ Docs](https://github.com/AbrarAli14/ShardUi)[ RSS](/packages/abrarali14-shard-ui/feed)WikiDiscussions main Synced today

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

 [![Shard UI Banner](https://raw.githubusercontent.com/AbrarAli14/ShardUi/main/art/hero.png)](https://raw.githubusercontent.com/AbrarAli14/ShardUi/main/art/hero.png)Shard UI
========

[](#shard-ui)

**Distributed Viewports for Laravel**

 [![Packagist](https://camo.githubusercontent.com/a5a4f52903d7f63b2a75dd463f05772a259b6a57b114ccd41c475ca11de2be92/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f762f6162726172616c6931342f73686172642d75692e7376673f6c6162656c3d7061636b616769737426636f6c6f723d346331)](https://packagist.org/packages/abrarali14/shard-ui) [![Downloads](https://camo.githubusercontent.com/825f72e262b863b87b1461e95966403c089f5485e243143aea0892e938681d2b/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f64742f6162726172616c6931342f73686172642d75692e737667)](https://packagist.org/packages/abrarali14/shard-ui) [![PHP](https://camo.githubusercontent.com/a636a2abd54bd2ab79ee39867d382fdd2af8cd254bf10d22d7ad7970b1527f8e/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f7068702d762f6162726172616c6931342f73686172642d75692e7376673f636f6c6f723d626c7565)](#) [![Laravel](https://camo.githubusercontent.com/94cbef1063466f829a05537a0b6a95080d0d8f4fedaaae77f85f4cf3d6f77c73/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f4c61726176656c2d31312b2d666632643230)](#) [![License](https://camo.githubusercontent.com/3d922be6731dec9677511f29fe920801581fac48061502f7b859781688f099cc/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f6c6963656e73652d4d49542d306631373261)](LICENSE)

Stream HTML “shards” to any device in real time. Build collaborative dashboards, remote controls, multi-screen presentations, and biometric-secured workflows without leaving Laravel.

 [Docs](https://github.com/AbrarAli14/ShardUi/wiki) · [Issues](https://github.com/AbrarAli14/ShardUi/issues) · [Releases](https://github.com/AbrarAli14/ShardUi/releases)

---

🧭 What Problem Does It Solve?
-----------------------------

[](#-what-problem-does-it-solve)

ChallengeShard UI Ships WithMulti-device orchestrationSession manager, shard channels, QR authReal-time UI streamingLaravel Reverb events + JS clientProduction-ready demo`/docs` site with API explorer + biometricsHardening &amp; securityWebAuthn fingerprints, rate limits, telemetry---

---

⚙️ Install in Three Steps
-------------------------

[](#️-install-in-three-steps)

```
composer require abrarali14/shard-ui
php artisan vendor:publish --provider="Shard\Ui\ShardServiceProvider"

# Optional helpers
php artisan vendor:publish --tag=shard-ui-controller   # publishes stub BiometricController
php artisan vendor:publish --tag=shard-ui-config
php artisan vendor:publish --tag=shard-ui-views
php artisan vendor:publish --tag=shard-ui-routes
php artisan vendor:publish --tag=shard-ui-assets
```

### Configure `.env`

[](#configure-env)

```
BROADCAST_CONNECTION=reverb
REVERB_APP_ID=your-app-id
REVERB_APP_KEY=your-app-key
REVERB_APP_SECRET=your-app-secret
REVERB_HOST=localhost
REVERB_PORT=8080
REVERB_SCHEME=http

VITE_REVERB_APP_KEY=${REVERB_APP_KEY}
VITE_REVERB_ENCRYPTED=false

SHARD_UI_REQUIRE_AUTH=false
SHARD_UI_ALLOW_ANONYMOUS=true
SHARD_UI_ENABLE_DEMO=true

# Rate limits
SHARD_UI_SESSION_MAX_ATTEMPTS=20
SHARD_UI_SESSION_DECAY_MINUTES=1
SHARD_UI_CONNECT_MAX_ATTEMPTS=60
SHARD_UI_CONNECT_DECAY_MINUTES=1

# Biometric security
BIOMETRIC_RATE_LIMIT_ATTEMPTS=10
BIOMETRIC_RATE_LIMIT_DECAY=1
BIOMETRIC_MAX_ATTEMPTS=5
BIOMETRIC_LOCKOUT_MINUTES=30
BIOMETRIC_SECURITY_ALERTS=true
BIOMETRIC_MAX_DEVICES_PER_USER=5
```

---

🚀 Quick Start (Blade + API)
---------------------------

[](#-quick-start-blade--api)

```
{{-- resources/views/dashboard.blade.php --}}

        Remote Controls

            Activate System

```

```
use Shard\Ui\Support\Concerns\InteractsWithShard;

final class DashboardController extends Controller
{
    use InteractsWithShard;

    public function __invoke()
    {
        $sessionId = $this->startShardSession();
        $this->pushShardContent($sessionId, 'controls', view('remote-controls')->render());

        return view('dashboard', compact('sessionId'));
    }
}
```

```
// API usage
$token = auth()->user()->createToken('dashboard')->plainTextToken;
$session = Http::withToken($token)->post('/api/shard/sessions')['data']['id']

Http::withToken($token)->post("/api/shard/sessions/{$session}/shards", [
    'shard_name' => 'notifications',
    'html' => 'System updated!',
]);
```

---

🔐 WebAuthn Fingerprint Suite
----------------------------

[](#-webauthn-fingerprint-suite)

- `php artisan shard-ui:install-biometric` – scaffolds tables &amp; configs.
- Rate limiting, lockouts, anomaly detection, IP/user-agent heuristics.
- Analytics dashboard with success rates, alerts, device breakdowns.
- Endpoints:

```
POST /api/biometric/fingerprint/register
POST /api/biometric/fingerprint/authenticate
POST /api/biometric/fingerprint/verify
GET  /api/biometric/fingerprint/credentials
```

---

🧱 Architecture Snapshot
-----------------------

[](#-architecture-snapshot)

```
[Blade/Alpine UI]  [Reverb]  [Shard Manager]
                                      ↓
                                [Sanctum / Policies]
                                      ↓
                              [Biometric Services]

```

Key pieces:

- **ShardManager** – session lifecycle, shard payload cache, telemetry hooks.
- **ShardApiController** – REST endpoints for sessions &amp; shards.
- **Events** – `ShardSessionStarted`, `ShardHtmlPushed`, `ShardSessionEnded`.
- **Docs/Analytics** – Live metrics, security alerts, device charts.

---

📡 REST Primer
-------------

[](#-rest-primer)

```
POST   /api/shard/sessions                     # start session
GET    /api/shard/sessions                     # list sessions
POST   /api/shard/sessions/{id}/shards         # push HTML payload
GET    /api/shard/sessions/{id}/shards/{name}  # fetch shard
DELETE /api/shard/sessions/{id}                # close session
```

🔐 When `SHARD_UI_REQUIRE_AUTH=true`, attach a Sanctum token to every request.

---

🧪 Testing Checklist
-------------------

[](#-testing-checklist)

```
./vendor/bin/pest tests/Feature
./vendor/bin/pest tests/Unit
./vendor/bin/pest --coverage
```

- Sessions create/destroy without leaking payloads.
- Biometric register → verify → audit log.
- Rate limits trigger lockouts gracefully.

---

🧰 Configuration Cheat Sheet
---------------------------

[](#-configuration-cheat-sheet)

FilePurpose`config/shard-ui.php`Channel names, TTL, telemetry, rate limits.`config/shard-ui-biometric.php`Fingerprint policies, alerting, device caps.`.env`Reverb/Sanctum toggles, anonymous vs authenticated mode.---

🗺️ Roadmap
----------

[](#️-roadmap)

- Native mobile companion app (React Native / Flutter).
- Dedicated analytics exporter (Prometheus-friendly).
- Filament/Nova widgets for shard control.
- Multi-tenant session isolation helpers.

Contributions welcome—open an issue to discuss ideas!

---

🤝 Contributing &amp; Support
----------------------------

[](#-contributing--support)

1. Fork → branch → code → tests → PR.
2. Follow PSR-12 + Laravel styling.
3. Document new features in `/docs` and `README`.

Need help?

- 📖 [Docs Wiki](https://github.com/AbrarAli14/ShardUi/wiki)
- 🐛 [Issues](https://github.com/AbrarAli14/ShardUi/issues)
- 📧

---

**Built by [Abrar Ali](https://github.com/AbrarAli14) for the Laravel community.**

###  Health Score

32

—

LowBetter than 69% of packages

Maintenance66

Regular maintenance activity

Popularity0

Limited adoption so far

Community6

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

Unknown

Total

1

Last Release

201d ago

### Community

Maintainers

![](https://avatars.githubusercontent.com/u/85456270?v=4)[AbrarAliMussa](/maintainers/AbrarAliMussa)[@abraralimussa](https://github.com/abraralimussa)

---

Top Contributors

[![AbrarAli14](https://avatars.githubusercontent.com/u/70935986?v=4)](https://github.com/AbrarAli14 "AbrarAli14 (3 commits)")

###  Code Quality

TestsPest

### Embed Badge

![Health badge](/badges/abrarali14-shard-ui/health.svg)

```
[![Health](https://phpackages.com/badges/abrarali14-shard-ui/health.svg)](https://phpackages.com/packages/abrarali14-shard-ui)
```

###  Alternatives

[psalm/plugin-laravel

Psalm plugin for Laravel

3355.3M346](/packages/psalm-plugin-laravel)[laravel/pulse

Laravel Pulse is a real-time application performance monitoring tool and dashboard for your Laravel application.

1.7k15.1M132](/packages/laravel-pulse)[pressbooks/pressbooks

Pressbooks is an open source book publishing tool built on a WordPress multisite platform. Pressbooks outputs books in multiple formats, including PDF, EPUB, web, and a variety of XML flavours, using a theming/templating system, driven by CSS.

45444.2k1](/packages/pressbooks-pressbooks)[roots/acorn

Framework for Roots WordPress projects built with Laravel components.

9762.4M131](/packages/roots-acorn)[moonshine/moonshine

Laravel administration panel

1.3k253.1k81](/packages/moonshine-moonshine)[flarum/core

Delightfully simple forum software.

201.4M2.3k](/packages/flarum-core)

PHPackages © 2026

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