From 90840c53167ff6c87296049c830596dd1af82a53 Mon Sep 17 00:00:00 2001
From: Shane Rosenthal <srosenthal82@gmail.com>
Date: Thu, 23 Apr 2026 16:30:17 -0400
Subject: [PATCH] docs(mobile/3): note Inertia 3 axios requirement in
 development guide
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

NativePHP Mobile intercepts axios at bundle time to route HTTP requests
through the embedded PHP runtime. Inertia 3 removed axios in favour of
native fetch, so fresh Inertia 3 projects fail the NativePHP build until
they declare axios as a direct dependency.

Adds an aside to mobile/3/getting-started/development in the section that
already introduces the nativephpMobile Vite plugin — that's the natural
home for build-time concerns — with the single `npm install axios` step
and a link to Inertia's client-side-setup docs for wiring it up.

Pairs with NativePHP/mobile-air#100 which makes the Vite plugin fail
early with an error pointing here and at the Inertia docs.

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
---
 .../mobile/3/getting-started/development.md   | 21 +++++++++++++++++++
 1 file changed, 21 insertions(+)

diff --git a/resources/views/docs/mobile/3/getting-started/development.md b/resources/views/docs/mobile/3/getting-started/development.md
index 62506e6a..cbd99fae 100644
--- a/resources/views/docs/mobile/3/getting-started/development.md
+++ b/resources/views/docs/mobile/3/getting-started/development.md
@@ -66,6 +66,27 @@ npm run build -- --mode=ios
 npm run build -- --mode=android
 ```
 
+<aside>
+
+#### Using Inertia 3?
+
+NativePHP Mobile routes every outgoing HTTP request through the embedded PHP runtime
+by intercepting `axios` at bundle time. [Inertia 3 removed axios][inertia-axios] in
+favour of native `fetch`, so fresh Inertia 3 projects won't declare it — the
+NativePHP build will fail until you add axios as a direct dependency:
+
+```shell
+npm install axios
+```
+
+Then follow the [Inertia docs on using axios][inertia-axios] to tell Inertia to use
+it for its client-side requests. Apps on Inertia 2 (or using axios directly) already
+have it installed and don't need any change.
+
+[inertia-axios]: https://inertiajs.com/docs/v3/installation/client-side-setup#using-axios
+
+</aside>
+
 ## Compile your app
 
 To compile and run your app, simply run: