diff --git a/docs/browser/bb-overview.md b/docs/browser/bb-overview.md index 6b6ec92cce1..853fc7e94d6 100644 --- a/docs/browser/bb-overview.md +++ b/docs/browser/bb-overview.md @@ -3,49 +3,23 @@ * Loop 3 can be built with a web browser using GitHub Actions * The app is then installed by you on your phone using the *TestFlight* app -### Advantages of Building with a Browser +## Requirements -* *Mac* computer is not required to build or install the app - * Anything with a browser works to build the *Loop* app: PC, Tablet, Mac or iPad - * The *TestFlight* app is used to install the *Loop* app on your iPhone -* Compatible version of *Xcode* is provided by *GitHub* - * The time required for the initial setup to build with a browser may take less time than one *macOS* and *Xcode* version update for those using [Build with *Mac*](../build/overview.md) -* Automatic Updates are loaded into *TestFlight* - * With version 3.4, builds are automatically prepared at least once a month - * You choose when to install the new app from TestFlight onto your phone -* Manual Updates are easy - * Starting an update takes a few minutes of your time; it can be done from your phone; the rest is automatic and is done in about an hour +### Phone, CGM and Pump -### Considerations for Building with a Browser +To use the *Loop* app, you need: -* After the *GitHub* Build starts, your app is ready to install on your *iPhone* in about an hour -* The app is delivered to your phone via *TestFlight* - * The app is considered "Beta" by *Apple* and expires after 90 days - * Loop 3.4  and later versions provide automatic build as the default -* Customization methods are documented at [Customize with Browser](custom-browser.md){: target="_blank" } - -## Requirements +* [Compatible Phone](../build/phone.md){: target="_blank" } +* [Compatible CGM](../build/cgm.md){: target="_blank" } +* [Compatible Pump](../build/pump.md){: target="_blank" } + * For pumps that do not support Bluetooth communications (older Medronic and Omnipod Eros), you also need a [RileyLink Compatible Device](../build/rileylink.md){: target="_blank" } -* **Loop 3 requires iOS 15.1 or higher on the phone.** +### Accounts To build the _Loop_ app using a browser, you need: -1. Free *GitHub* account (instructions included in [New *GitHub* Account](secrets.md#new-github-account){: target="_blank" }) -1. [*Apple* Developer Membership](../build/apple-developer.md){: target="_blank" } - * Must be a paid developer account - * If building for a family member, review this section: - * [Loopers Need Their Own *Apple* ID](../build/apple-developer.md#loopers-need-their-own-apple-id){: target="_blank" } - * If building for a child (age depends on the country), review this section: - * [*TestFlight* for a Child](../browser/phone-install.md#testflight-for-a-child){: target="_blank" } - -Once you have the _Loop_ app in *TestFlight*, you need: - -1. [Compatible iPhone](../build/phone.md){: target="_blank" } -1. [Compatible Pump](../build/pump.md){: target="_blank" } -1. [Compatible CGM](../build/cgm.md){: target="_blank" } -1. [RileyLink Compatible Device](../build/rileylink.md){: target="_blank" } - * Needed for Medtronic and Omnipod Eros only - * Not needed for Bluetooth enabled pumps like DASH and Dana +1. Free *GitHub* account: (instructions found at [New *GitHub* Account](secrets.md#new-github-account){: target="_blank" }) +1. Paid *Apple* Developer account: ($99/year; instructions found at [*Apple* Developer Account](../build/apple-developer.md){: target="_blank" }) ## Instructions to Build with a Browser @@ -80,11 +54,24 @@ Once the app is built the first time: * You need to set up [TestFlight Users](tf-users.md){: target="_blank" } who can then install that app on their phone * This is true even if the only *TestFlight* user is you +* This step is needed one-time only Instructions to install on a phone are found at: * [Install on Phone](phone-install.md){: target="_blank" } +## What if I get stuck? + +Try to: + +* Scroll back in the directions and see if you missed a paragraph or step +* Compare your display with the graphics in *LoopDocs* + * Is something different or does yours have an error message? + * Does the error message guide you to the problem and solution? + * Be aware that *GitHub* sometimes updates displayed names or locations for menu items - search for *GitHub* directions if your display looks different than our documentation +* If you are still stumped - reach out for help: [How to Find Help](../intro/loopdocs-how-to.md#how-to-find-help) + * Remember - to get help with Browser Build, all we need is your *GitHub* username and a brief description of your problem + ## Update the App Instructions to make updates are found at: @@ -101,20 +88,31 @@ If you get an error, please consult: * [Errors with Browser](bb-errors.md){: target="_blank" } -## Building the Development Version of the App +## Other Topics + +### Building the Development Version of the App For experienced and/or advanced users who want to build the development version of the app, there is additional information at the link below. If you have not built using the browser build method before, it is suggested you first build the released version. Once you have a successful build, then follow the steps for the development version. Building the app is independent of installing the app on your phone from *TestFlight*. * [Build Development Version](build-dev-browser.md){: target="_blank" } -## What if I get stuck? +### Mac vs Browser -Try to: +These considerations were prepared when most people were using a Mac computer to build the *Loop* app. + +* *Mac* computer is not required to build or install the app + * Anything with a browser works to build the *Loop* app: PC, Tablet, Mac or iPad + * The *TestFlight* app is used to install the *Loop* app on your iPhone +* Compatible version of *Xcode* is provided by *GitHub* + * The time required for the initial setup to build with a browser may take less time than one *macOS* and *Xcode* version update for those using [Build with *Mac*](../build/overview.md) +* Automatic Updates are loaded into *TestFlight* + * With version 3.4, builds are automatically prepared at least once a month + * You choose when to install the new app from TestFlight onto your phone +* Manual Updates are easy + * Starting an update takes a few minutes of your time; it can be done from your phone; the rest is automatic and is done in about an hour +* After the *GitHub* Build starts, your app is ready to install on your *iPhone* in about an hour +* The app is delivered to your phone via *TestFlight* + * The app is considered "Beta" by *Apple* and expires after 90 days + * Loop 3.4  and later versions provide automatic build as the default +* Customization methods are documented at [Customize with Browser](custom-browser.md){: target="_blank" } -* Scroll back in the directions and see if you missed a paragraph or step -* Compare your display with the graphics in *LoopDocs* - * Is something different or does yours have an error message? - * Does the error message guide you to the problem and solution? - * Be aware that *GitHub* sometimes updates displayed names or locations for menu items - search for *GitHub* directions if your display looks different than our documentation -* If you are still stumped - reach out for help: [How to Find Help](../intro/loopdocs-how-to.md#how-to-find-help) - * Remember - to get help with Browser Build, all we need is your *GitHub* username and a brief description of your problem