{"id":28383183,"url":"https://github.com/artstorm/ios-app-icon-appearance","last_synced_at":"2026-01-28T17:33:10.730Z","repository":{"id":294827407,"uuid":"988194132","full_name":"artstorm/ios-app-icon-appearance","owner":"artstorm","description":"Adds support in Unity for Light, Dark, \u0026 Tinted iOS App Icon variants, introduced with Xcode 16.","archived":false,"fork":false,"pushed_at":"2025-05-28T03:02:27.000Z","size":991,"stargazers_count":3,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-06-06T05:30:47.818Z","etag":null,"topics":["appicon","appiconset","game-development","gamedev","ios","unity","unity3d"],"latest_commit_sha":null,"homepage":"","language":"C#","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/artstorm.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null}},"created_at":"2025-05-22T07:35:08.000Z","updated_at":"2025-05-28T03:01:13.000Z","dependencies_parsed_at":"2025-05-22T09:03:04.499Z","dependency_job_id":"67311d4c-b499-4368-8e3e-ba2dc6a79761","html_url":"https://github.com/artstorm/ios-app-icon-appearance","commit_stats":null,"previous_names":["artstorm/ios-app-icon-appearance"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/artstorm/ios-app-icon-appearance","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/artstorm%2Fios-app-icon-appearance","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/artstorm%2Fios-app-icon-appearance/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/artstorm%2Fios-app-icon-appearance/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/artstorm%2Fios-app-icon-appearance/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/artstorm","download_url":"https://codeload.github.com/artstorm/ios-app-icon-appearance/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/artstorm%2Fios-app-icon-appearance/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":28847811,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-01-28T15:15:36.453Z","status":"ssl_error","status_checked_at":"2026-01-28T15:15:13.020Z","response_time":57,"last_error":"SSL_read: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["appicon","appiconset","game-development","gamedev","ios","unity","unity3d"],"created_at":"2025-05-30T05:12:08.723Z","updated_at":"2026-01-28T17:33:10.723Z","avatar_url":"https://github.com/artstorm.png","language":"C#","funding_links":[],"categories":[],"sub_categories":[],"readme":"# iOS App Icon Appearance for Unity\n\n\u003cp align=\"center\"\u003e\n    \u003cimg alt=\"iOS App Icon Appearance for Unity\" src=\"https://raw.githubusercontent.com/artstorm/ios-app-icon-appearance/main/.github/readme/icon.png\"\u003e\n\u003c/p\u003e\n\n\u003cp align=\"center\"\u003e\n    \u003ca href=\"https://openupm.com/packages/com.bitbebop.ios-app-icon-appearance/\"\u003e\u003cimg src=\"https://img.shields.io/npm/v/com.bitbebop.ios-app-icon-appearance?label=openupm\u0026amp;registry_uri=https://package.openupm.com\u0026labelColor=383f47\" alt=\"openupm\" /\u003e\u003c/a\u003e\n    \u003ca href=\"https://mastodon.gamedev.place/@johansteen\"\u003e\u003cimg src=\"https://img.shields.io/badge/mastodon-@johansteen-blue.svg?logo=mastodon\u0026logoColor=ffffff\u0026labelColor=383f47\" alt=\"Mastodon: @johansteen\" /\u003e\u003c/a\u003e\n    \u003ca href=\"https://twitter.com/artstorm\"\u003e\u003cimg src=\"https://img.shields.io/badge/twitter-@artstorm-blue.svg?logo=twitter\u0026logoColor=ffffff\u0026labelColor=383f47\" alt=\"Twitter: @artstorm\" /\u003e\u003c/a\u003e\n    \u003ca href=\"https://discord.gg/WJn7w5WaU9\"\u003e\u003cimg src=\"https://img.shields.io/badge/chat-discord-blue?logo=discord\u0026logoColor=ffffff\u0026labelColor=383f47\" alt=\"Discord: Bitbebop\" /\u003e\u003c/a\u003e\n\u003c/p\u003e\n\n## About\n\nThis Unity package enables support for Apple's iOS app icon system, allowing you to specify Light (Any Appearance), Dark, and Tinted variants for your app icon. This streamlined approach, utilizing a single 1024x1024px source icon for each variant, was introduced with Xcode 16.\n\nUpon installation, an **`iOS App Icon`** section is added to Unity's `Project Settings`. The icons configured here will override the default iOS icons (specified in `Player Settings`) during the iOS build process.\n\n\u003e [!IMPORTANT]  \n\u003e Requires building with Xcode 16 or newer.\n\n## Icon Design Considerations\n\nIt's important to design your icon variants according to Apple's Human Interface Guidelines to ensure they look great across the system.\n\n**Key Points from Apple's Guidelines:**\n\n| Variant         | Size        | Background  | Notes                                                                             |\n| --------------- | ----------- | ----------- | --------------------------------------------------------------------------------- |\n| **Light Mode**  | 1024x1024px | Opaque      | This is your standard \"Any Appearance\" icon. Design with its own background.      |\n| **Dark Mode**   | 1024x1024px | Transparent | Design the foreground elements. The system provides the dark gradient background. |\n| **Tinted Mode** | 1024x1024px | Opaque      | Design a grayscale version of icon. The system applies the tint.                  |\n\nFor complete details, please refer to Apple's official documentation:\n\n[App Icons - Human Interface Guidelines (iOS \u0026 iPadOS)](https://developer.apple.com/design/human-interface-guidelines/app-icons#iOS-iPadOS)\n\n# Usage\n\nUsing this package is simple:\n\n1.  **Configure Icons in Project Settings:**\n\n    - After installing the package, navigate to `Edit` → `Project Settings...` in the Unity Editor.\n    - Select the `iOS App Icon` tab.\n    - Assign your 1024x1024px icons to the desired Any Appearance, Dark, and/or Tinted slots.\n\n![iOS App Icons in Project Settings](https://raw.githubusercontent.com/artstorm/ios-app-icon-appearance/main/.github/readme/unity-project-settings.png)\n_Caption: Example of icons assigned in Project Settings._\n\n2.  **Build for iOS:**\n\n    - Open `File` → `Build Settings...`.\n    - Select `iOS` as the platform and click `Build` (or `Build And Run`).\n    - **Important:** This package modifies the Xcode project to use app icon features introduced with Xcode 16. Ensure your build will be opened and archived with Xcode 16 or newer.\n\n3.  **Verify in Xcode (Xcode 16+):**\n\n    - Open your generated `.xcodeproj` file in Xcode.\n    - Navigate to the `Unity-iPhone` folder in the Project Navigator (left sidebar).\n    - Open the `Images` asset catalog.\n    - In the list of assets within the catalog, select `AppIcon`.\n    - You should directly see the editor for `AppIcon` now showing the **\"Any Appearance\"**, **\"Dark\"**, and **\"Tinted\"** wells as the primary input method.\n    - Verify that these wells are populated with the respective icons you assigned in Unity.\n\n![Xcode App Icons](https://raw.githubusercontent.com/artstorm/ios-app-icon-appearance/main/.github/readme/xcode-app-icons.png)\n_Caption: Example of the AppIcon set in Xcode, showing the variants._\n\n## Installation\n\nRequires Unity 2021.3 LTS or higher.\n\n### OpenUPM\n\nThe package is available on the [OpenUPM registry](https://openupm.com). It's recommended to install it via [openupm-cli](https://github.com/openupm/openupm-cli).\n\n```sh\nopenupm add com.bitbebop.ios-app-icon-appearance\n```\n\n### Unity Package Manager and Git URL\n\nInstall the package directly in Unity Package Manger using this URL:\n\n```\nhttps://github.com/artstorm/ios-app-icon-appearance.git?path=/Packages/com.bitbebop.ios-app-icon-appearance\n```\n\nOpen Unity Package Manager → \u003ckbd\u003e+\u003c/kbd\u003e → Add package from git URL:\n\n![Add package from git URL](https://raw.githubusercontent.com/artstorm/ios-app-icon-appearance/main/.github/readme/installation-git-1.png)\n\nPaste URL:\n\n![Paste git URL](https://raw.githubusercontent.com/artstorm/ios-app-icon-appearance/main/.github/readme/installation-git-2.png)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fartstorm%2Fios-app-icon-appearance","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fartstorm%2Fios-app-icon-appearance","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fartstorm%2Fios-app-icon-appearance/lists"}