From cd079c0a3b7f651fbcb5cf4cbeab520325f47858 Mon Sep 17 00:00:00 2001 From: Wojt Janowski Date: Sun, 15 Nov 2026 14:36:38 +0000 Subject: [PATCH 1/2] Document that a real SF Symbol name draws as itself on iOS Amp-Thread-ID: https://ampcode.com/threads/T-01a1df8b-2dad-7068-b8b2-8cffd4f33e8b Co-authored-by: Wojt Janowski --- .../docs/mobile/4/edge-components/icon.md | 26 +++++++++++++++++-- 1 file changed, 24 insertions(+), 2 deletions(-) diff --git a/resources/views/docs/mobile/4/edge-components/icon.md b/resources/views/docs/mobile/4/edge-components/icon.md index f5dcf4a4..dc9bdef0 100644 --- a/resources/views/docs/mobile/4/edge-components/icon.md +++ b/resources/views/docs/mobile/4/edge-components/icon.md @@ -143,7 +143,7 @@ php artisan native-ui:generate-icons Every icon name — whether passed to `` or to the `icon` attribute of any other EDGE component — goes through a four-tier resolution strategy: -1. **Direct platform icons** - On iOS, if the name contains a `.` it's used as a direct SF Symbol path (e.g., `car.side.fill`). On Android, any Material Icon ligature name works directly (e.g., `shopping_cart`) +1. **Direct platform icons** - On iOS, a name that contains a `.` (e.g., `car.side.fill`) or is already an SF Symbol name (e.g., `heart`, `phone`) is used as written. On Android, any Material Icon ligature name works directly (e.g., `shopping_cart`) 2. **Manual mapping** - Explicit mappings for common icons and aliases (e.g., `home`, `settings`, `user`) 3. **Smart fallback** - Normalizes unmapped icon names to a platform equivalent 4. **Default fallback** - Uses a circle icon if no match is found @@ -176,6 +176,20 @@ underscores (`archive-box` → `archivebox`). It deliberately does **not** guess SF Symbols ship their plain glyph at the bare name, so when you want the filled variant, ask for it explicitly (`archivebox.fill`, or the `Ios::ArchiveboxFill` enum case). +A name that is already an SF Symbol bypasses the mapping too, so `heart`, `phone` and `star` draw those outline +symbols. For the filled variant, ask for it by name (`heart.fill`, or `Ios::HeartFill`) or use an alias that maps to it +(`favorite` → `heart.fill`). On Android, a shared `heart` or `star` draws the filled Material icon, so give each platform +its own name when both should match: + +@verbatim +```blade +@use('App\Icons\Ios') +@use('App\Icons\AndroidOutlined') + + +``` +@endverbatim + ### Android (Material Icons) On Android, icons render using a lightweight font-based approach that supports the entire Material Icons library. You @@ -361,7 +375,15 @@ Naming an icon after the system icon it stands in for gives you a sensible fallb ## Icon name reference -All icons listed here are manually mapped and guaranteed to work consistently across iOS and Android. +Every name listed here works on both iOS and Android. Most are aliases that map to a platform icon. Some are also SF +Symbol names, and on iOS those draw that SF Symbol as written (see [How names resolve](#how-names-resolve)): + +- `bell`, `bolt`, `bookmark`, `camera`, `cart`, `clock`, `folder`, `heart`, `lightbulb`, `lock`, `map`, `message`, + `person`, `phone`, `photo`, `receipt`, `star` and `video` draw the outline symbol on iOS and the filled Material icon + on Android. +- `forward`, `info`, `mail`, `smartphone` and `speaker` draw a different symbol on iOS from the one Android draws. For + matching icons, use `chevron_right`, `about`, `email`, `device-phone-mobile` and `speaker-wave` instead. `location` + draws the location arrow on iOS and a map on Android. ### Navigation From 8ad48f9106d57cd2cb14521b4dd350c2c55c023e Mon Sep 17 00:00:00 2001 From: Wojt Janowski Date: Sun, 15 Nov 2026 14:39:20 +0000 Subject: [PATCH 2/2] Mark the SF Symbol name change as changed in 4.9 Amp-Thread-ID: https://ampcode.com/threads/T-01a1df8b-2dad-7068-b8b2-8cffd4f33e8b Co-authored-by: Wojt Janowski --- resources/views/docs/mobile/4/edge-components/icon.md | 9 +++++---- 1 file changed, 5 insertions(+), 4 deletions(-) diff --git a/resources/views/docs/mobile/4/edge-components/icon.md b/resources/views/docs/mobile/4/edge-components/icon.md index dc9bdef0..9ddcd00a 100644 --- a/resources/views/docs/mobile/4/edge-components/icon.md +++ b/resources/views/docs/mobile/4/edge-components/icon.md @@ -143,7 +143,7 @@ php artisan native-ui:generate-icons Every icon name — whether passed to `` or to the `icon` attribute of any other EDGE component — goes through a four-tier resolution strategy: -1. **Direct platform icons** - On iOS, a name that contains a `.` (e.g., `car.side.fill`) or is already an SF Symbol name (e.g., `heart`, `phone`) is used as written. On Android, any Material Icon ligature name works directly (e.g., `shopping_cart`) +1. **Direct platform icons** - On iOS, a name that contains a `.` (e.g., `car.side.fill`) or is already an SF Symbol name (e.g., `heart`, `phone`) is used as written. On Android, any Material Icon ligature name works directly (e.g., `shopping_cart`) 2. **Manual mapping** - Explicit mappings for common icons and aliases (e.g., `home`, `settings`, `user`) 3. **Smart fallback** - Normalizes unmapped icon names to a platform equivalent 4. **Default fallback** - Uses a circle icon if no match is found @@ -176,8 +176,9 @@ underscores (`archive-box` → `archivebox`). It deliberately does **not** guess SF Symbols ship their plain glyph at the bare name, so when you want the filled variant, ask for it explicitly (`archivebox.fill`, or the `Ios::ArchiveboxFill` enum case). -A name that is already an SF Symbol bypasses the mapping too, so `heart`, `phone` and `star` draw those outline -symbols. For the filled variant, ask for it by name (`heart.fill`, or `Ios::HeartFill`) or use an alias that maps to it +A name that is already an SF Symbol bypasses the mapping too , so `heart`, `phone` +and `star` draw those outline symbols. Before 4.9 they went through the mapping, which drew most of them filled. For +the filled variant, ask for it by name (`heart.fill`, or `Ios::HeartFill`) or use an alias that maps to it (`favorite` → `heart.fill`). On Android, a shared `heart` or `star` draws the filled Material icon, so give each platform its own name when both should match: @@ -376,7 +377,7 @@ Naming an icon after the system icon it stands in for gives you a sensible fallb ## Icon name reference Every name listed here works on both iOS and Android. Most are aliases that map to a platform icon. Some are also SF -Symbol names, and on iOS those draw that SF Symbol as written (see [How names resolve](#how-names-resolve)): +Symbol names, and on iOS those draw that SF Symbol as written (see [How names resolve](#how-names-resolve)): - `bell`, `bolt`, `bookmark`, `camera`, `cart`, `clock`, `folder`, `heart`, `lightbulb`, `lock`, `map`, `message`, `person`, `phone`, `photo`, `receipt`, `star` and `video` draw the outline symbol on iOS and the filled Material icon