prolaxu/flutter-php

Build Flutter mobile UIs from PHP. Define screens, components, routes, and stores in PHP — a Flutter renderer turns the JSON manifest into a native app.

v1.0.0 2026-06-12 22:01 UTC

Requires

• php: ^8.2
• laravel/framework: ^10.0 || ^11.0 || ^12.0 || ^13.0

Requires (Dev)

• laravel/pint: ^1.0
• phpunit/phpunit: ^10.0 || ^11.0 || ^12.0

MIT

• Laxman Adhikari

• php
• json
• mobile
• declarative
• ui-builder
• flutter

README

Build Flutter mobile UIs entirely from PHP. Your app lives in app/MobileUI/ — you never touch Flutter except to build and publish. Paired with Flutter Kit renderer.

How it works

PHP (app/MobileUI/) → JSON manifest → Flutter renderer → Native app

You define screens, components, routes, stores, and theme in PHP classes. A CLI command generates app_structure.json. The Flutter renderer parses this JSON and renders the entire app at runtime — no Flutter code needed per project.

Installation

composer require prolaxu/flutter-php

The service provider auto-registers via Laravel package discovery.

Pair with Flutter Kit — the JSON-driven Flutter renderer.

Quick start

php artisan flutter-php:init-app MyApp
php artisan flutter-php:generate-structure

Serve at GET /api/app-structure. Point your Flutter Kit at this URL.

Structure

app/MobileUI/
├── AppStructure.php        # Manifest definition
├── Components/             # Reusable UI components (ProductCard, etc.)
├── Screens/                # Screen definitions
├── Stores/                 # Reactive state stores
└── Theme/                  # App theme

packages/flutter-php/src/UIBuilder/
├── Components/             # 33 built-in components (Scaffold, Row, RemoteList, etc.)
├── Actions/                # 20+ action types (navigate, apiCall, setStoreValue, etc.)
├── Structure/              # App manifest structure (routes, environment, etc.)
├── State/                  # Store references and state bindings
├── Primitives/             # Text, TextStyle, Color, Padding, etc.
└── Base/                   # UIComponent base class

Defining a screen

class HomeScreen
{
    public static function build(): UIComponent
    {
        return new Scaffold(
            title: new Text('My App'),
            body: new Column(
                children: [
                    new TextComponent(new Text('Hello from PHP!')),
                ],
            ),
        );
    }
}

License

MIT