nativephp-v3-to-v4-upgrade

Migrates NativePHP Mobile v3 Livewire apps to v4 native SuperNative EDGE UI.

1|Updated Aug 4, 2026
One-click install
npx skills add https://github.com/LaravelDaily/nativephp-larapackagehunt --skill nativephp-v3-to-v4-upgrade-laraveldaily
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: nativephp-v3-to-v4-upgrade
Source: https://github.com/LaravelDaily/nativephp-larapackagehunt/tree/main/.agents/skills/nativephp-v3-to-v4-upgrade
Command: npx skills add https://github.com/LaravelDaily/nativephp-larapackagehunt --skill nativephp-v3-to-v4-upgrade-laraveldaily

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Upgrading a NativePHP Mobile app from v3 (Livewire/Volt/Flux in a web view) to v4 native EDGE UI involves undocumented package renames, silent rendering failures, font and theme-push timing bugs, and layout traps that render nothing without errors. This Skill provides a phased, battle-tested migration path covering composer moves, plugin registration, screen conversion, testing, and cutover. ## Core Features & Use Cases - Package and plugin migration: Handles the nativephp/native-ui to nativephp/mobile-ui rename, composer vcs repository ordering, inline branch aliases, plugin registration, and safe Livewire package removal ordering. - Silent-failure diagnosis: Documents the layout traps that render nothing (empty columns, anchored absolute children, zero-inset edge pinning, aspect-ratio placement, dropped Tailwind classes) and the theme-push timing bug that leaves fonts as system defaults. - Phased conversion workflow: Provides a five-phase plan from setup through screen inventory, scaffolding, partials, parallel screen conversion, and cutover, with Livewire-to-EDGE translation rules and a native testing strategy. - Use Case: A team with a v3 NativePHP app of 18 screens and 21 Livewire components uses this Skill to convert every screen to native EDGE UI, port all tests to the Native testing harness, and cut over with 700+ passing tests. ## Quick Start Upgrade my NativePHP mobile app from v3 to v4 native EDGE UI, starting with the composer package moves and plugin registration.

Frequently Asked Questions about nativephp-v3-to-v4-upgrade

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I upgrade NativePHP mobile from v3 to v4?

Follow the phased plan: move composer packages from nativephp/native-ui to nativephp/mobile-ui with a vcs repository and inline branch alias, register the plugin with native:plugin:register, then scaffold layouts and routes before converting screens one by one. Strip Livewire providers before running composer remove to avoid fatal errors during package discovery.

Why is my NativePHP v4 custom font not working?

Fonts not working usually means the theme push fired before the bridge was reachable, so the native side keeps its system font and empty alias map. Re-push the theme after the container boots with $this->app->booted(fn () => Theme::pushToNative()), and ensure each font attribute has a matching weight class like font-extrabold.

Why does a native:column render nothing in NativePHP EDGE?

An empty native:column paints nothing because the renderer returns Color.clear when a node has no children, discarding background and size. Use a self-closing native:rect for solid fills or scrims, and remember absolute children are anchored at their measured size rather than stretched by opposing insets.

Where is the native:font artisan command in NativePHP v4?

The native:font command ships in the nativephp/mobile-ui package, not nativephp/mobile. It downloads Google Fonts into resources/fonts, and the plugin's copy_assets build hook bundles them into native projects during native:run.

Which Tailwind classes are unsupported in NativePHP EDGE?

Unsupported classes are silently dropped by TailwindParser, including blur-*, scale-*, per-corner radii like rounded-t-xl, and max-w-*/min-w-*. Verify any class with TailwindParser::parse() returning an empty array before assuming it works; gradients and inset-* are supported.

How do I test NativePHP v4 native screens?

Port legacy Livewire tests to Native\Mobile\Testing\Native::test() or Native::visit() with FakeBridge and Saloon MockClient, covering happy, failure, and offline paths. Note the test harness renders through createElement, a different code path from the device's streaming collector, so verify props on both.