Skip to content

Commit c9eb2d4

Browse files
authored
Merge pull request #38 from yml-org/doc/updated_readme
Update README.md
2 parents 9a819c3 + 0db5e39 commit c9eb2d4

File tree

1 file changed

+26
-26
lines changed

1 file changed

+26
-26
lines changed

README.md

Lines changed: 26 additions & 26 deletions
Original file line numberDiff line numberDiff line change
@@ -1,31 +1,31 @@
1-
YTemplate
1+
Y—Template
22
==================
3-
YTemplate aims to build your initial setup for your Android project quickly. The project provides you organised structures following MVVM architecture and also provides dependencies to support major functionalities which an Android project needs
3+
Y—Template aims to build your initial setup for your Android project quickly. The project provides you organised structures following MVVM architecture and also provides dependencies to support major functionalities which an Android project needs
44

55
The project includes a shell script file `YTemplate.sh` which renames and restructures the Android project based on the package name, model name and application name the Android project needs.
66

7-
### How to run the YTemplate script
8-
- The script file `YTemplate.sh` takes two inputs
9-
- `<package_name>` is your app ID and should be in lower case.
10-
- `<application_name>` Optional input
11-
- `./YTemplate.sh <package_name> <application_name>`
7+
### How to run the Y—Template script
8+
- The script file `YTemplate.sh` takes two inputs.
9+
- `<package_name>` is your app ID and should be in lower-case.
10+
- `<application_name>` Optional input.
11+
- `./YTemplate.sh <package_name> <application_name>`.
1212

1313
Note: To run the shell script on Windows, one can run bash on ubuntu in Windows(starting from Windows 10).
14-
Type ` bash YTemplate.sh <package_name> <data_base_entity> <application_name>`. It will execute the script
14+
Type ` bash YTemplate.sh <package_name> <data_base_entity> <application_name>`. It will execute the script.
1515

1616

1717
## Features
18-
* Compose UI
19-
* HILT dependency for dependency injection
20-
* Jetpack navigation
21-
* Version catalog support for handling dependencies
22-
* MVVM architecture
23-
* Room database support for Local database
24-
* Ktor for remote database connection
25-
* Jacoco support for test report generation
18+
* Compose UI.
19+
* HILT dependency for dependency injection.
20+
* Jetpack navigation.
21+
* Version catalog support for handling dependencies.
22+
* MVVM architecture.
23+
* Room database support for Local database.
24+
* Ktor for remote database connection.
25+
* Jacoco support for test report generation.
2626

2727
### Architecture
28-
YTemplate follows MVVM architecture. Different modules support different layers of MVVM architecture.
28+
Y—Template follows MVVM architecture. Different modules support different layers of MVVM architecture.
2929

3030
##### Multi-Module
3131
* `app` : Entry point for the app. Provides basic structures such as Application classes, Navigation components.
@@ -38,29 +38,29 @@ YTemplate follows MVVM architecture. Different modules support different layers
3838

3939
##### Single-Module
4040
* `app` : Module to add various features to the app and providing basic structures such as Application classes, Navigation components. This is a combined version of app and feature module of Multi-module architecture.
41-
* `domain`(optional) : Package structure which can be added under app module which would contain domain/use case files. This is similar to core/domain in multi-module
41+
* `domain`(optional) : Package structure that can be added under app module which would contain domain/use case files. This is similar to core/domain in multi-module
4242
* `data` : Package structure to handle the data layer placed under the app module. This is similar to core/data in multi-module
43-
* `buildSrc` : Module containing complex build logic encapsulated as custom task.
43+
* `buildSrc` : Module containing complex build logic encapsulated as a custom task.
4444

4545
![](singleModuleArchitecture.png)
4646

4747
### How to generate test report
4848
- Generating jacoco test report
4949
- Gradle command `clean build createMergedJacocoReport`
50-
- From android studio
51-
- Open gradle menu bar from android studio right side panel
50+
- From Android Studio
51+
- Open gradle menu bar from Android Studio right side panel
5252
- Click on the gradle icon and
5353
- In command popup window type `clean build createMergedJacocoReport` and press enter
5454
- Wait for the execution completion,
5555
- After successful execution each module level execution report will be stored in 'module\build\reports\jacoco\html\index.html'.
5656

5757
### How to generate dokka report
58-
- Gradle command single module `clean build dokkaHtml` for multi module `clean build dokkaHtmlMultiModule`
59-
- From android studio
60-
- Open gradle menu bar from android studio right side panel
58+
- Gradle command single module `clean build dokkaHtml` for multi-module `clean build dokkaHtmlMultiModule`
59+
- From Android Studio
60+
- Open gradle menu bar from Android Studio right-side panel
6161
- Click on the gradle icon and
62-
- In command popup window type `dokkaHtml` for multi module `dokkaHtmlMultiModule`
62+
- In the command popup window type `dokkaHtml` for multi-module `dokkaHtmlMultiModule`
6363

64-
### How to check KTLint
64+
### How to check Ktlint
6565
- Gradle command for checking lint error `ktlintCheck`
6666
- Gradle command for formatting code `ktlintFormat`

0 commit comments

Comments
 (0)