Add publishing docs

Author: simonhamp

resources/views/docs/1/digging-deeper/updater.md

@@ -0,0 +1,4 @@
+---
+title: Publishing Your App
+order: 4
+---

resources/views/docs/1/publishing/_index.md

@@ -0,0 +1,39 @@
+---
+title: Building
+order: 100
+---
+# Building Your App
+
+Building your app is the process of compiling your application into a production-ready state. When building, NativePHP
+attempts to sign and notarize your application. Once signed, your app is ready to be distributed.
+
+The build process compiles your app for one platform at a time. It compiles your application along with the
+Electron/Tauri runtime into a single executable.
+
+Once built, you can distribute your app however you prefer, but NativePHP also provides a [publish command](publishing)
+that will automatically upload your build artifacts to your chosen [provider](/docs/publishing/updating) - this allows
+your app to provide automatic updates.
+
+You should build your application for each platform you intend to support and test it on each platform _before_
+publishing to make sure that everything works as expected.
+
+## Running a build
+
+```shell
+php artisan native:build
+```
+
+This will build for the platform and architecture where you are running the build.
+
+### Cross-compilation
+
+You can also specify a platform to build for by passing the `os` argument, so for example you could build for Windows
+whilst on a Mac:
+
+```shell
+php artisan native:build windows
+```
+
+Possible options are: `mac`, `win`, `linux`.
+
+**Cross-compilation is not supported on all platforms.**

resources/views/docs/1/publishing/building.md

@@ -0,0 +1,29 @@
+---
+title: Publishing
+order: 200
+---
+# Publishing Your App
+
+Publishing your app is similar to building, but in addition NativePHP will upload the build artifacts to your chosen
+[updater provider](/docs/publishing/updating) automatically.
+
+## Running a build
+
+```shell
+php artisan native:publish
+```
+
+This will build for the platform and architecture where you are running the build.
+
+### Cross-compilation
+
+You can also specify a platform to build for by passing the `os` argument, so for example you could build for Windows
+whilst on a Mac:
+
+```shell
+php artisan native:publish windows
+```
+
+Possible options are: `mac`, `win`, `linux`.
+
+**Cross-compilation is not supported on all platforms.**

resources/views/docs/1/publishing/publishing.md

@@ -0,0 +1,75 @@
+---
+title: Updating
+order: 300
+---
+# The Updater
+NativePHP ships with a built-in auto-update tool, which allows your users to update your application without needing to
+manually download and install new releases.
+
+This leaves you to focus on building and releasing new versions of your application, without needing to worry about
+distributing those updates to your users.
+
+**macOS: Automatic updating is only supported for [signed](/docs/publishing/building#signing-and-notarizing)
+applications.** 
+
+## How it works
+The updater works by checking a remote URL for a new version of your application. If a new version is found, the updater
+will download the new version and replace the existing application files with the new ones.
+
+This means your application's builds need to be hosted online. NativePHP will automatically upload your application for
+you. After configuring the updater, simply use the [`php artisan native:publish`](/docs/publishing/publishing) command.
+
+The updater supports two providers:
+
+- Amazon S3 (`s3`)
+- DigitalOcean Spaces (`spaces`)
+
+You can configure all settings for the updater in your `config/nativephp.php` file or via your `.env` file.
+
+**The updater will only run when your app is running in production mode.** 
+
+## Configuration
+The default updater configuration looks like this:
+
+```php
+    'updater' => [
+        'enabled' => env('NATIVEPHP_UPDATER_ENABLED', true),
+
+        'default' => env('NATIVEPHP_UPDATER_PROVIDER', 'spaces'),
+
+        'providers' => [
+            's3' => [
+                'driver' => 's3',
+                'key' => env('AWS_ACCESS_KEY_ID'),
+                'secret' => env('AWS_SECRET_ACCESS_KEY'),
+                'region' => env('AWS_DEFAULT_REGION'),
+                'bucket' => env('AWS_BUCKET'),
+                'endpoint' => env('AWS_ENDPOINT'),
+                'path' => env('NATIVEPHP_UPDATER_PATH', null),
+            ],
+
+            'spaces' => [
+                'driver' => 'spaces',
+                'key' => env('DO_SPACES_KEY_ID'),
+                'secret' => env('DO_SPACES_SECRET_ACCESS_KEY'),
+                'name' => env('DO_SPACES_NAME'),
+                'region' => env('DO_SPACES_REGION'),
+                'path' => env('NATIVEPHP_UPDATER_PATH', null),
+            ],
+        ],
+    ],
+```
+
+How to setup your storage and generate the relevant API credentials:
+- [DigitalOcean](https://docs.digitalocean.com/products/spaces/how-to/manage-access/)
+- Amazon S3 - See [this video](https://www.youtube.com/watch?v=FLIp6BLtwjk&ab_channel=CloudCasts) by Chris Fidao or 
+    this [Step 2](https://www.twilio.com/docs/video/tutorials/storing-aws-s3#step-2) of this article by Twilio
+
+## Disabling the updater
+
+If you don't want your application to check for updates, you can disable the updater by setting the
+`updater.enabled` option to `false` in your `config/nativephp.php` file or via your `.env` file:
+
+```dotenv
+NATIVEPHP_UPDATER_ENABLED=false
+```