ps2 · Oct 23, 2026 · Oct 23, 2026
diff --git a/Documentation/AppIcon.png b/Documentation/AppIcon.png
diff --git a/Documentation/Screenshots/Phone Add CGM.png b/Documentation/Screenshots/Phone Add CGM.png
diff --git a/Documentation/Screenshots/Phone Bolus.png b/Documentation/Screenshots/Phone Bolus.png
diff --git a/Documentation/Screenshots/Phone Carb Entry.png b/Documentation/Screenshots/Phone Carb Entry.png
diff --git a/Documentation/Screenshots/Phone Graphs.png b/Documentation/Screenshots/Phone Graphs.png
diff --git a/Documentation/Screenshots/Phone Home.png b/Documentation/Screenshots/Phone Home.png
diff --git a/Documentation/Screenshots/Phone Live Activity.jpg b/Documentation/Screenshots/Phone Live Activity.jpg
diff --git a/Documentation/Screenshots/Phone Notification Battery.png b/Documentation/Screenshots/Phone Notification Battery.png
diff --git a/Documentation/Screenshots/Phone Notification Bolus Failure.png b/Documentation/Screenshots/Phone Notification Bolus Failure.png
diff --git a/Documentation/Screenshots/Phone Notification Loop Failure.png b/Documentation/Screenshots/Phone Notification Loop Failure.png
diff --git a/Documentation/Screenshots/Phone Presets.png b/Documentation/Screenshots/Phone Presets.png
diff --git a/Documentation/Screenshots/Watch Bolus.png b/Documentation/Screenshots/Watch Bolus.png
diff --git a/Documentation/Screenshots/Watch Carb Entry.png b/Documentation/Screenshots/Watch Carb Entry.png
diff --git a/Documentation/Screenshots/Watch Complication.png b/Documentation/Screenshots/Watch Complication.png
diff --git a/Documentation/Screenshots/Watch Home.png b/Documentation/Screenshots/Watch Home.png
diff --git a/Documentation/Screenshots/Watch Menu.png b/Documentation/Screenshots/Watch Menu.png
diff --git a/Documentation/Screenshots/Watch Notification Battery.png b/Documentation/Screenshots/Watch Notification Battery.png
diff --git a/Documentation/Screenshots/Watch Notification Bolus Failure.png b/Documentation/Screenshots/Watch Notification Bolus Failure.png
diff --git a/Documentation/Screenshots/Watch Notification Reservoir.png b/Documentation/Screenshots/Watch Notification Reservoir.png
diff --git a/README.md b/README.md
@@ -1,38 +1,56 @@
 # Loop for iOS
 
-![App Icon](/Loop/DerivedAssetsBase.xcassets/AppIcon.appiconset/Icon-Small-40%402x.png?raw=true)
+<img src="/Documentation/AppIcon.png?raw=true" alt="Loop app icon" width="128">
 
