Avalonia Layout with Zafiro.Avalonia

avalonia-layout-zafiro

Guidelines for modern Avalonia UI layout using Zafiro.Avalonia, emphasizing shared styles, generic components, and avoiding XAML redundancy.

diegosouzapw/awesome-omni-skill·0installs62starsProductivity & Planning

SKILL.md

Full skill instructions

Avalonia Layout with Zafiro.Avalonia

Master modern, clean, and maintainable Avalonia UI layouts. Focus on semantic containers, shared styles, and minimal XAML.

🎯 Selective Reading Rule

Read ONLY files relevant to the layout challenge!

📑 Content Map

File	Description	When to Read
`themes.md`	Theme organization and shared styles	Setting up or refining app themes
`containers.md`	Semantic containers (`HeaderedContainer`, `EdgePanel`, `Card`)	Structuring views and layouts
`icons.md`	Icon usage with `IconExtension` and `IconOptions`	Adding and customizing icons
`behaviors.md`	`Xaml.Interaction.Behaviors` and avoiding Converters	Implementing complex interactions
`components.md`	Generic components and avoiding nesting	Creating reusable UI elements

🔗 Related Project (Exemplary Implementation)

For a real-world example, refer to the Angor project: /mnt/fast/Repos/angor/src/Angor/Avalonia/Angor.Avalonia.sln

✅ Checklist for Clean Layouts

Used semantic containers? (e.g., HeaderedContainer instead of Border with manual header)
Avoided redundant properties? Use shared styles in axaml files.
Minimized nesting? Flatten layouts using EdgePanel or generic components.
Icons via extension? Use {Icon fa-name} and IconOptions for styling.
Behaviors over code-behind? Use Interaction.Behaviors for UI-logic.
Avoided Converters? Prefer ViewModel properties or Behaviors unless necessary.

❌ Anti-Patterns

DON'T:

Use hardcoded colors or sizes (literals) in views.
Create deep nesting of Grid and StackPanel.
Repeat visual properties across multiple elements (use Styles).
Use IValueConverter for simple logic that belongs in the ViewModel.

DO:

Use DynamicResource for colors and brushes.
Extract repeated layouts into generic components.
Leverage Zafiro.Avalonia specific panels like EdgePanel for common UI patterns.

When to Use

This skill is applicable to execute the workflow or actions described in the overview.

Install skill

Copy and run in your terminal

npx -y skills add https://github.com/diegosouzapw/awesome-omni-skill --skill avalonia-layout-zafiro

View on GitHub

skills/design/avalonia-layout-zafiro/SKILL.md

More Productivity & Planning skills

View all

Productivity & Planning

brainstorming

Structured design dialogue that validates ideas before implementation begins.

295.4K 385.7K

View

Productivity & Planning

ui-ux-pro-max

Comprehensive design intelligence for web and mobile UI/UX across 10 technology stacks.

133.1K 383.9K

View

Productivity & Planning

writing-plans

Comprehensive implementation plans for multi-step tasks, breaking down specs into bite-sized, testable steps.

295.4K 268K

View

Productivity & Planning

using-superpowers

Introduction to the obra skills system with mandatory skill invocation rules and best practices.

295.4K 259.8K

View

Productivity & Planning

executing-plans

Execute a written implementation plan with critical review and task checkpoints.

295.4K 229.1K

View

Productivity & Planning

dispatching-parallel-agents

Delegate independent tasks to specialized agents working concurrently with isolated context.

295.4K 206.3K

View

Productivity & Planning

using-git-worktrees

Isolated git worktrees with smart directory selection and safety verification.

295.4K 205.2K

View

Productivity & Planning

Toolkit for interacting with and testing local web applications using Playwright. Supports verifying frontend functionality, debugging UI behavior, capturing browser screenshots, and viewing browser logs.

179.7K 170.6K

View