Uno.Themes/README.md

<p align="center">
  <img src="doc/assets/themes-design-systems.png">
</p>

# Uno.Themes

[![Open Uno.Themes in Gitpod](https://gitpod.io/button/open-in-gitpod.svg)](https://gitpod.io/#https://github.com/unoplatform/uno.themes) 
[![Azure DevOps](https://uno-platform.visualstudio.com/Uno%20Platform/_apis/build/status/Uno%20Platform/Uno.Themes%20-%20CI?branchName=master)](https://uno-platform.visualstudio.com/Uno%20Platform/_build/latest?definitionId=89&branchName=master)
[![License](https://img.shields.io/badge/License-Apache%202.0-blue.svg)](LICENSE)

`Uno.Themes` is the repo for add-ons NuGet packages that can be added to any new or existing Uno solution.

It contains two libraries:
- **`Uno Material`** library is designed to help you use [Material Design 3](https://m3.material.io/)
- **`Uno Cupertino`** library is designed to help you use [Cupertino - Human Interface Guideline styling](https://developer.apple.com/design/human-interface-guidelines/). 

Both libraries include:
- Color system for both Light and Dark theme
- Styles for existing WinUI controls like Buttons, TextBox, etc.

Platform support:
- WinUI / UWP
- iOS
- macOS
- Android
- WebAssembly
- Linux (Skia.Gtk)

## Packages

Package|Stable|Preview
-|-|-
Uno.Material|[![NuGet stable](https://img.shields.io/nuget/v/Uno.Material?label=stable)](https://www.nuget.org/packages/Uno.Material)|[![NuGet preview](https://img.shields.io/nuget/vpre/Uno.Material?label=preview)](https://www.nuget.org/packages/Uno.Material)
Uno.Material.WinUI|[![NuGet stable](https://img.shields.io/nuget/v/Uno.Material.WinUI?label=stable)](https://www.nuget.org/packages/Uno.Material.WinUI)|[![NuGet preview](https://img.shields.io/nuget/vpre/Uno.Material.WinUI?label=preview)](https://www.nuget.org/packages/Uno.Material.WinUI)
Uno.Cupertino|[![NuGet stable](https://img.shields.io/nuget/v/Uno.Cupertino?label=stable)](https://www.nuget.org/packages/Uno.Cupertino)|[![NuGet preview](https://img.shields.io/nuget/vpre/Uno.Cupertino?label=preview)](https://www.nuget.org/packages/Uno.Cupertino)
Uno.Cupertino.WinUI|[![NuGet stable](https://img.shields.io/nuget/v/Uno.Cupertino.WinUI?label=stable)](https://www.nuget.org/packages/Uno.Cupertino.WinUI)|[![NuGet preview](https://img.shields.io/nuget/vpre/Uno.Cupertino.WinUI?label=preview)](https://www.nuget.org/packages/Uno.Cupertino.WinUI)


## Getting Started

See the complete [documentation](#documentation) for starting with this library.

For a larger example and features demo, visit the [Uno Gallery](https://github.com/unoplatform/uno.gallery) repository.

## Documentation

All documentation for `Uno.Themes` can be found on our [website](https://platform.uno/docs/articles/external/uno.themes/doc/themes-overview.html).

## Contributing

Please read our [contributing guide](CONTRIBUTING.md) to learn about our development process and how to propose bug fixes and improvements. 
Come visit us on our [Discord Channel #uno-platform](https://discord.gg/eBHZSKG) for help on how to contribute!

Contribute to Uno in your browser using [GitPod.io](https://gitpod.io), follow [our guide here](https://platform.uno/docs/articles/features/working-with-gitpod.html).

Be also mindful of our [Code of Conduct](CODE_OF_CONDUCT.md).

## Acknowledgments
- [Uno Platform](https://platform.uno)
- [Material Design 3](https://m3.material.io/)
- [Material Design](https://material.io/design)
- [Material Design In XAML](https://github.com/MaterialDesignInXAML) as inspiration for UWP ripple effect.
- [Cupertino - Human Interface Guideline styling](https://developer.apple.com/design/human-interface-guidelines)
- [ShowMeTheXaml](https://github.com/Keboo/ShowMeTheXAML) for code snippets. Through [our Fork](https://github.com/unoplatform/ShowMeTheXAML)
- [WinUI](https://microsoft.github.io/microsoft-ui-xaml/)

## License

This project is licensed under the Apache 2.0 license - see the
[LICENSE](LICENSE) file for details.

## Contributors
Thanks go to these wonderful people (List made with [contrib.rocks](https://contrib.rocks)):

[![Uno.Themes Contributors](https://contrib.rocks/image?repo=unoplatform/Uno.Themes)](https://github.com/unoplatform/Uno.Themes/graphs/contributors)

💖 Thank you.