-[![Build Status](https://travis-ci.org/LoopKit/Loop.svg?branch=master)](https://travis-ci.org/LoopKit/Loop)
 [![Join the chat at https://loop.zulipchat.com](https://img.shields.io/badge/zulip-join_chat-brightgreen.svg)](https://loop.zulipchat.com)
 
-Loop is an app template for building an automated insulin delivery system. It is a stone resting on the boulders of work done by many others.
+Loop is an open-source automated insulin delivery app for iPhone and Apple Watch. It reads glucose from a continuous glucose monitor (CGM), forecasts glucose from insulin, carbs and recent trends, and adjusts delivery on a compatible insulin pump. It is a stone resting on the boulders of work done by many others.
 
-Loop is built on top of [LoopKit](https://github.com/LoopKit/LoopKit). LoopKit is a set of frameworks that provide data storage, retrieval, and calculation, as well as boilerplate view controllers used in Loop.
+Loop is built on [LoopKit](https://github.com/LoopKit/LoopKit), a set of frameworks for data storage, retrieval and calculation. Pump and CGM support comes from separate plugins, and the app is built from [LoopWorkspace](https://github.com/LoopKit/LoopWorkspace).
 
 Please understand that this project:
 - Is highly experimental
 - Is not approved for therapy
 
-<a href="/Documentation/Screenshots/Phone%20Graphs.png"><img src="/Documentation/Screenshots/Phone%20Graphs.png?raw=true" alt="Screenshot of status screen" width="170"></a>
-<a href="/Documentation/Screenshots/Phone%20Bolus.png"><img src="/Documentation/Screenshots/Phone%20Bolus.png?raw=true" alt="Screenshot of bolus screen" width="170"></a>
-<a href="/Documentation/Screenshots/Phone%20Notification%20Battery.png"><img src="/Documentation/Screenshots/Phone%20Notification%20Battery.png?raw=true" alt="Screenshot of battery change notification" width="170"></a>
-<a href="/Documentation/Screenshots/Phone%20Notification%20Loop%20Failure.png"><img src="/Documentation/Screenshots/Phone%20Notification%20Loop%20Failure.png?raw=true" alt="Screenshot of loop failure notification" width="170"></a>
-<a href="/Documentation/Screenshots/Phone%20Notification%20Bolus%20Failure.png"><img src="/Documentation/Screenshots/Phone%20Notification%20Bolus%20Failure.png?raw=true" alt="Screenshot of bolus failure notification" width="170"></a>
+<a href="/Documentation/Screenshots/Phone%20Home.png"><img src="/Documentation/Screenshots/Phone%20Home.png?raw=true" alt="Status screen with glucose, active insulin, insulin delivery and active carbs charts" width="170"></a>
+<a href="/Documentation/Screenshots/Phone%20Carb%20Entry.png"><img src="/Documentation/Screenshots/Phone%20Carb%20Entry.png?raw=true" alt="Carb entry with food type and absorption time" width="170"></a>
+<a href="/Documentation/Screenshots/Phone%20Bolus.png"><img src="/Documentation/Screenshots/Phone%20Bolus.png?raw=true" alt="Meal bolus screen with a recommended bolus" width="170"></a>
 
-<a href="/Documentation/Screenshots/Watch%20Complication.png"><img src="/Documentation/Screenshots/Watch%20Complication.png?raw=true" alt="Screenshot of glucose complication on Apple Watch" width="141"></a>
-<a href="/Documentation/Screenshots/Watch%20Carb%20Entry.png"><img src="/Documentation/Screenshots/Watch%20Carb%20Entry.png?raw=true" alt="Screenshot of carb entry on Apple Watch" width="141"></a>
-<a href="/Documentation/Screenshots/Watch%20Bolus.png"><img src="/Documentation/Screenshots/Watch%20Bolus.png?raw=true" alt="Screenshot of bolus entry on Apple Watch" width="141"></a>
-<a href="/Documentation/Screenshots/Watch%20Menu.png"><img src="/Documentation/Screenshots/Watch%20Menu.png?raw=true" alt="Screenshot of the app menu on Apple Watch" width="141"></a>
-<a href="/Documentation/Screenshots/Watch%20Notification%20Reservoir.png"><img src="/Documentation/Screenshots/Watch%20Notification%20Reservoir.png?raw=true" alt="Screenshot of bolus failure notification on Apple Watch" width="141"></a>
-<a href="/Documentation/Screenshots/Watch%20Notification%20Bolus%20Failure.png"><img src="/Documentation/Screenshots/Watch%20Notification%20Bolus%20Failure.png?raw=true" alt="Screenshot of bolus failure notification on Apple Watch" width="141"></a>
+<a href="/Documentation/Screenshots/Phone%20Presets.png"><img src="/Documentation/Screenshots/Phone%20Presets.png?raw=true" alt="Custom presets" width="170"></a>
+<a href="/Documentation/Screenshots/Phone%20Live%20Activity.jpg"><img src="/Documentation/Screenshots/Phone%20Live%20Activity.jpg?raw=true" alt="Live Activity on the Lock Screen" width="170"></a>
+<a href="/Documentation/Screenshots/Phone%20Add%20CGM.png"><img src="/Documentation/Screenshots/Phone%20Add%20CGM.png?raw=true" alt="Choosing a CGM" width="170"></a>
+
+<a href="/Documentation/Screenshots/Watch%20Home.png"><img src="/Documentation/Screenshots/Watch%20Home.png?raw=true" alt="Apple Watch app with glucose and actions" width="141"></a>
+<a href="/Documentation/Screenshots/Watch%20Carb%20Entry.png"><img src="/Documentation/Screenshots/Watch%20Carb%20Entry.png?raw=true" alt="Carb entry on Apple Watch" width="141"></a>
+<a href="/Documentation/Screenshots/Watch%20Bolus.png"><img src="/Documentation/Screenshots/Watch%20Bolus.png?raw=true" alt="Bolus on Apple Watch" width="141"></a>
+
+<sub>Screenshots are from the iOS Simulator with simulated CGM and pump data.</sub>
+
+# Features
+
+- **Automated insulin delivery.** Loop forecasts glucose several hours ahead and adjusts delivery with each new glucose reading, using either temporary basal rates or automatic boluses.
+- **Meal and correction boluses** with a recommended amount and a forecast of where glucose is heading. Carb entries can include food type, absorption time and saved favorite foods.
+- **Pre-meal targets and custom presets** that temporarily adjust overall insulin needs and the correction range, for exercise, illness or other situations. Presets can run for a set time or indefinitely, and can be scheduled to start later.
+- **Live Activity** on the Lock Screen, in the Dynamic Island and on CarPlay.
+- **Apple Watch app** with glucose and forecast, carb entry, bolus, pre-meal targets and presets.
+- **Alerts** for glucose and device conditions, with critical alerts that sound even when the phone is silenced, and an option to temporarily mute alerts.
+- **Algorithm experiments**: optional Glucose Based Partial Application and Integral Retrospective Correction.
+- **Data sharing** with Apple Health, and upload to Nightscout and Tidepool through optional services.
+
+# Supported devices
+
+- **Pumps:** Omnipod 5, Omnipod DASH and Omnipod Classic (Eros, with RileyLink); older Medtronic pumps (with RileyLink); Medtrum Nano (200U and 300U).
+- **CGMs:** Dexcom G5, G6, ONE, G7 and ONE+; FreeStyle Libre 1 and 2 (through MiaoMiao or Bubble transmitters, or EU Libre 2 directly); Eversense E3 and 365; and readings from Dexcom Share or Nightscout.
+
+See [Loop Docs](https://loopkit.github.io/loopdocs/) for the exact models and requirements.
 
 # Documentation
 
-Please visit the [Loop Docs](https://loopkit.github.io/loopdocs/) for installation, algorithm, and other details.
+Please visit the [Loop Docs](https://loopkit.github.io/loopdocs/) for installation, algorithm, and other details. Loop is built from [LoopWorkspace](https://github.com/LoopKit/LoopWorkspace), in a web browser with GitHub Actions or on a Mac with Xcode.
 
-For FAQs, how to contribute to open source aspects of Loop and other tips, refer to the [Wiki](https://github.com/LoopKit/Loop/wiki)
+For FAQs, how to contribute to open source aspects of Loop and other tips, refer to the [Wiki](https://github.com/LoopKit/Loop/wiki).
 
-(Note: there is also a tab for the Wiki at the top of this page)
+Questions and discussion are welcome on [Loop Zulip](https://loop.zulipchat.com).
 
 # License and Code of Conduct