9 | 🎯 "ToDo" app demonstrates modern Android app development with Jetpack Compose, Hilt, Material3, Coroutines, Flows, Room based on MVVM architecture.
10 |
11 |
12 |
13 |
14 |
15 |
16 |
17 | # Download
18 |
19 | You can download the release app on Google Play Store:
20 |
21 |
22 |
23 |
24 |
25 | # Tech stack
26 |
27 | - [Kotlin](https://kotlinlang.org/): first class programming language for native Android development.
28 | - [Kotlin Coroutines](https://github.com/Kotlin/kotlinx.coroutines): structured concurrency.
29 | - [Kotlin Flows](https://kotlin.github.io/kotlinx.coroutines/kotlinx-coroutines-core/kotlinx.coroutines.flow/): reactive communication.
30 | - [Material3](https://m3.material.io/): modern UI/UX guidelines and components.
31 | - [Jetpack Compose](https://developer.android.com/jetpack/compose): modern, declarative way of building UI in Kotlin.
32 | - [Jetpack Lifecycle](https://developer.android.com/topic/libraries/architecture/lifecycle): observe Android lifecycles and handle UI states upon the lifecycle changes.
33 | - [Jetpack ViewModel](https://developer.android.com/topic/libraries/architecture/viewmodel): manages UI-related data holder and lifecycle aware. Allows data to survive configuration changes such as screen rotations.
34 | - [Jetpack SavedStateHandle](https://developer.android.com/topic/libraries/architecture/viewmodel-savedstate): in case of process death, key-value map that allows to write and retrieve bundle data to and from the saved state.
35 | - [Jetpack DataStore Preferences](https://developer.android.com/topic/libraries/architecture/datastore): uses Kotlin Coroutines and Flows to store data asynchronously, consistently, and transactionally.
36 | - [Room](https://developer.android.com/training/data-storage/room): SQLite abstraction and database solution.
37 | - [Dagger Hilt](https://dagger.dev/hilt/): first class dependency injection for native Android development.
38 | - [Firebase](https://firebase.google.com/): tracks analytics and crashes using the Firebase services.
39 | - [Compose Destinations](https://composedestinations.rafaelcosta.xyz/): a type-safe navigation for composables.
40 | - [Timber](https://github.com/JakeWharton/timber): a logger with a small, extensible API.
41 |
42 | # Architecture
43 |
44 | "ToDo" is based on the MVVM architecture pattern, Repository pattern, Mapper pattern.
45 |
46 |
47 |
48 | # MAD Score
49 |
50 |
51 |
52 |
53 |
54 |
55 | # About
56 |
57 | A beautifully simple ToDo application that emphasises simplicity and ease of use. Whether you want a shopping list, grocery list or you just have lots of things to remember ToDo is built for you. ToDo is fully offline as it does not require internet connection. Also, ToDo is very fast and very light! The size of APK is lighter than 2 MB. It also supports Dark Mode and multiple languages (English, Russian, Uzbek).
58 |
59 | Personally, I use ToDo app to save the urls of articles that I plan to read later. So, I can mark them as completed and everything is tracked also saved in the database. So, ToDo can be used in different situations. I hope it can solve your problem and make your life easier!
60 |
61 | # Features
62 |
63 | - Add, edit and delete tasks.
64 | - Undo deleted tasks.
65 | - Mark tasks as completed. Completed tasks have "Checked/Done" indicator and it is possible to hide them from list.
66 | - Mark tasks as "Important". Important tasks are listed first and they will have red "Warning" indicator.
67 | - Hide completed tasks from the list.
68 | - Sort tasks by name and by created date.
69 | - Your preferences are saved.
70 | - Search for your tasks easily.
71 | - Delete all tasks at once, delete all completed tasks at once, or delete a task by swiping it away.
72 | - Beautiful animations and indicators.
73 | - Dark/Light theme support.
74 | - Dynamic theme support.
75 | - Multiple language support.
76 | - Multiple screen sizes support.
77 | - Light that is less than 2 MB.
78 | - Works without the internet.
79 | - Simplicity that has only five screens.
80 | - Adaptive screens that change according to screen orientation.
81 | - Completely robust to process death.
82 | - Completely robust to configuration change.
83 |
84 | # License
85 |
86 | ```xml
87 | Designed and developed by raheemadamboev (Raheem) 2022.
88 |
89 | Licensed under the Apache License, Version 2.0 (the "License");
90 | you may not use this file except in compliance with the License.
91 | You may obtain a copy of the License at
92 |
93 | http://www.apache.org/licenses/LICENSE-2.0
94 |
95 | Unless required by applicable law or agreed to in writing, software
96 | distributed under the License is distributed on an "AS IS" BASIS,
97 | WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
98 | See the License for the specific language governing permissions and
99 | limitations under the License.
100 | ```
101 |
--------------------------------------------------------------------------------
/gradlew:
--------------------------------------------------------------------------------
1 | #!/usr/bin/env sh
2 |
3 | ##############################################################################
4 | ##
5 | ## Gradle start up script for UN*X
6 | ##
7 | ##############################################################################
8 |
9 | # Attempt to set APP_HOME
10 | # Resolve links: $0 may be a link
11 | PRG="$0"
12 | # Need this for relative symlinks.
13 | while [ -h "$PRG" ] ; do
14 | ls=`ls -ld "$PRG"`
15 | link=`expr "$ls" : '.*-> \(.*\)$'`
16 | if expr "$link" : '/.*' > /dev/null; then
17 | PRG="$link"
18 | else
19 | PRG=`dirname "$PRG"`"/$link"
20 | fi
21 | done
22 | SAVED="`pwd`"
23 | cd "`dirname \"$PRG\"`/" >/dev/null
24 | APP_HOME="`pwd -P`"
25 | cd "$SAVED" >/dev/null
26 |
27 | APP_NAME="Gradle"
28 | APP_BASE_NAME=`basename "$0"`
29 |
30 | # Add default JVM options here. You can also use JAVA_OPTS and GRADLE_OPTS to pass JVM options to this script.
31 | DEFAULT_JVM_OPTS=""
32 |
33 | # Use the maximum available, or set MAX_FD != -1 to use that value.
34 | MAX_FD="maximum"
35 |
36 | warn () {
37 | echo "$*"
38 | }
39 |
40 | die () {
41 | echo
42 | echo "$*"
43 | echo
44 | exit 1
45 | }
46 |
47 | # OS specific support (must be 'true' or 'false').
48 | cygwin=false
49 | msys=false
50 | darwin=false
51 | nonstop=false
52 | case "`uname`" in
53 | CYGWIN* )
54 | cygwin=true
55 | ;;
56 | Darwin* )
57 | darwin=true
58 | ;;
59 | MINGW* )
60 | msys=true
61 | ;;
62 | NONSTOP* )
63 | nonstop=true
64 | ;;
65 | esac
66 |
67 | CLASSPATH=$APP_HOME/gradle/wrapper/gradle-wrapper.jar
68 |
69 | # Determine the Java command to use to start the JVM.
70 | if [ -n "$JAVA_HOME" ] ; then
71 | if [ -x "$JAVA_HOME/jre/sh/java" ] ; then
72 | # IBM's JDK on AIX uses strange locations for the executables
73 | JAVACMD="$JAVA_HOME/jre/sh/java"
74 | else
75 | JAVACMD="$JAVA_HOME/bin/java"
76 | fi
77 | if [ ! -x "$JAVACMD" ] ; then
78 | die "ERROR: JAVA_HOME is set to an invalid directory: $JAVA_HOME
79 |
80 | Please set the JAVA_HOME variable in your environment to match the
81 | location of your Java installation."
82 | fi
83 | else
84 | JAVACMD="java"
85 | which java >/dev/null 2>&1 || die "ERROR: JAVA_HOME is not set and no 'java' command could be found in your PATH.
86 |
87 | Please set the JAVA_HOME variable in your environment to match the
88 | location of your Java installation."
89 | fi
90 |
91 | # Increase the maximum file descriptors if we can.
92 | if [ "$cygwin" = "false" -a "$darwin" = "false" -a "$nonstop" = "false" ] ; then
93 | MAX_FD_LIMIT=`ulimit -H -n`
94 | if [ $? -eq 0 ] ; then
95 | if [ "$MAX_FD" = "maximum" -o "$MAX_FD" = "max" ] ; then
96 | MAX_FD="$MAX_FD_LIMIT"
97 | fi
98 | ulimit -n $MAX_FD
99 | if [ $? -ne 0 ] ; then
100 | warn "Could not set maximum file descriptor limit: $MAX_FD"
101 | fi
102 | else
103 | warn "Could not query maximum file descriptor limit: $MAX_FD_LIMIT"
104 | fi
105 | fi
106 |
107 | # For Darwin, add options to specify how the application appears in the dock
108 | if $darwin; then
109 | GRADLE_OPTS="$GRADLE_OPTS \"-Xdock:name=$APP_NAME\" \"-Xdock:icon=$APP_HOME/media/gradle.icns\""
110 | fi
111 |
112 | # For Cygwin, switch paths to Windows format before running java
113 | if $cygwin ; then
114 | APP_HOME=`cygpath --path --mixed "$APP_HOME"`
115 | CLASSPATH=`cygpath --path --mixed "$CLASSPATH"`
116 | JAVACMD=`cygpath --unix "$JAVACMD"`
117 |
118 | # We build the pattern for arguments to be converted via cygpath
119 | ROOTDIRSRAW=`find -L / -maxdepth 1 -mindepth 1 -type d 2>/dev/null`
120 | SEP=""
121 | for dir in $ROOTDIRSRAW ; do
122 | ROOTDIRS="$ROOTDIRS$SEP$dir"
123 | SEP="|"
124 | done
125 | OURCYGPATTERN="(^($ROOTDIRS))"
126 | # Add a user-defined pattern to the cygpath arguments
127 | if [ "$GRADLE_CYGPATTERN" != "" ] ; then
128 | OURCYGPATTERN="$OURCYGPATTERN|($GRADLE_CYGPATTERN)"
129 | fi
130 | # Now convert the arguments - kludge to limit ourselves to /bin/sh
131 | i=0
132 | for arg in "$@" ; do
133 | CHECK=`echo "$arg"|egrep -c "$OURCYGPATTERN" -`
134 | CHECK2=`echo "$arg"|egrep -c "^-"` ### Determine if an option
135 |
136 | if [ $CHECK -ne 0 ] && [ $CHECK2 -eq 0 ] ; then ### Added a condition
137 | eval `echo args$i`=`cygpath --path --ignore --mixed "$arg"`
138 | else
139 | eval `echo args$i`="\"$arg\""
140 | fi
141 | i=$((i+1))
142 | done
143 | case $i in
144 | (0) set -- ;;
145 | (1) set -- "$args0" ;;
146 | (2) set -- "$args0" "$args1" ;;
147 | (3) set -- "$args0" "$args1" "$args2" ;;
148 | (4) set -- "$args0" "$args1" "$args2" "$args3" ;;
149 | (5) set -- "$args0" "$args1" "$args2" "$args3" "$args4" ;;
150 | (6) set -- "$args0" "$args1" "$args2" "$args3" "$args4" "$args5" ;;
151 | (7) set -- "$args0" "$args1" "$args2" "$args3" "$args4" "$args5" "$args6" ;;
152 | (8) set -- "$args0" "$args1" "$args2" "$args3" "$args4" "$args5" "$args6" "$args7" ;;
153 | (9) set -- "$args0" "$args1" "$args2" "$args3" "$args4" "$args5" "$args6" "$args7" "$args8" ;;
154 | esac
155 | fi
156 |
157 | # Escape application args
158 | save () {
159 | for i do printf %s\\n "$i" | sed "s/'/'\\\\''/g;1s/^/'/;\$s/\$/' \\\\/" ; done
160 | echo " "
161 | }
162 | APP_ARGS=$(save "$@")
163 |
164 | # Collect all arguments for the java command, following the shell quoting and substitution rules
165 | eval set -- $DEFAULT_JVM_OPTS $JAVA_OPTS $GRADLE_OPTS "\"-Dorg.gradle.appname=$APP_BASE_NAME\"" -classpath "\"$CLASSPATH\"" org.gradle.wrapper.GradleWrapperMain "$APP_ARGS"
166 |
167 | # by default we should be in the correct project dir, but when run from Finder on Mac, the cwd is wrong
168 | if [ "$(uname)" = "Darwin" ] && [ "$HOME" = "$PWD" ]; then
169 | cd "$(dirname "$0")"
170 | fi
171 |
172 | exec "$JAVACMD" "$@"
173 |
--------------------------------------------------------------------------------
/.idea/codeStyles/Project.xml:
--------------------------------------------------------------------------------
1 |
2 |
3 |
4 |
37 |
38 |
39 |
40 |
41 |
42 |
43 |
44 |
45 |
46 |
47 |
48 |
49 |
50 |
51 |
52 | xmlns:android
53 |
54 | ^$
55 |
56 |
57 |
58 |
59 |
60 |
61 |
62 |
63 | xmlns:.*
64 |
65 | ^$
66 |
67 |
68 | BY_NAME
69 |
70 |
71 |
72 |
73 |
74 |
75 | .*:id
76 |
77 | http://schemas.android.com/apk/res/android
78 |
79 |
80 |
81 |
82 |
83 |
84 |
85 |
86 | .*:name
87 |
88 | http://schemas.android.com/apk/res/android
89 |
90 |
91 |
92 |
93 |
94 |
95 |
96 |
97 | name
98 |
99 | ^$
100 |
101 |
102 |
103 |
104 |
105 |
106 |
107 |
108 | style
109 |
110 | ^$
111 |
112 |
113 |
114 |
115 |
116 |
117 |
118 |
119 | .*
120 |
121 | ^$
122 |
123 |
124 | BY_NAME
125 |
126 |
127 |
128 |
129 |
130 |
131 | .*
132 |
133 | http://schemas.android.com/apk/res/android
134 |
135 |
136 | ANDROID_ATTRIBUTE_ORDER
137 |
138 |
139 |
140 |
141 |
142 |
143 | .*
144 |
145 | .*
146 |
147 |
148 | BY_NAME
149 |
150 |
151 |
152 |
153 |
154 |
155 |
156 |
157 |
158 |
159 |
--------------------------------------------------------------------------------
/app/src/main/res/drawable/ic_launcher_background.xml:
--------------------------------------------------------------------------------
1 |
2 |
7 |
10 |
15 |
20 |
25 |
30 |
35 |
40 |
45 |
50 |
55 |
60 |
65 |
70 |
75 |
80 |
85 |
90 |
95 |
100 |
105 |
110 |
115 |
120 |
125 |
130 |
135 |
140 |
145 |
150 |
155 |
160 |
165 |
170 |
171 |
--------------------------------------------------------------------------------
/app/src/main/java/xyz/teamgravity/todo/presentation/screen/support/SupportPortraitScreen.kt:
--------------------------------------------------------------------------------
1 | package xyz.teamgravity.todo.presentation.screen.support
2 |
3 | import androidx.compose.foundation.Image
4 | import androidx.compose.foundation.background
5 | import androidx.compose.foundation.layout.Arrangement
6 | import androidx.compose.foundation.layout.Column
7 | import androidx.compose.foundation.layout.Row
8 | import androidx.compose.foundation.layout.Spacer
9 | import androidx.compose.foundation.layout.WindowInsets
10 | import androidx.compose.foundation.layout.fillMaxHeight
11 | import androidx.compose.foundation.layout.fillMaxSize
12 | import androidx.compose.foundation.layout.fillMaxWidth
13 | import androidx.compose.foundation.layout.height
14 | import androidx.compose.foundation.layout.padding
15 | import androidx.compose.foundation.layout.safeDrawing
16 | import androidx.compose.foundation.layout.statusBars
17 | import androidx.compose.foundation.layout.width
18 | import androidx.compose.foundation.layout.windowInsetsTopHeight
19 | import androidx.compose.material.icons.Icons
20 | import androidx.compose.material.icons.automirrored.rounded.ArrowBack
21 | import androidx.compose.material3.MaterialTheme
22 | import androidx.compose.material3.Scaffold
23 | import androidx.compose.material3.Text
24 | import androidx.compose.runtime.Composable
25 | import androidx.compose.ui.Alignment
26 | import androidx.compose.ui.Modifier
27 | import androidx.compose.ui.layout.ContentScale
28 | import androidx.compose.ui.platform.LocalContext
29 | import androidx.compose.ui.res.painterResource
30 | import androidx.compose.ui.res.stringResource
31 | import androidx.compose.ui.text.font.FontWeight
32 | import androidx.compose.ui.text.style.TextAlign
33 | import androidx.compose.ui.unit.dp
34 | import androidx.compose.ui.unit.sp
35 | import xyz.teamgravity.coresdkcompose.button.IconButtonPlain
36 | import xyz.teamgravity.todo.R
37 | import xyz.teamgravity.todo.core.util.Helper
38 | import xyz.teamgravity.todo.presentation.component.card.CardConnection
39 | import xyz.teamgravity.todo.presentation.theme.White
40 |
41 | @Composable
42 | fun SupportPortraitScreen(
43 | onBackButtonClick: () -> Unit
44 | ) {
45 | val context = LocalContext.current
46 |
47 | Scaffold(
48 | topBar = {
49 | Column(
50 | modifier = Modifier
51 | .fillMaxWidth()
52 | .background(MaterialTheme.colorScheme.primary)
53 | ) {
54 | Spacer(
55 | modifier = Modifier.windowInsetsTopHeight(WindowInsets.statusBars)
56 | )
57 | Row(
58 | verticalAlignment = Alignment.CenterVertically,
59 | modifier = Modifier
60 | .fillMaxWidth()
61 | .padding(12.dp)
62 | ) {
63 | IconButtonPlain(
64 | onClick = onBackButtonClick,
65 | icon = Icons.AutoMirrored.Rounded.ArrowBack,
66 | contentDescription = R.string.cd_back_button,
67 | tint = White
68 | )
69 | Text(
70 | text = stringResource(id = R.string.need_help),
71 | textAlign = TextAlign.Center,
72 | fontSize = 18.sp,
73 | color = White,
74 | modifier = Modifier.weight(1F)
75 | )
76 | Spacer(
77 | modifier = Modifier.width(38.dp)
78 | )
79 | }
80 | Image(
81 | painter = painterResource(id = R.drawable.sticker_customer_service),
82 | contentDescription = stringResource(id = R.string.cd_user_support),
83 | contentScale = ContentScale.Fit,
84 | alignment = Alignment.Center,
85 | modifier = Modifier
86 | .fillMaxWidth()
87 | .fillMaxHeight(0.2F)
88 | )
89 | }
90 | },
91 | contentWindowInsets = WindowInsets.safeDrawing
92 | ) { padding ->
93 | Column(
94 | modifier = Modifier
95 | .fillMaxSize()
96 | .padding(padding)
97 | .padding(horizontal = 16.dp)
98 | ) {
99 | Column(
100 | verticalArrangement = Arrangement.SpaceEvenly,
101 | modifier = Modifier
102 | .fillMaxWidth()
103 | .weight(1F)
104 | ) {
105 | Text(
106 | text = stringResource(id = R.string.connect_us),
107 | textAlign = TextAlign.Center,
108 | fontSize = 24.sp,
109 | fontWeight = FontWeight.Bold,
110 | modifier = Modifier.fillMaxWidth()
111 | )
112 | Text(
113 | text = stringResource(id = R.string.connect_us_body),
114 | textAlign = TextAlign.Center,
115 | style = MaterialTheme.typography.bodyMedium,
116 | modifier = Modifier.fillMaxWidth()
117 | )
118 | }
119 | CardConnection(
120 | onClick = {
121 | Helper.connectViaTelegram(context)
122 | },
123 | icon = R.drawable.ic_telegram,
124 | title = R.string.via_telegram,
125 | contentDescription = R.string.cd_via_telegram,
126 | fillMaxSize = true,
127 | modifier = Modifier
128 | .fillMaxWidth()
129 | .weight(1F)
130 | )
131 | Spacer(
132 | modifier = Modifier.height(20.dp)
133 | )
134 | CardConnection(
135 | onClick = {
136 | Helper.connectViaEmail(context)
137 | },
138 | icon = R.drawable.ic_email,
139 | title = R.string.via_email,
140 | contentDescription = R.string.cd_via_email,
141 | fillMaxSize = true,
142 | modifier = Modifier
143 | .fillMaxWidth()
144 | .weight(1F)
145 | )
146 | Spacer(
147 | modifier = Modifier.height(20.dp)
148 | )
149 | }
150 | }
151 | }
--------------------------------------------------------------------------------
5 | 
6 | 
15 | 
23 |
24 |
25 | # Tech stack
26 |
27 | - [Kotlin](https://kotlinlang.org/): first class programming language for native Android development.
28 | - [Kotlin Coroutines](https://github.com/Kotlin/kotlinx.coroutines): structured concurrency.
29 | - [Kotlin Flows](https://kotlin.github.io/kotlinx.coroutines/kotlinx-coroutines-core/kotlinx.coroutines.flow/): reactive communication.
30 | - [Material3](https://m3.material.io/): modern UI/UX guidelines and components.
31 | - [Jetpack Compose](https://developer.android.com/jetpack/compose): modern, declarative way of building UI in Kotlin.
32 | - [Jetpack Lifecycle](https://developer.android.com/topic/libraries/architecture/lifecycle): observe Android lifecycles and handle UI states upon the lifecycle changes.
33 | - [Jetpack ViewModel](https://developer.android.com/topic/libraries/architecture/viewmodel): manages UI-related data holder and lifecycle aware. Allows data to survive configuration changes such as screen rotations.
34 | - [Jetpack SavedStateHandle](https://developer.android.com/topic/libraries/architecture/viewmodel-savedstate): in case of process death, key-value map that allows to write and retrieve bundle data to and from the saved state.
35 | - [Jetpack DataStore Preferences](https://developer.android.com/topic/libraries/architecture/datastore): uses Kotlin Coroutines and Flows to store data asynchronously, consistently, and transactionally.
36 | - [Room](https://developer.android.com/training/data-storage/room): SQLite abstraction and database solution.
37 | - [Dagger Hilt](https://dagger.dev/hilt/): first class dependency injection for native Android development.
38 | - [Firebase](https://firebase.google.com/): tracks analytics and crashes using the Firebase services.
39 | - [Compose Destinations](https://composedestinations.rafaelcosta.xyz/): a type-safe navigation for composables.
40 | - [Timber](https://github.com/JakeWharton/timber): a logger with a small, extensible API.
41 |
42 | # Architecture
43 |
44 | "ToDo" is based on the MVVM architecture pattern, Repository pattern, Mapper pattern.
45 |
46 | 
47 |
48 | # MAD Score
49 |
50 | 
52 | 
53 |