Skip to content

Commit 623b832

Browse files
committed
chore: add README.md, LICENSE and CONTRIBUTING.md
1 parent 5fde88c commit 623b832

File tree

3 files changed

+68
-0
lines changed

3 files changed

+68
-0
lines changed

CONTRIBUTING.md

Lines changed: 15 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,15 @@
1+
# How to Contribute
2+
3+
We encourage you to participate in this open source project. We love pull requests, bug reports, ideas, (security) code reviews or any kind of positive contribution.
4+
5+
However, first of all, make sure that you have correctly configured the [development environment](https://github.com/VMadalin/kotlin-sample-app#environment-setup).
6+
7+
## Code reviews
8+
9+
All submissions, including submissions by project members, require review. We use GitHub pull requests for this purpose. Consult [GitHub Help](https://help.github.com/articles/about-pull-requests/) for more information on using pull requests.
10+
11+
After that create your [pull request](https://github.com/VMadalin/kotlin-sample-app/compare) and complete the template structure adding any information that you consider relevant, to make it easier to identify these changes. It is important user names of commits description.
12+
13+
## Code quality
14+
15+
Once the pull request is created, make sure that it passes the different static analysis checks and tests. Otherwise review the errors in the build and make the necessary changes to correct it.

LICENSE

Lines changed: 21 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,21 @@
1+
MIT License
2+
3+
Copyright (c) 2021 Boisney Philippe
4+
5+
Permission is hereby granted, free of charge, to any person obtaining a copy
6+
of this software and associated documentation files (the "Software"), to deal
7+
in the Software without restriction, including without limitation the rights
8+
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
9+
copies of the Software, and to permit persons to whom the Software is
10+
furnished to do so, subject to the following conditions:
11+
12+
The above copyright notice and this permission notice shall be included in all
13+
copies or substantial portions of the Software.
14+
15+
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
16+
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
17+
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
18+
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
19+
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
20+
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
21+
SOFTWARE.

README.md

Lines changed: 32 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,32 @@
1+
# Android Multi-Module Template
2+
3+
A template for bootstrapping a multi-module android project. It demonstrates clean architecture and has a navigation module based on [this](https://github.com/PhilippeBoisney/android-multi-modules-navigation-demo)
4+
5+
## Top things to learn here
6+
7+
- Multi-module clean architecture
8+
- Kotlin coroutines with Flow
9+
- Dependency injection with Dagger-Hilt
10+
- Unit testing
11+
- View abstracted from Fragment
12+
- API request with Retrofit
13+
- CI/CD with Github actions
14+
- Code lint check with [Ktlint](https://github.com/pinterest/ktlint) using a [gradle plugin](https://github.com/JLLeitschuh/ktlint-gradle)
15+
- Static code analysis with [detekt](https://github.com/detekt/detekt)
16+
- Dependency management with [buildSrc](https://gradle.org/kotlin/) (Kotlin DSL)
17+
- Dependency updates with [buildSrcVersions](https://jmfayard.github.io/refreshVersions/)
18+
19+
## Libraries
20+
21+
- [Material Components](https://github.com/material-components/material-components-android/)
22+
- [Constraint Layout](https://developer.android.com/reference/android/support/constraint/ConstraintLayout)
23+
- [Retrofit](http://square.github.io/retrofit) for REST api communication
24+
- [Mockk](https://github.com/mockk/mockk) for mocking in tests
25+
- [Dagger2](https://github.com/google/dagger) for dependency injection
26+
- [Kotlin Flow](https://kotlinlang.org/docs/reference/coroutines/flow.html) for concurrency
27+
- [ViewModel](https://developer.android.com/topic/libraries/architecture/viewmodel) & [LiveData](https://developer.android.com/topic/libraries/architecture/livedata)
28+
- [Navigation Architecture Component](https://developer.android.com/guide/navigation/navigation-getting-started)
29+
- [ViewBinding](https://developer.android.com/topic/libraries/view-binding)
30+
- [Kotlin Delegates](https://kotlinlang.org/docs/reference/delegated-properties.html)
31+
- [Ktlint gradle plugin](https://github.com/JLLeitschuh/ktlint-gradle) for code lint checks
32+
- [Detekt](https://github.com/detekt/detekt) for static code analysis

0 commit comments

Comments
 (0)