Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/decathlon/vitamin-android
Decathlon Design System UI components for Android applications
https://github.com/decathlon/vitamin-android
android android-library components decathlon design design-system material-design mobile vitamin
Last synced: 2 months ago
JSON representation
Decathlon Design System UI components for Android applications
- Host: GitHub
- URL: https://github.com/decathlon/vitamin-android
- Owner: Decathlon
- License: apache-2.0
- Created: 2021-04-01T15:32:55.000Z (almost 4 years ago)
- Default Branch: main
- Last Pushed: 2023-10-19T14:58:38.000Z (over 1 year ago)
- Last Synced: 2024-11-07T10:41:38.262Z (3 months ago)
- Topics: android, android-library, components, decathlon, design, design-system, material-design, mobile, vitamin
- Language: Kotlin
- Homepage: https://www.decathlon.design
- Size: 2.37 MB
- Stars: 78
- Watchers: 7
- Forks: 21
- Open Issues: 7
-
Metadata Files:
- Readme: README.md
- Contributing: CONTRIBUTING.md
- License: LICENSE
- Code of conduct: CODE_OF_CONDUCT.md
- Codeowners: .github/CODEOWNERS
Awesome Lists containing this project
README
> [!IMPORTANT]
> This current version of Vitamin will no longer evolve and only accept bug fixes from now on. [More details here](https://github.com/Decathlon/vitamin-design/blob/main/IMPORTANT_NOTE.md).
Vitamin Android
Decathlon Design System libraries for android applications
## Introduction
Android Decathlon Design System libraries are based on Material Design components described on the [official
documentation](https://material.io/) and developed in a
[library](https://github.com/material-components/material-components-android) maintained by
Google developers and designers.
But these native components are overridden to respect Decathlon's Visual Identity. You'll find
the design specifications and technical information for supported platforms by Decathlon on
[decathlon.design](https://www.decathlon.design/). If you are interested by a sample,
you can install a demo with `sample` module in the technical project.
## Getting Started
To start using Vitamin in your app, you can check [the Vitamin module documentation](https://github.com/Decathlon/vitamin-android/tree/main/vitamin)
## Artifacts
Group | Description
-- | --
com.decathlon.vitamin.appbars | Build UIs with ready to use AppBars components.
com.decathlon.vitamin.buttons | Build UIs with ready to use Button components.
com.decathlon.vitamin.checkboxes | Build UIs with ready to use Checkbox components.
com.decathlon.vitamin.chips | Build UIs with ready to use Chip components.
com.decathlon.vitamin.dividers | Build UIs with ready to use Divider component.
com.decathlon.vitamin.fabs | Build UIs with ready to use FloatingActionButton components.
com.decathlon.vitamin.foundation | Fundamental components of UI with texts and colors.
com.decathlon.vitamin.foundation-assets | Fundamental components of UI for iconography.
com.decathlon.vitamin.foundation-icons | Fundamental components of UI for assets.
com.decathlon.vitamin.menus | Build UIs with ready to use Menu components.
com.decathlon.vitamin.modals | Build UIs with ready to use Modal components.
com.decathlon.vitamin.prices | Build UIs with ready to use Price component.
com.decathlon.vitamin.progressbars | Build UIs with ready to use Progressbar components.
com.decathlon.vitamin.radiobuttons | Build UIs with ready to use RadioButton components.
com.decathlon.vitamin.ratings | Build UIs with ready to use Rating components.
com.decathlon.vitamin.skeleton | Build UIs with ready to use Skeleton components.
com.decathlon.vitamin.snackbars | Build UIs with ready to use Snackbar component.
com.decathlon.vitamin.switches | Build UIs with ready to use Switch components.
com.decathlon.vitamin.tabs | Build UIs with ready to use Tabs components.
com.decathlon.vitamin.tags | Build UIs with ready to use Tag components.
com.decathlon.vitamin.textinputs | Build UIs with ready to use TextInput components.
com.decathlon.vitamin | Build UIs with ready to use Decathlon's Visual Identity components.
## Download
Release artifacts are available on Maven Central. Check the [release page](https://github.com/Decathlon/vitamin-android/releases)
to know what is the latest release version of Vitamin artifacts.
```kotlin
repositories {
mavenCentral()
}
implementation("com.decathlon.vitamin:vitamin:")
```
If you want to test latest changes merge in `main` branch, you can test Vitamin Android from
snapshot artifacts but we don't recommend to use theses artifacts in production where you can
have regressions or breaking changes until the next official release.
```kotlin
repositories {
maven {
url = uri("https://oss.sonatype.org/content/repositories/snapshots/")
}
}
implementation("com.decathlon.vitamin:vitamin:.0.0-SNAPSHOT")
```
If you have any question about the versioning of this project, you can just read our [documentation](https://github.com/Decathlon/vitamin-android/tree/main/VERSIONING.md)
about it.
## Special thanks
Thank you to the [contributors](https://github.com/Decathlon/vitamin-android/graphs/contributors) involved in these vitamin-android libraries. 💙
Thank you also [Remix Icon](https://remixicon.com) because Vitamix Icons is the official Decathlon icon library based on their [open-source icon library](https://github.com/Remix-Design/RemixIcon) (Remix Design © 2020). This original library is under the license Apache 2.0 and has been modified by Decathlon. [Learn more](https://www.decathlon.design/726f8c765/p/58575f-vitamix-license).
## License
Copyright 2021 Decathlon.
Licensed under the Apache License, Version 2.0 (the "License");
you may not use this file except in compliance with the License.
You may obtain a copy of the License at
http://www.apache.org/licenses/LICENSE-2.0
Unless required by applicable law or agreed to in writing, software
distributed under the License is distributed on an "AS IS" BASIS,
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
See the License for the specific language governing permissions and
limitations under the License.