material: initial readme and contribution setup (https://github.com/slint-ui/material-components/issues/6)

Imported from 8000c74b82
This commit is contained in:
FloVanGH 2025-06-12 12:27:17 +02:00 committed by Olivier Goffart
parent af8919a283
commit 5790239c99
3 changed files with 75 additions and 0 deletions

View file

@ -7,3 +7,5 @@ package-lock.json
.vscode/settings.json
licenses/output
*.bak
target/
Cargo.lock

View file

@ -0,0 +1,27 @@
<!-- Copyright © SixtyFPS GmbH <info@slint.dev> ; SPDX-License-Identifier: MIT -->
# Contributing
We warmly welcome contributions to the project. Let's discuss ideas or questions
in [Github discussions](https://github.com/slint-ui/material-components/discussions).
Please feel welcome to open GitHub issues or pull requests.
Use 👍 reaction on issue that you consider important.
Issues which we think are suitable for new contributors are tagged with
https://github.com/slint-ui/material-components/labels/good%20first%20issue.
## Contributor License Agreement
All contributions are accepted under the terms of the MIT No Attribution License.
Please note that you must have written the contribution 100% yourself and that
no rights have been transferred to third parties (e.g. your employer).
In any other case, please let us know.
When opening a pull request, you will be asked to sign a
[Contributor License Agreement (CLA)](https://cla-assistant.io/slint-ui/material-components).
## Coding Style
For the Rust portion of the code base, the CI enforces the coding style via rustfmt.

View file

@ -1,2 +1,48 @@
<!-- Copyright © SixtyFPS GmbH <info@slint.dev> ; SPDX-License-Identifier: MIT -->
# Material Design 3 component set for Slint
Welcome to the official Material Design 3 component set for [Slint](https://slint.dev). This repository provides a collection of UI components that adhere to [Material Design 3 guidelines](https://m3.material.io/).
The components are intended to use for development of user interfaces with Slint for Android apps, touch friendly interfaces for embedded devices and even for desktop application development.
Contributions and feedback from the community are welcome.
[![Build status](https://github.com/slint-ui/material-components/actions/workflows/autofix.yaml/badge.svg)](https://github.com/slint-ui/material-components/actions/workflows/autofix.yaml)
[![REUSE status](https://api.reuse.software/badge/github.com/slint-ui/material-components)](https://api.reuse.software/info/github.com/slint-ui/slint)
[![Discussions](https://img.shields.io/github/discussions/slint-ui/material-components)](https://github.com/slint-ui/material-components/discussions)
## Examples
| Gallery |
| --------------------------------------------------------------------------------------------------------- |
| [Gallery![Gallery image](https://github.com/user-attachments/assets/e8031b78-4e7e-42fe-b34d-ef81a10defbe)](examples/gallery) |
## Contributions
We welcome your contributions: in the form of code, bug reports or feedback.
For contribution guidelines see [CONTRIBUTING.md](CONTRIBUTING.md).
## About us (SixtyFPS GmbH)
We are passionate about software - API design, cross-platform software
development and user interface components. Our aim is to make developing user
interfaces fun for everyone: from Python, JavaScript, C++, or Rust developers all the
way to UI/UX designers. We believe that software grows organically and keeping
it open source is the best way to sustain that growth. Our team members are
located remotely in Germany, Finland, and US.
### Stay up to date
- Follow [@slint_ui](https://twitter.com/slint_ui) on X/Twitter.
- Follow [@slint@fosstodon.org](https://mastodon.social/@slint@fosstodon.org) on Mastodon.
- Follow [@slint-ui](https://www.linkedin.com/company/slint-ui/) on LinkedIn.
- Follow [@slint.dev](https://bsky.app/profile/slint.dev) on Bluesky
- Subscribe to our [YouTube channel](https://www.youtube.com/@Slint-UI)
### Contact us
Feel free to join [Github discussions](https://github.com/slint-ui/material-components/discussions)
for general chat or questions. Use [Github issues](https://github.com/slint-ui/material-components/issues)
to report public suggestions or bugs.
We chat in [our Mattermost instance](https://chat.slint.dev) where you are
welcome to listen in or ask your questions.