# Icon Usage
`Zafiro.Avalonia` simplifies icon management using a specialized markup extension and styling options.
## ?️ IconExtension
Use the `{Icon}` markup extension to easily include icons from libraries like FontAwesome.
```xml
```
## ? IconOptions
`IconOptions` allows you to customize icons without manually wrapping them in other controls. It's often used in styles to provide a consistent look.
```xml
```
### Common Properties:
- `IconOptions.Size`: Sets the width and height of the icon.
- `IconOptions.Fill`: The color/brush of the icon.
- `IconOptions.Background`: Background brush for the icon container.
- `IconOptions.Padding`: Padding inside the icon container.
- `IconOptions.CornerRadius`: Corner radius if a background is used.
## ? Shared Icon Resources
Define icons as resources for reuse across the application.
```xml
```
Then use them with `StaticResource` if they are already defined:
```xml
```
However, the `{Icon ...}` extension is usually preferred for its brevity and ability to create new icon instances on the fly.
Source: claude-code-templates (MIT). See About Us for full credits.