Skip to content

Commit c38e116

Browse files
committed
wip
1 parent 8b598be commit c38e116

File tree

9 files changed

+50
-17
lines changed

9 files changed

+50
-17
lines changed
Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,4 +1,4 @@
11
---
22
title: APIs
3-
order: 4
3+
order: 50
44
---
Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,4 +1,4 @@
11
---
22
title: Concepts
3-
order: 3
3+
order: 40
44
---
Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,4 +1,4 @@
11
---
22
title: EDGE Components
3-
order: 5
3+
order: 30
44
---
Lines changed: 4 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,4 @@
1+
---
2+
title: Introduction
3+
order: 1
4+
---

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

Lines changed: 4 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -109,7 +109,10 @@ You may enable the features you intend to use simply by changing the value of th
109109
- `storage_write` - Allows your app to write to device storage.
110110
- `microphone` - Allows your application to request access to the device's microphone, if present. Required for audio
111111
recording functionality. Note that the user may deny access and any microphone functions will then result in a no-op.
112-
- `qr-code` - Allows your application to scan QR codes and barcodes. Note that the user may deny camera access and any
112+
- `microphone_background` - Allows your application to request access to the device's microphone, if present. Required
113+
for audio recording functionality. Note that the user may deny access and any microphone functions will then result in
114+
a no-op.
115+
- `scanner` - Allows your application to scan QR codes and barcodes. Note that the user may deny camera access and any
113116
scanning functions will then result in a no-op.
114117
- `network_state` - Allows your application to access information about the device's network connectivity status. This
115118
permission is enabled by default as it's commonly needed for basic network state detection.

resources/views/docs/mobile/2/getting-started/environment-setup.md

Lines changed: 3 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -23,7 +23,7 @@ You cannot build iOS apps on Windows or Linux. This is a limitation imposed by A
2323

2424
</aside>
2525

26-
1. macOS (required - iOS development is only possible on a Mac)
26+
1. macOS (required - iOS development is only possible on an Apple silicon Mac, M1+)
2727
2. [Xcode 16.0 or later](https://apps.apple.com/app/xcode/id497799835)
2828
3. Xcode Command Line Tools
2929
4. Homebrew & CocoaPods
@@ -63,6 +63,7 @@ You **do not** need to enroll in the [Apple Developer Program](https://developer
6363
to develop and test your apps on a Simulator. However, you will need to enroll when you want to:
6464
- Test your apps on real devices
6565
- Distribute your apps via the App Store
66+
- Test features that rely on a paid Apple Developer accounts, such as Push Notifications
6667

6768
## Android Requirements
6869

@@ -72,7 +73,7 @@ to develop and test your apps on a Simulator. However, you will need to enroll w
7273

7374
<aside class="relative z-0 mt-5 overflow-hidden rounded-2xl bg-pink-50 px-5 ring-1 ring-black/5 dark:bg-pink-600/10">
7475

75-
#### Note
76+
#### JDK Version Compatibility
7677

7778
You might need to install the Java Development Kit (JDK) separately. Recent versions of Android Studio no longer install it automatically.
7879
If you encounter Gradle errors, check the [Gradle JDK Compatibility Matrix](https://docs.gradle.org/current/userguide/compatibility.html).

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

Lines changed: 7 additions & 7 deletions
Original file line numberDiff line numberDiff line change
@@ -3,7 +3,7 @@ title: Introduction
33
order: 1
44
---
55

6-
## Welcome to the revolution!
6+
## Enjoy building mobile apps!
77

88
NativePHP for Mobile is the first library of its kind that lets you run full PHP applications natively on mobile
99
devices — no web server required.
@@ -18,8 +18,9 @@ experiences using the tools you already know.
1818

1919
- 📱 **Native performance**
2020
Your app runs natively through an embedded PHP runtime optimized for each platform.
21-
- 🔥 **True mobile APIs**
22-
Access camera, biometrics, push notifications, and more. One cohesive library that does it all.
21+
- 🔥 **True native APIs**
22+
Access camera, biometrics, push notifications, and more. Build beautiful UIs with native components. All from one
23+
cohesive library that does it all.
2324
-**Laravel powered**
2425
Leverage the entire Laravel ecosystem and your existing skillset.
2526
- 🚫 **No web server required**
@@ -35,16 +36,15 @@ No new languages. No unfamiliar build tools. No fighting with Gradle or Xcode.
3536
Just PHP.
3637

3738
Developers around the world are using the skills they already have to build and ship real mobile apps — faster than
38-
ever. In just a few hours, you can go from code to app store submission.
39+
ever. In just a few minutes, you can go from code to app store submission.
3940

4041
## How does it work?
4142

42-
On the simplest level:
43-
4443
1. A pre-compiled version of PHP is bundled with your code into a Swift/Kotlin shell application.
4544
2. NativePHP's custom Swift/Kotlin bridges manage the PHP environment, running your PHP code directly.
4645
3. A custom PHP extension is compiled into PHP, that exposes PHP interfaces to native functions.
47-
4. Your app renders in a native web view, so you can continue developing your UI the way you're used to.
46+
4. Build with HTML, JavaScript, Tailwind, Blade, Livewire, React, Vue, Svelte — whatever you're most comfortable with!
47+
5. And now in v2: use truly native UI components too with [EDGE](/docs/mobile/2/edge-components/)!
4848

4949
You simply interact with an easy-to-use set of functions from PHP and everything just works!
5050

resources/views/docs/mobile/2/getting-started/quick-start.md

Lines changed: 27 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -28,6 +28,14 @@ Add the NativePHP Composer repository:
2828
]
2929
```
3030

31+
#### Running Composer 2.9+?
32+
33+
If you're running Composer 2.9 or above, you can just use a single command, instead of copy-pasting the above:
34+
35+
```shell
36+
composer repo add nativephp composer https://nativephp.composer.sh
37+
```
38+
3139
### 2. Set your app's identifier
3240
You must set a `NATIVEPHP_APP_ID` in your `.env` file:
3341

@@ -37,9 +45,10 @@ NATIVEPHP_APP_ID=com.cocacola.cokezero
3745

3846
<aside class="relative z-0 mt-5 overflow-hidden rounded-2xl bg-pink-50 px-5 ring-1 ring-black/5 dark:bg-pink-600/10">
3947

40-
#### Note
48+
#### App ID Rules
4149

42-
Use only lowercase letters, numbers, and periods. Special characters (like hyphens, underscores, or spaces) will cause the build to fail.
50+
Use only lowercase letters, numbers, and periods. Special characters (like hyphens, underscores, spaces or emoji) will
51+
cause the build to fail.
4352

4453
</aside>
4554

@@ -56,6 +65,22 @@ php artisan native:install
5665
php artisan native:run
5766
```
5867

68+
#### The `native` command
69+
70+
When you run `native:install`, NativePHP installs a `native` script helper that can be used as a convenient wrapper to
71+
the `native` Artisan command namespace. Once this is installed you can do the following:
72+
73+
```shell
74+
# Instead of...
75+
php artisan native:run
76+
77+
# Do
78+
php native run
79+
80+
# Or
81+
./native run
82+
```
83+
5984
## Need help?
6085

6186
- **Community** - Join our [Discord](/discord) for support and discussions.
Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -1,4 +1,4 @@
11
---
22
title: The Basics
3-
order: 2
4-
---
3+
order: 20
4+
---

0 commit comments

Comments
 (0)