/Avalonia

Develop Desktop, Embedded, Mobile and WebAssembly apps with C# and XAML. The most popular .NET Foundation community project.

Primary LanguageC#MIT LicenseMIT

Star Banner Header

Telegram Build Status Backers on Open Collective Sponsors on Open Collective GitHub Sponsors License
NuGet downloads Size

📖 About

Avalonia is a cross-platform UI framework for dotnet, providing a flexible styling system and supporting a wide range of platforms such as Windows, macOS, Linux, iOS, Android and WebAssembly. Avalonia is mature and production ready and is used by companies, including Schneider Electric, Unity, JetBrains and GitHub.

Considered by many to be the spiritual successor to WPF, Avalonia UI provides a familiar, modern development experience for XAML developers creating cross-platform applications. While Avalonia UI is similar to WPF, it isn't a 1:1 copy, and you'll find plenty of improvements.

For those seeking a cross-platform WPF, we have created Avalonia XPF, enabling WPF applications to run on macOS and Linux with little to no code changes. Avalonia XPF is a commercial product and is licensed per-app, per-platform.

Blog

To see the latest announcements and read about the state of Avalonia, check out the Avalonia UI Blog.

Breaking Changes

You can also see what breaking changes we have planned and what our past breaking changes have been.

Awesome Avalonia

Awesome Avalonia is community-curated list of awesome Avalonia UI tools, libraries, projects and resources. Go and see what people are building with Avalonia!

🚀 Getting Started

See our Get Started guide to begin developing apps with Avalonia UI.

Visual Studio

The Avalonia Visual Studio Extension contains project and control templates that will help you get started, or you can use the .NET Core CLI. For a starter guide see our documentation.

JetBrains Rider

JetBrains Rider now has official support for Avalonia.

Code completion, inspections and refactorings are supported out of the box, for XAML previewer add https://plugins.jetbrains.com/plugins/dev/14839 to plugin repositories and install AvaloniaRider plugin.

Avalonia Packages

Avalonia is delivered via NuGet package manager. You can find the packages here: https://www.nuget.org/packages/Avalonia/

Use these commands in the Package Manager console to install Avalonia manually:

Install-Package Avalonia
Install-Package Avalonia.Desktop

Showcase

Showcase_Banner@3x

See what others have built with Avalonia UI on our Showcase. We welcome submissions!

Bleeding Edge Builds

We also have a nightly build which tracks the current state of master. Although these packages are less stable than the release on NuGet.org, you'll get all the latest features and bugfixes right away and many of our users actually prefer this feed!

Learning

Documentation

Documentation can be found at https://docs.avaloniaui.net.

Tutorials

We also have a tutorial over there for newcomers.

Samples

We have a range of samples to help you get started.

Building and Using

See the build instructions here.

Contributing

This project exists thanks to all the people who contribute.

Please read the contribution guidelines before submitting a pull request.

Code of Conduct

This project has adopted the code of conduct defined by the Contributor Covenant to clarify expected behavior in our community. For more information see the Code of Conduct.

Licence

Avalonia is licenced under the MIT licence.

Donate

Donating to the project is a fantastic way to thank our valued contributors for their hard work. Your donations are shared among our community and awarded for significant contributions.

If you need support see Commercial Support section below.

Donate with BTC or use Open Collective.

BTC: bc1q05wx78qemgy9x6ytl5ljk2xrt00yqargyjm8gx

Backers

Thank you to all our backers! 🙏 [Become a backer]

Commercial Support

We have a range of support plans available for those looking to partner with the creators of Avalonia, enabling access to the best support at every step of the development process.

Please note that donations are not considered payment for commercial support agreements. Please contact us to discuss your needs first. team@avaloniaui.net

Avalonia XPF

Unleash the full potential of your existing WPF apps with our cross-platform UI framework, enabling WPF apps to run on macOS and Linux without requiring expensive and risky rewrites.

GH_Banner