Phone Registration Rewrite

docs/pnr.md

@@ -1,57 +1,82 @@
 
-# Phone Number Registration
-::: info
-Phone Number Registration may not be as reliable as Mac registration, and different carriers may not play nicely. OpenBubbles operates **BEST** with Mac hardware codes.
+# Phone Number Registration <Badge type="danger" text="Caution"/>
+
+::: tip 
+Using an iPhone requires significant setup. We recommend reading this entire guide thoroughly before proceeding.
+:::
+
+::: warning
 
 The following guide contains links to third-party websites that are not affiliated with OpenBubbles and their contents can change at any time. Use at your own risk.
 :::
-Learn how to get your phone number working on iMessage. The app will default to sending to whatever handle is chosen in settings or setup. 
-You can also choose to skip logging in with Apple Account. This may lead to less issues in some cases.
 
-## Pre-Setup | Do this first
-Make sure iMessage andFacetime is disabled on your iPhone. You also need to disable Advanced Data Protection and Contact Key Verification.
+This guide will explain how to get your phone number working on iMessage.
+
+Phone Number Registration may not be as reliable as Mac registration, and different carriers may not play nicely. OpenBubbles operates **best** with Mac hardware info.
+
+## Key Information 
+
+Maintaining registration requires the iPhone and relay to stay online. Apple can force a re-registeration at any time, therefore **your iPhone must be online at all times** once setup has been completed. If you're iPhone or relay is offline when Apple re-registers your phone number may be deregistered.
 
-## Sim / eSim Swaping Methods
+## Step 1. Pre-Setup
+Make sure iMessage and Facetime is disabled on your iPhone. You also need to disable Advanced Data Protection and Contact Key Verification.
 
-Sim swapping is a method which involves using an iPhone to register a number, and then using OpenBubbles normally with Mac hardware data. You can follow the same guides used for BlueBubbles. However, this method can be even more unreliable than OB.
-[All These BlueBubbles | Sim Swapping Guide](https://guide.atbluebubbles.com/ )
+## Step 2. Activation
+
+There are two methods to setup phone number registration:
+
+### Option A. Relay App <Badge type="tip" text="Recommended" />
+This method installs a Relay App to communicate the iPhone's hardware info to OpenBubbles. Apple limits the installation of apps to it's App Store, this guide will circumvent this, this is called **sideloading**.
 
-## Relay Apps
-Keep the device on at all times and connected to Wi-Fi in order to keep your number registered. 
 While not required, leaving the display on may improve reliability.
 
-### Method 1 - Validation Relay
-There are multiple ways to install Validation Relay, dependening on iOS version and device hardware. 
+:::: details Method 1 - iOS 14.0 - iOS 17.0
+
+There are multiple ways to install the Relay App, dependening on iOS version and device hardware. This method will sideload TrollStore on your phone, which will allow you to sideload the relay app.
+
 This guide can be followed regardless of jailbreak status: 
-
-Guide 1 - TrollStore
 
-1. Install TrollStore on your device (iOS 14 - iOS 17.0) - [TrollStore Guide](https://ios.cfw.guide/installing-trollstore/)
-2. If you have TestFlight installed, delete it.
-3. Sideload JJTech's - [Validation Relay App](https://github.com/JJTech0130/ValidationRelay/releases) TIPA file in TrollStore.
-4. For best results, sign out of any Apple ID on the device.
-5. Input the code from the relay app in OpenBubbles (if you are changing from existing hardware, go to Settings -> Change Hardware).
-6. Enable Keep Awake and Dim Display
-7.  Optional Steps  - If you are jailbroken you can install the following tweaks (may not be compatible with your iOS version):
-    * [AdvancedBrightnessSlider](https://havoc.app/package/advancedbright) to lower the risk of screen burn in
-    * [ChargeLimiter](https://github.com/lich4/ChargeLimiter?tab=readme-ov-file#Introduction) to limit charge of the battery
-    * [Immortalizer](https://havoc.app/package/immortalizer) to keep the relay app in the active while the screen is off.
+1. Install TrollStore on your device (iOS 14.0 - iOS 17.0) via the [TrollStore Guide](https://ios.cfw.guide/installing-trollstore/)
+
+* If you have TestFlight installed, delete it.
+
+2. Download JJTech's - [Validation Relay App](https://github.com/JJTech0130/ValidationRelay/releases) on your iPhone and sideload the TIPA file in TrollStore.
+
+3. Input the code from the relay app in OpenBubbles.
+* If you are changing from existing hardware, go to Settings -> Change Hardware.
+
+4. Enable Keep Awake and Dim Display
+
+If you are jailbroken you can install the following tweaks (may not be compatible with your iOS version):
+* [AdvancedBrightnessSlider](https://havoc.app/package/advancedbright) to lower the risk of screen burn in
+* [ChargeLimiter](https://github.com/lich4/ChargeLimiter?tab=readme-ov-file#Introduction) to limit charge of the battery
+* [Immortalizer](https://havoc.app/package/immortalizer) to keep the relay app in the active while the screen is off.
 
-### Method 2
+::::
+
+:::: details Method 2 - iOS 10.0 - 14.0 (Jailbreak Required)
 
 If you are on older iOS versions (10 - 14) and jailbroken follow these steps: 
 
-1. Download Copperboy100's - [RelayServer](https://github.com/OpenBubbles/relayserver/releases). -arm is for iOS 10 - 14 (rootful), -arm64 is for iOS 15 - 16.5 (rootless)
+1. Download Copperboy100's - [RelayServer](https://github.com/OpenBubbles/relayserver/releases).
+* -arm is for iOS 10 - 14 (rootful)
+* -arm64 is for iOS 15 - 16.5 (rootless)
 2. Install RelayServer 
 3. Retrieve the relay code in /var/mobile/config.json. You can find this using an app like Filza.
 4. For best results, sign out of any Apple ID on the device.
 5. Input the code from the relay app in OpenBubbles (if you are changing from existing hardware, go to Settings -> Change Hardware).
 
-## DO NOT USE
-~~[ThatMarcel's beepserv-rewrite](https://github.com/thatmarcel/beepserv-rewrite)~~
+::::
+
+### Option B. Sim / eSim Swaping Methods
+
+**Sim swapping** is a method which involves using an iPhone to register a number, and then using OpenBubbles normally with Mac hardware data and returning your sim back into your android device.
+
+This method can be unreliable and your milage may vary.
+
+See [All These BlueBubbles | Sim Swapping Guide](https://guide.atbluebubbles.com/ )
 
-It is known to be **extremely unreliable** and usually only works once.
 
-###
-**Credits** : [pypush, jjtech, Alfie,](https://discord.com/channels/1130633272595066880/1135636248019615874/1231003645529817139) [BlueBubbles Team](https://github.com/orgs/BlueBubblesApp/people), [danip](https://discord.com/channels/1130633272595066880/1135636248019615874/1231003645529817139), [cjocollin](https://www.reddit.com/r/BlueBubbles/comments/1938ock/stop_using_old_methods_heres_a_new_one/) and [Copperboy100](https://github.com/TaeHagen)
-###
+### Credits
+[pypush, jjtech, Alfie,](https://discord.com/channels/1130633272595066880/1135636248019615874/1231003645529817139) [BlueBubbles Team](https://github.com/orgs/BlueBubblesApp/people), [danip](https://discord.com/channels/1130633272595066880/1135636248019615874/1231003645529817139), [cjocollin](https://www.reddit.com/r/BlueBubbles/comments/1938ock/stop_using_old_methods_heres_a_new_one/) and [Copperboy100](https://github.com/TaeHagen)
+###