V2

.github/ISSUE_TEMPLATE/bug.yml

@@ -1,72 +1,72 @@
 name: Bug Report
 description: |
-    Found a bug in NativePHP? You're in the right place!
+  Found a bug in NativePHP for Desktop? You're in the right place!
 labels: ["bug"]
 body:
-    - type: markdown
-      attributes:
-          value: |
-              We're sorry to hear you have a problem.
+  - type: markdown
+    attributes:
+      value: |
+        We're sorry to hear you have a problem.
 
-              Before submitting your report, please make sure you've been through the section "[Debugging](https://nativephp.com/docs/getting-started/debugging)" in the docs.
+        Before submitting your report, please make sure you've been through the section "[Debugging](https://nativephp.com/docs/getting-started/debugging)" in the docs.
 
-              Please also ensure that you have the latest version of NativePHP packages installed, and are using [supported versions](https://nativephp.com/docs/desktop/1/getting-started/support-policy) of PHP and Laravel.
+        Please also ensure that you have the latest version of NativePHP packages installed, and are using [supported versions](https://nativephp.com/docs/desktop/1/getting-started/support-policy) of PHP and Laravel.
 
-              If nothing here has helped you, please provide as much useful context as you can here to help us solve help you.
+        If nothing here has helped you, please provide as much useful context as you can here to help us solve help you.
 
-              Note that reams and reams of logs isn't helpful - please share only relevant errors.
+        Note that reams and reams of logs isn't helpful - please share only relevant errors.
 
-              If possible, please prepare a reproduction repo and link to it in the Notes field.
-    - type: textarea
-      id: what-doing
-      attributes:
-          label: What were you trying to do?
-          description: Some context about what you were trying to achieve
-          placeholder: Trying to build my app for production
-      validations:
-          required: true
+        If possible, please prepare a reproduction repo and link to it in the Notes field.
+  - type: textarea
+    id: what-doing
+    attributes:
+      label: What were you trying to do?
+      description: Some context about what you were trying to achieve
+      placeholder: Trying to build my app for production
+    validations:
+      required: true
 
-    - type: textarea
-      id: what-happened
-      attributes:
-          label: What happened?
-          description: What did you expect to happen?
-          placeholder: I cannot currently do X thing because when I do, it breaks X thing.
-      validations:
-          required: true
+  - type: textarea
+    id: what-happened
+    attributes:
+      label: What happened?
+      description: What did you expect to happen?
+      placeholder: I cannot currently do X thing because when I do, it breaks X thing.
+    validations:
+      required: true
 
-    - type: textarea
-      id: how-to-reproduce
-      attributes:
-          label: How to reproduce the bug
-          description: How did this occur, please add any config values used and provide a set of reliable steps if possible.
-          placeholder: When I do X I see Y.
-      validations:
-          required: true
+  - type: textarea
+    id: how-to-reproduce
+    attributes:
+      label: How to reproduce the bug
+      description: How did this occur, please add any config values used and provide a set of reliable steps if possible.
+      placeholder: When I do X I see Y.
+    validations:
+      required: true
 
-    - type: textarea
-      id: debug
-      attributes:
-          label: Debug Output
-          description: Please provide output from the NativePHP Debug command. This will help us understand your environment and the issue you're facing. (`php artisan native:debug`)
-      validations:
-          required: true
+  - type: textarea
+    id: debug
+    attributes:
+      label: Debug Output
+      description: Please provide output from the NativePHP Debug command. This will help us understand your environment and the issue you're facing. (`php artisan native:debug`)
+    validations:
+      required: true
 
-    - type: dropdown
-      id: operating-systems
-      attributes:
-        label: Which operating systems have you seen this occur on?
-        description: You may select more than one.
-        multiple: true
-        options:
+  - type: dropdown
+    id: operating-systems
+    attributes:
+      label: Which operating systems have you seen this occur on?
+      description: You may select more than one.
+      multiple: true
+      options:
         - macOS
         - Windows
         - Linux
 
-    - type: textarea
-      id: notes
-      attributes:
-          label: Notes
-          description: Use this field to provide any other notes that you feel might be relevant to the issue. Include links to any reproduction repos you've created here.
-      validations:
-          required: false
+  - type: textarea
+    id: notes
+    attributes:
+      label: Notes
+      description: Use this field to provide any other notes that you feel might be relevant to the issue. Include links to any reproduction repos you've created here.
+    validations:
+      required: false

.github/workflows/build-plugin.yml

@@ -0,0 +1,62 @@
+# If it's a pull request, don't build the plugin, just fail if it can't be built
+# If it's a push to main, build the plugin
+
+name: plugin-build
+
+on:
+  push:
+    branches: [ main ]
+  pull_request:
+    branches: [ main ]
+  workflow_dispatch:
+
+jobs:
+  build:
+    runs-on: ubuntu-latest
+
+    permissions:
+      contents: write
+
+    steps:
+      - uses: actions/checkout@v5
+        with:
+          ref: ${{ github.event.pull_request.head.ref }}
+          repository: ${{ github.event.pull_request.head.repo.full_name }}
+
+      - name: Use Node.js
+        uses: actions/setup-node@v5
+        with:
+          node-version: 22.x
+
+      - name: Install dependencies
+        working-directory: ./resources/electron/
+        run: npm install
+
+      - name: Build plugin
+        working-directory: ./resources/electron/
+        run: npm run plugin:build
+
+      - name: Commit changes
+        if: github.event_name == 'pull_request'
+        uses: stefanzweifel/git-auto-commit-action@v6
+        with:
+          commit_message: Build plugin
+
+      - name: Create Pull Request
+        if: github.event_name != 'pull_request'
+        uses: peter-evans/create-pull-request@v7
+        with:
+          commit-message: Build plugin
+          title: 'Auto: Build plugin assets'
+          body: |
+            This PR contains the latest built plugin assets.
+
+            **Build Details:**
+            - Triggered by: ${{ github.actor }}
+            - From commit: [${{ github.sha }}](${{ github.server_url }}/${{ github.repository }}/commit/${{ github.sha }})
+            - Workflow run: [View Run](${{ github.server_url }}/${{ github.repository }}/actions/runs/${{ github.run_id }})
+
+            Automatically generated by the plugin-build workflow.
+          branch: build-plugin-update
+          base: main
+          delete-branch: true

.github/workflows/run-plugin-tests.yml

@@ -0,0 +1,26 @@
+name: plugin-tests
+
+on:
+  push:
+    branches: [main]
+  pull_request:
+    branches: [main]
+
+jobs:
+  test:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v5
+
+      - name: Use Node.js
+        uses: actions/setup-node@v5
+        with:
+          node-version: 22.x
+
+      - name: Install dependencies
+        working-directory: ./resources/electron/
+        run: npm install
+
+      - name: Run tests
+        working-directory: ./resources/electron/
+        run: npm run plugin:test

.github/workflows/run-tests.yml

@@ -1,6 +1,7 @@
 name: run-tests
 
 on:
+  workflow_dispatch:
   push:
     branches: [main]
   pull_request:
@@ -12,7 +13,7 @@ jobs:
     strategy:
       fail-fast: false
       matrix:
-        os: [ubuntu-latest, windows-latest]
+        os: [ubuntu-latest, windows-latest, macos-latest]
         php: [8.4, 8.3]
         laravel: [12.*, 11.*]
         stability: [prefer-lowest, prefer-stable]
@@ -43,8 +44,8 @@ jobs:
       - name: List Installed Dependencies
         run: composer show
 
-#      - name: Debug PhpUnit version
-#        run: composer why phpunit/phpunit -t
+      - name: Show pest version
+        run: vendor/bin/pest --version
 
       - name: Execute tests
         run: vendor/bin/pest

README.md

@@ -1,4 +1,4 @@
-# Laravel wrapper for the NativePHP framework.
+# NativePHP for Desktop
 
 [![Latest Version on Packagist](https://img.shields.io/packagist/v/nativephp/laravel.svg?style=flat-square)](https://packagist.org/packages/nativephp/laravel)
 [![GitHub Tests Action Status](https://img.shields.io/github/actions/workflow/status/nativephp/laravel/run-tests.yml?branch=main&label=tests&style=flat-square)](https://github.com/nativephp/laravel/actions?query=workflow%3Arun-tests+branch%3Amain)

composer.json

@@ -1,9 +1,10 @@
 {
-    "name": "nativephp/laravel",
-    "description": "Laravel wrapper for the NativePHP framework.",
+    "name": "nativephp/desktop",
+    "description": "NativePHP for Desktop",
     "keywords": [
         "nativephp",
         "laravel",
+        "desktop",
         "nativephp-laravel"
     ],
     "homepage": "https://github.com/nativephp/laravel",
@@ -33,8 +34,12 @@
     "require": {
         "php": "^8.3",
         "illuminate/contracts": "^10.0|^11.0|^12.0",
+        "laravel/prompts": "^0.1.1|^0.2|^0.3",
+        "nativephp/php-bin": "^1.0",
         "spatie/laravel-package-tools": "^1.16.4",
-        "symfony/finder": "^6.2|^7.0"
+        "symfony/filesystem": "^6.4|^7.2",
+        "symfony/finder": "^6.2|^7.0",
+        "ext-zip": "*"
     },
     "require-dev": {
         "guzzlehttp/guzzle": "^7.0",
@@ -52,7 +57,8 @@
     },
     "autoload": {
         "psr-4": {
-            "Native\\Laravel\\": "src/"
+            "Native\\Laravel\\": "src/Laravel",
+            "Native\\Electron\\": "src/Electron"
         }
     },
     "autoload-dev": {
@@ -82,7 +88,8 @@
     "extra": {
         "laravel": {
             "providers": [
-              "Native\\Laravel\\NativeServiceProvider"
+              "Native\\Laravel\\NativeServiceProvider",
+              "Native\\Electron\\ElectronServiceProvider"
             ],
             "aliases": {
                 "ChildProcess": "Native\\Laravel\\Facades\\ChildProcess",
@@ -100,7 +107,8 @@
                 "Settings": "Native\\Laravel\\Facades\\Settings",
                 "Shell": "Native\\Laravel\\Facades\\Shell",
                 "System": "Native\\Laravel\\Facades\\System",
-                "Window": "Native\\Laravel\\Facades\\Window"
+                "Window": "Native\\Laravel\\Facades\\Window",
+                "Updater": "Native\\Electron\\Facades\\Updater"
             }
         }
     },

config/nativephp-internal.php

@@ -61,6 +61,42 @@
         'code_signing_account_name' => env('NATIVEPHP_AZURE_CODE_SIGNING_ACCOUNT_NAME'),
     ],
 
+    /**
+     * A list of files and folders that should be removed.
+     */
+    'cleanup_exclude_files' => [
+        // .git and dev directories
+        '.git',
+        'dist',
+        'build',
+        'temp',
+        'extras',
+        'docker',
+        'packages',
+        '**/.github',
+
+        // Potentially containing sensitive info
+        'auth.json', // Composer auth file
+        'database/*.sqlite',
+        'database/*.sqlite-shm',
+        'database/*.sqlite-wal',
+
+        'storage/framework/sessions/*',
+        'storage/framework/testing/*',
+        'storage/framework/cache/*',
+        'storage/framework/views/*',
+        'storage/logs/*',
+        'storage/hot',
+
+        // Only needed for local testing
+        'vendor/nativephp/desktop/resources',
+        'vendor/nativephp/desktop/vendor',
+        'vendor/nativephp/php-bin',
+
+        // Also deleted in PrunesVendorDirectory after fresh composer install
+        'vendor/bin',
+    ],
+
     /**
      * The binary path of PHP for NativePHP to use at build.
      */

phpstan.neon

@@ -18,4 +18,4 @@ parameters:
 
 
     excludePaths:
-        - ./src/NativeServiceProvider.php
+        - ./src/Laravel/NativeServiceProvider.php

resources/electron/.gitignore

@@ -0,0 +1,5 @@
+.idea
+node_modules
+out
+*.log
+!build

resources/electron/build/entitlements.mac.plist

@@ -0,0 +1,12 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
+<plist version="1.0">
+  <dict>
+    <key>com.apple.security.cs.allow-jit</key>
+    <true/>
+    <key>com.apple.security.cs.allow-unsigned-executable-memory</key>
+    <true/>
+    <key>com.apple.security.cs.allow-dyld-environment-variables</key>
+    <true/>
+  </dict>
+</plist>