V1 docs

resources/views/components/alert-v1-announcement.blade.php

@@ -33,7 +33,7 @@ class="hidden size-5 shrink-0 dark:block"
     </div>
 
     {{-- Title --}}
-    <h2 class="font-medium">NativePHP for desktop has finally reached v1!</h2>
+    <h2 class="font-medium">NativePHP for desktop and mobile have reached v1!</h2>
 
     {{-- Dot 1 --}}
     <div

resources/views/docs/mobile/1/digging-deeper/push-notifications.md

@@ -0,0 +1,96 @@
+---
+title: Push Notifications
+order: 400
+---
+
+
+## Overview
+
+NativePHP for Mobile uses [Firebase Cloud Messaging](https://firebase.google.com/docs/cloud-messaging) to send push notifications to your users.
+
+## Setting up your app
+
+Once you create a Firebase account and create a project you will be offered to download a `google-services.json` file.
+
+This file contains the configuration for your app and is used by the Firebase SDK to retrieve tokens for each device using your app.
+
+Simply drag this file into the root of your Laravel project, enable `push_notifications` in the [config](/docs/mobile/1/getting-started/configuration) it will be used automatically.
+
+You will see more instructions on how to configure your app in the Firebase documentation, you can ignore all of those, NativePHP handles all of that for you.
+
+## Receiving Push Tokens
+
+To receive push notifications, you must register a listener for the event. For example,
+take a look at how easy it is to listen for a `TokenGenerated` event in Livewire:
+
+```php
+use Livewire\Attributes\On;
+use Livewire\Component;
+use Native\Mobile\Facades\System;
+use Native\Mobile\Events\PushNotification\TokenGenerated;
+
+class PushNotifications extends Component
+{
+    public function render()
+    {
+        return view('livewire.system.push-notifications');
+    }
+
+    #[On('native:' . TokenGenerated::class)]
+    public function handlePushNotifications(string $token)
+    {
+        // Do something with the token...
+    }
+}
+```
+
+Because of the nature of mobile applications you need an api server to handle these tokens. You can use Laravel's built-in `Http` facade to 
+`POST` the token to your server, on the server side you need to associate the token with the "user" that owns the device.
+
+We **strongly** recommend using [Sanctum](https://laravel.com/docs/12.x/sanctum#main-content) to handle this for you.
+
+## The flow
+
+Your app authenticates users against your own api server, when users create an account or login the server validates and authenticates the user and passes back a Sanctum token.
+
+The token is stored in your apps `session` and is used on subsequent requests to the api server.
+
+When a push notification is received, the token is sent to your api server and the server stores it for the user who sent it.
+
+> Optionally, you can have a `HasMany` relationship between your users and devices, 
+> this allows you to associate a device with a user and then use the device's token 
+> to send push notifications to that users devices.
+
+## Sending Push Notifications
+
+Once you have the token, you may use it from your server-based applications to trigger Push Notifications directly to
+your user's device. We use a package like [google/apiclient](https://github.com/googleapis/google-api-php-client) to send the notifications.
+
+This is the exact code used by the NativePHP Kitchen Sink App (available soon on all app stores and GitHub):
+
+```php
+Route::group(['middleware' => 'auth:sanctum'], function () {
+    Route::post('send-push-notification', PushNotificationController::class)->name('send-push-notification');
+});
+```
+
+```php
+namespace App\Http\Controllers;
+
+use App\Jobs\SendPushNotification;
+use Illuminate\Http\Request;
+
+class PushNotificationController extends Controller
+{
+    public function __invoke(Request $request)
+    {
+        $token = $request->get('token');
+
+        $request->user()->update([
+            'push_token' => $token
+        ]);
+
+        SendPushNotification::dispatch($token)->delay(now()->addMinutes(1));
+    }
+}
+```

resources/views/docs/mobile/1/getting-started/configuration.md

@@ -3,4 +3,50 @@ title: Configuration
 order: 200
 ---
 
-# COMING SOON
+## Overview
+
+NativePHP for Mobile is designed so that most configuration happens **inside your Laravel application**, without requiring you to manually open Xcode or Android Studio.
+
+After installation, NativePHP sets up the necessary native scaffolding, but your primary interaction remains inside Laravel itself.
+
+This page explains the key configuration points you can control directly through Laravel.
+
+## The `nativephp.php` Config File
+
+The nativephp.php config file is where you can configure the native project for your application. 
+
+NativePHP uses sensible defaults and makes several assumptions based on default installations for tools required to build and run apps from your computer. 
+
+You can override these defaults by editing the `nativephp.php` config file in your Laravel project or changing environment variables.
+
+```dotenv
+NATIVEPHP_APP_VERSION 
+NATIVEPHP_APP_VERSION_CODE 
+NATIVEPHP_APP_ID 
+NATIVEPHP_DEEPLINK_SCHEME 
+NATIVEPHP_DEEPLINK_HOST 
+NATIVEPHP_APP_AUTHOR 
+NATIVEPHP_GRADLE_PATH 
+NATIVEPHP_ANDROID_SDK_LOCATION
+```
+
+## Cleanup `env` keys
+
+The `cleanup_env_keys` array in the config file allows you to specify keys that should be removed from the `.env` file before bundling. 
+This is useful for removing sensitive information like API keys or other secrets.
+
+## Cleanup `exclude_files`
+
+The `cleanup_exclude_files` array in the config file allows you to specify files and folders that should be removed before bundling. 
+This is useful for removing files like logs or other temporary files.
+
+## Permissions
+In general, the app stores don't want apps to request permissions that they don't need. 
+To enable some permissions your app needs you simply need to change their values in the permissions section.
+
+```dotenv
+biometric
+camera
+nfc
+push_notifications
+```

resources/views/docs/mobile/1/getting-started/development.md

@@ -3,5 +3,30 @@ title: Development
 order: 300
 ---
 
-# COMING SOON
+
+## The `nativephp` Directory
+
+After running: `php artisan native:install` you’ll see a new `nativephp` directory at the root of your Laravel project as well as a `nativephp.php` config file in your config folder in the Laravel root.
+
+This folder contains all the native project files that NativePHP generates for you.
+
+You should not need to manually open or edit any native project files under normal circumstances.
+NativePHP handles the heavy lifting for you.
+
+## NATIVEPHP_APP_VERSION
+
+The NATIVEPHP_APP_VERSION environment variable controls your app's versioning behavior.
+
+When building for Android, NativePHP first copies the relevant Laravel files into a temporary directory, zips them, and embeds the archive into the Android project. When the app boots, it checks the embedded version against the previously installed version.
+
+If the versions match, the app uses the existing files without re-extracting the archive.
+
+If the versions differ — or if the version is set to ***DEBUG*** — the app updates itself by re-extracting the new bundle.
+
+This mechanism ensures developers can iterate quickly during development, while providing a faster, more stable experience for end users once an app is published.
+
+> Rule of Thumb:
+> During development, keep NATIVEPHP_APP_VERSION set to DEBUG to always refresh the app.
+> When preparing a new release, update it to a semantic version (e.g., 1.2.3) to enable versioned updates for your users.
+
 

resources/views/docs/mobile/1/getting-started/installation.md

@@ -5,35 +5,58 @@ order: 100
 
 ## Requirements
 
-Right now, NativePHP for mobile only supports building iOS applications. Android is in the works already and coming soon!
-
-Apple's tooling for building iOS apps requires that you compile your applications using macOS.
-
 1. PHP 8.3+
 2. Laravel 10 or higher
 3. An Apple Silicon Mac running macOS 12+ with Xcode 16+
 4. An active [Apple Developer account](https://developer.apple.com/)
 5. [A NativePHP for mobile license](https://checkout.anystack.sh/nativephp)
 6. _Optional_ iOS device
 
-You don't _need_ a physical iOS device to compile your application and test it for iOS, as NativePHP for mobile supports
-the iOS Simulator. However, we highly recommend that you test your application on a real device before submitting to the
-App Store.
 
-You can download Xcode from the Mac App Store.
+#### For iOS
+1. An Apple Mac (ideally Silicon) running macOS 12+ with Xcode 16+ 
+2. An active [Apple Developer account](https://developer.apple.com/)
+3. You can download Xcode from the Mac App Store.
 
-The most painless way to get PHP and Node up and running on your system is with
-[Laravel Herd](https://herd.laravel.com). It's fast and free!
+#### For Android
+1. [Android Studio Giraffe (or later)](https://developer.android.com/studio)
+2. The following environment variables set.
+3. You should be able to successfully run `java -v` and `adb devices` from the terminal.
+4. **Windows only**: You must have [7zip](https://www.7-zip.org/) installed.
+
+#### For macOS
+```shell
+export JAVA_HOME=$(/usr/libexec/java_home -v 17) // This isn't required if JAVA_HOME is already set in the Windows Env Variables
+export ANDROID_SDK_ROOT=$HOME/Library/Android/sdk
+export PATH=$PATH:$JAVA_HOME/bin:$ANDROID_HOME/emulator:$ANDROID_HOME/tools:$ANDROID_HOME/tools/bin:$ANDROID_HOME/platform-tools
+```
+
+#### For Windows
+```shell
+set ANDROID_SDK_ROOT=C:\Users\yourname\AppData\Local\Android\Sdk
+set PATH=%PATH%;%JAVA_HOME%\bin;%ANDROID_SDK_ROOT%\platform-tools
+
+# This isn't required if JAVA_HOME is already set in the Windows Env Variables
+set JAVA_HOME=C:\Program Files\Microsoft\jdk-17.0.8.7-hotspot
+```
+
+> **Note** You cannot build iOS apps on Windows or Linux
+
+You don't _need_ a physical iOS/Android device to compile your application and test it for your app, as NativePHP for mobile supports
+the iOS Simulator and Android emulators. However, we highly recommend that you test your application on a real device before submitting to the
+App/Google Play Store.
+
+## Laravel
 
-### Laravel
+NativePHP for mobile is built to work with Laravel. You can install it into an existing Laravel application, or
+[start a new one](https://laravel.com/docs/installation). The most painless way to get PHP and Node up and running on your system is with
+[Laravel Herd](https://herd.laravel.com). It's fast and free!
 
-NativePHP for mobile is built to work best with Laravel. You can install it into an existing Laravel application, or
-[start a new one](https://laravel.com/docs/installation).
 
-## Private package
+## Install NativePHP for mobile
 
 To make NativePHP for mobile a reality has taken a lot of work and will continue to require even more. For this reason,
-it's not open source and you are not free to distribute or modify its source code.
+it's not open source, and you are not free to distribute or modify its source code.
 
 Before you begin, you will need to purchase a license.
 Licenses can be obtained via [Anystack](https://checkout.anystack.sh/nativephp).
@@ -49,19 +72,23 @@ Once you have your license, you will need to add the following to your `composer
 ],
 ```
 
-## Install NativePHP for mobile
-
+Then run:
 ```shell
-composer require nativephp/ios
+composer require nativephp/mobile
 ```
-This package contains all the libraries, classes, commands, and interfaces that your application will need to work with
-iOS.
 
-If this is the first time you're installing the package, you will be prompted to authenticate.
+If this is the first time you're installing the package, you will be prompted to authenticate. Your username is the email address you registered with Anystack. Your password is your license key.
 
-Your username is the email address you registered with Anystack. 
+This package contains all the libraries, classes, commands, and interfaces that your application will need to work with
+iOS and Android.
 
-Your password is your license key.
+**Before** running the `install` command it is important to set the following variables in your `.env`:
+
+```shell
+NATIVEPHP_APP_ID=com.nativephp.yourapp
+NATIVEPHP_APP_VERSION="DEBUG"
+NATIVEPHP_APP_VERSION_CODE="1"
+```
 
 ## Run the NativePHP installer
 
@@ -70,11 +97,7 @@ php artisan native:install
 ```
 
 The NativePHP installer works similarly to NativePHP for desktop, taking care of setting up and configuring your Laravel
-application to work with iOS.
-
-After you've run this command, you'll see a new `ios` folder in the root of your Laravel project.
-
-We'll come back to this later.
+application to work with iOS and/or Android.
 
 ## Start your app
 
@@ -87,21 +110,26 @@ Once you're ready:
 php artisan native:run
 ```
 
-This will start compiling your application and boot it in the iOS Simulator by default.
+This will start compiling your application and boot it in whichever device you select.
 
 ### Running on a real device
 
-If you want to run your app on a real iOS device, you need to make sure the device is in
-[Developer Mode](https://developer.apple.com/documentation/xcode/enabling-developer-mode-on-a-device) and that it's
-been added to your Apple Developer account as
-[a registered device](https://developer.apple.com/account/resources/devices/list).
+#### For iOS
+If you want to run your app on a real mobile device, you need to make sure the device is in
+[Developer Mode](https://developer.apple.com/documentation/xcode/enabling-developer-mode-on-a-device) and that it's been added to your Apple Developer account as [a registered device](https://developer.apple.com/account/resources/devices/list).
+
+For iOS: You will need to get the device's UDID. You can find this by connecting the device to your Mac and opening it in the
+Finder. Click on model name at the top until the UDID appears, then right-click on it to copy it.
 
-Then you can simply run and choose your device from the list of available devices:
+Then you can simply run, replacing `{UDID}` with your device's UDID:
 
 ```shell
 php artisan native:run
 ```
 
 Alternatively, you may open the `ios/NativePHP.xcodeproj` file in Xcode and run builds using Xcode's UI.
 
+#### For Android
+On Android you need [enable developer options](https://developer.android.com/studio/debug/dev-options#enable) and have USB debugging (ADB) enabled.
+
 And that's it! You should now see your Laravel application running as a native app! 🎉

resources/views/docs/mobile/1/getting-started/introduction.md

@@ -12,7 +12,7 @@ We've combined the statically compiling PHP as an embeddable C library with the
 native APIs of each support platform, unlocking the power and convenience of Laravel for building performant, native
 _mobile_ applications using PHP.
 
-**It's never been this easy to build beautiful, local-first apps for iOS and Android (coming soon).**
+**It's never been this easy to build beautiful, local-first apps for iOS and Android.**
 
 ## Old tools, new tricks