> For the complete documentation index, see [llms.txt](https://docs.sacruda.nl/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.sacruda.nl/developers/app-fundamentals/app-icon.md).

# App icon

When you create your project using `npx v7cli new`, you're asked to specify the filename you wish to use for your app icon. This filename then points to a file relative to the `src` directory of your project. So, with the default, `icon.png` becomes `./src/icon.png`. The wizard adds `@local:` to the filename to tell ArcOS that your app uses an icon that's on the filesystem instead of one of Sacruda's built-in icons.

When the project is created, place your image file in the `src` directory. Make sure the filename matches the one in `_app.tpa` *exactly*, including casing, even if your device runs Windows. This is because the Sacruda servers run on Linux, so Sacruda's filesystem is automatically case sensitive.

### Caveats

* The current implementation isn't perfect. For one, the app icon doesn't show up while you're developing your app. This is because Sacruda only tries to locate on-filesystem app icons if the app is registered in Sacruda's `AppStorage` service, which has an internal `appIconCache` that caches app icon files of every registered app.&#x20;
* Keep in mind that your app's icon **is not** the same as the icon you can specify for the **App Store**. To add assets to your app store page, please reference [this page](https://docs.sacruda.nl/developers/app-fundamentals/distribute-your-app.md).
