Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/rainbowcake/rainbowcake
A modern Android architecture framework built on Jetpack & Kotlin.
https://github.com/rainbowcake/rainbowcake
architecture jetpack kotlin
Last synced: about 2 months ago
JSON representation
A modern Android architecture framework built on Jetpack & Kotlin.
- Host: GitHub
- URL: https://github.com/rainbowcake/rainbowcake
- Owner: rainbowcake
- License: apache-2.0
- Created: 2019-05-05T10:51:42.000Z (over 5 years ago)
- Default Branch: dev
- Last Pushed: 2023-03-24T23:01:37.000Z (over 1 year ago)
- Last Synced: 2024-07-11T15:49:35.468Z (3 months ago)
- Topics: architecture, jetpack, kotlin
- Language: Kotlin
- Homepage: https://rainbowcake.github.io/
- Size: 829 KB
- Stars: 260
- Watchers: 10
- Forks: 23
- Open Issues: 3
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- License: LICENSE
Awesome Lists containing this project
- awesome-list - rainbowcake/rainbowcake - A modern Android architecture framework built on Jetpack & Kotlin. (Kotlin)
README
# RainbowCake
[**RainbowCake**](https://rainbowcake.github.io/) is an Android architecture framework, providing tools and guidance for building modern Android applications. It builds on top of Jetpack, both in terms of code and ideas.
Some of the main goals of this architecture:
- Give guidance on all aspects of the application, covering not just the View architecture,
- Clearly separate concerns between different layers and components,
- Always keep views in a safe and consistent state with ViewModels,
- Handle configuration changes (and even process death) gracefully,
- Make offloading work to background threads trivial.
While RainbowCake is heavily opinionated, it also encourages you to deviate from it as needed. Feel free to pick and choose the ideas and library artifacts provided according to your own application’s needs!
For more information, see the official documentation on [**rainbowcake.dev**](https://rainbowcake.github.io/).
> **Note:** RainbowCake is stable and maintained, but it's a framework from 2019, so browse and use it with that in mind. You'll find a lot of the same ideas in Google's official [Guide to app architecture](https://developer.android.com/jetpack/guide) as well, which is updated more actively.
### Setup
RainbowCake is available from MavenCentral.
```groovy
repositories {
mavenCentral()
}
```
It ships in several artifacts - feel free to pick and choose from them (for more info, see [Dependencies](https://rainbowcake.github.io/getting-started/dependencies/)):
```groovy
dependencies {
implementation "co.zsmb:rainbow-cake-core:1.6.0" // Core library (required)
implementation "co.zsmb:rainbow-cake-dagger:1.6.0" // Dagger 2 support
implementation "co.zsmb:rainbow-cake-hilt:1.6.0" // Dagger Hilt support
implementation "co.zsmb:rainbow-cake-koin:1.6.0" // Koin support
implementation "co.zsmb:rainbow-cake-navigation:1.6.0" // Navigation features
implementation "co.zsmb:rainbow-cake-timber:1.6.0" // Internal logging through Timber
testImplementation "co.zsmb:rainbow-cake-test:1.6.0" // Testing utilities
}
```
# License
Copyright 2021 Marton Braun
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.