Search by

nativephp / web-ui

shanerbaner82

EDGE web render target for NativePHP — the same screens as HTML in a browser

Package info

github.com/NativePHP/web-ui

pkg:composer/nativephp/web-ui

Security

Advisories: 0

Aikido package health analysis

Transparency log

Fund package maintenance!

Other

Statistics

Installs: 6

Dependents: 0

Suggesters: 0

Stars: 0

Open Issues: 0

0.1.0 2026-09-12 13:50 UTC

Requires

Requires (Dev)

Suggests

None

Provides

None

Conflicts

None

Replaces

None

MIT 25584f878d52bd58bceb0b1613a59d608867cdd4

  • NativePHP <support.woop@nativephp.com>

webmobilelaraveledgeSSRnativephp

Published on Packagist.org on 2026-09-12 14:43 UTC

This package is auto-updated.

Last update: 2026-09-12 14:44:16 UTC

README

Alpha. APIs and wire format may change between releases.

The EDGE web render target: the same Route::native() screens an app ships to phones, rendered as HTML in a browser from the identical Blade source.

How it plugs in

Core (nativephp/mobile) knows only the Native\Mobile\Edge\Contracts\WebRunner contract: a browser GET on a native route resolves it from the container (404 when unbound). This package's WebServiceProvider (Laravel auto-discovered) binds it and registers the web routes. On device (NATIVEPHP_RUNNING) the provider self-disables — installing this package changes nothing about the native app.

Layout

  • src/Renderer/ — tree → HTML (WebRenderer, WebTheme, HtmlRendererRegistry for plugin-owned element renderings). Never imports Protocol or Bridge (arch-tested in core's suite), so a future desktop shell can reuse it with its own transport.
  • src/Protocol/ — the stateless Livewire-style machinery: sealed HMAC snapshots, APP_KEY-hashed endpoints, uploads, the page shell.
  • src/Bridge/ — WebBridge + driver registry: PHP drivers or queued client effects standing in for device APIs.
  • src/Console/ — edge:css build-time Tailwind compilation, edge:watch live updates for browsers (see docs/live-updates.md).
  • src/Replay/ — time-travel viewer for recorded tree sessions (TreeRecorder itself lives in core; devices record too).
  • resources/js/edge-web.js — client runtime: keyed DOM morph, event queue, SPA nav, effects, polls, lazy boot, uploads, virtual-list windowing, overlay focus trap/Escape/scroll-lock, error overlay.

Installing in an app

composer require nativephp/web-ui:dev-main

Requires nativephp/mobile ^4.4. The service provider is auto-discovered; nothing else to register.

Contributors working from a local checkout: add it as a path repository and run composer in the consuming app, never in this repo.

Contributing

See CONTRIBUTING.md. Tests live in the core repo's suite (tests/Feature/Edge/WebUpdateTest.php etc.) via a dev-only autoload of this package's src/.

License

MIT. See LICENSE.