# Kotlin Mobile 101

> Kotlin, Compose Multiplatform, MVVM + Koin + a screen state machine: build an app with real architecture that runs on both Android and iOS.

- URL: https://dantech.academy/en/courses/kotlin-mobile-101
- Instructor: Dan Tech
- Curriculum: 22 lessons
- Tiếng Việt: https://dantech.academy/courses/kotlin-mobile-101.md

Entry course for Kotlin Multiplatform beginners: Kotlin and Compose Multiplatform, three MVVM layers, inject dependencies with Koin, navigate with a screen state machine, and persist local data. You read and modify a complete Kotlin Multiplatform app, run it on a real device, and you can explain why every line sits where it does.

## Prerequisites

- Newbie
- Laptop (macOS to run iOS)
- 1h/Day

## Skills

- Kotlin essentials
- Compose Multiplatform
- MVVM Architecture
- Koin DI
- State machine
- Local persistence

## Curriculum

For AI agents: every lesson has a Markdown version at its URL plus `.md`. Free lessons return the full text; lessons for enrolled students return their objectives and outline.

### Setup and First Run

a clean KMP toolchain, an app running on both Android and iOS, Git checkpoints and an AI pair with a rules file.

- [Android Studio, JDK và KMP plugin](https://dantech.academy/en/courses/kotlin-mobile-101/00-setup-first-run/lesson-01-install-android-studio.md) (free): JDK 17+, Android Studio stable, plugin Kotlin Multiplatform, Xcode nếu bạn dùng macOS, và kdoctor để kiểm tra máy.
- [App KMP đầu tiên trên Android và iOS](https://dantech.academy/en/courses/kotlin-mobile-101/00-setup-first-run/lesson-02-first-app-on-device.md) (free): Tạo một project Compose Multiplatform tối giản, chạy nó trên máy thật, và đọc được ba source set commonMain / androidMain / iosMain.
- [Clone TicTac, Git checkpoint và rules file cho AI](https://dantech.academy/en/courses/kotlin-mobile-101/00-setup-first-run/lesson-03-git-checkpoints-ai-pair.md) (free): Clone repo TicTac, chạy nó trên Android, tạo branch cá nhân, và viết rules file pin đúng stack để AI không gợi ý code Android thuần.

### Just Enough Kotlin

null safety, lambdas, data classes and sealed interfaces, collections, coroutines and Flow.

- [Null safety, biến và hàm](https://dantech.academy/en/courses/kotlin-mobile-101/01-kotlin-essentials/lesson-01-null-safety-and-functions.md): val và var, kiểu nullable, các operator ?. ?: !!, tham số mặc định và tham số có tên, lambda, extension function - đọc trên code thật của TicTac.
- [Data class, enum và sealed interface](https://dantech.academy/en/courses/kotlin-mobile-101/01-kotlin-essentials/lesson-02-data-and-sealed-classes.md): data class cho giá trị bất biến, enum cho tập lựa chọn cố định, sealed interface cho trạng thái nhiều nhánh, when exhaustive - đọc trên code thật của TicTac.
- [Collections, coroutines và StateFlow](https://dantech.academy/en/courses/kotlin-mobile-101/01-kotlin-essentials/lesson-03-collections-and-coroutines.md): filter, map, count, any/none/all, take; suspend và coroutine scope cho việc mất thời gian; StateFlow cho dữ liệu đổi theo thời gian.

### Compose Fundamentals

composables, layout, Modifier, state and recomposition, board grids and selection rows.

- [Composable, layout và Modifier](https://dantech.academy/en/courses/kotlin-mobile-101/02-compose-essentials/lesson-01-composables-and-layout.md): Composable Function, ba khối layout Column Row Box, thứ tự Modifier quyết định kết quả, và cách TicTac dựng giao diện dùng chung cho Android lẫn iOS.
- [State, recomposition và state hoisting](https://dantech.academy/en/courses/kotlin-mobile-101/02-compose-essentials/lesson-02-state-and-recomposition.md): Recomposition, remember và khóa của nó, collectAsStateWithLifecycle, và state hoisting đẩy tới tận cùng như TicTac làm.
- [Lưới và lựa chọn](https://dantech.academy/en/courses/kotlin-mobile-101/02-compose-essentials/lesson-03-grid-and-selection.md): Dựng lưới bàn cờ bằng Column, Row và repeat; dựng hàng chip chọn từ enum.entries; và điều kiện để phải đổi sang lazy layout.

### MVVM

Model, ViewModel and View - a boundary you can verify with grep, and state derived instead of stored twice.

- [MVVM và phụ thuộc một chiều](https://dantech.academy/en/courses/kotlin-mobile-101/03-mvvm/lesson-01-why-mvvm-and-three-layers.md): Ba giới hạn của state trong composable, trách nhiệm của Model, ViewModel, View, và cách chứng minh ranh giới bằng chính cấu trúc package của TicTac.
- [Model và state riêng cho từng màn hình](https://dantech.academy/en/courses/kotlin-mobile-101/03-mvvm/lesson-02-model-and-ui-state.md): Sealed interface thay cho cờ boolean rời rạc, mỗi màn hình một state chỉ chứa thứ nó vẽ, và property get() suy ra thay vì lưu trùng dữ liệu.
- [ViewModel với StateFlow](https://dantech.academy/en/courses/kotlin-mobile-101/03-mvvm/lesson-03-viewmodel-with-stateflow.md): Cặp _round / round, init{} nạp dữ liệu một lần, Channel CONFLATED gộp lệnh lưu, và hủy timer khi rời màn hình đang chơi.

### Koin and Dependency Injection

Koin modules and two lifetimes, binding to contracts, and one Gradle command covering the whole graph.

- [Koin căn bản: single và viewModel](https://dantech.academy/en/courses/kotlin-mobile-101/04-koin-di/lesson-01-koin-basics.md): Vấn đề mà dependency injection giải, hai vòng đời single và viewModel, và vì sao initKoin() phải gọi ngoài composition.
- [Dependency injection: get(), bind theo contract và call site](https://dantech.academy/en/courses/kotlin-mobile-101/04-koin-di/lesson-02-injecting-dependencies.md): get() để Koin tự lắp đồ thị, bind theo contract để không ai biết lớp cụ thể, và koinViewModel() ở đúng một chỗ trong cây Compose.
- [Vòng đời và test đồ thị](https://dantech.academy/en/courses/kotlin-mobile-101/04-koin-di/lesson-03-scoping-and-testing.md): Thay kho thật bằng MapSettings trong test, resolve từng nút của đồ thị, và assertSame để chứng minh single thật sự dùng chung.

### Screen State Machine

a five-screen state machine instead of a navigation library, one shared ViewModel, and expect/actual wiring the system back button.

- [Điều hướng bằng screen state machine](https://dantech.academy/en/courses/kotlin-mobile-101/05-navigation/lesson-01-screen-state-machine.md): enum Screen cộng một when trong AppHost thay cho thư viện điều hướng, và ba điều kiện để biết khi nào mô hình phẳng này không còn đủ.
- [Mỗi màn một ViewModel, dữ liệu dùng chung một chỗ](https://dantech.academy/en/courses/kotlin-mobile-101/05-navigation/lesson-02-one-viewmodel-five-screens.md): ViewModel riêng cho từng màn hình, dữ liệu dùng chung nằm trong các single của Koin thay cho tham số truyền qua route, và mặt trái: ván đang chơi vẫn sống khi bạn đã sang màn khác.
- [expect/actual và nút back của hệ thống](https://dantech.academy/en/courses/kotlin-mobile-101/05-navigation/lesson-03-system-back-handler.md): Một khai báo chung, mỗi nền tảng một hiện thực: nối nút back Android vào state machine, và hai bộ expect/actual khác trong repo.

### Assemble the Full App

key-value and JSON persistence that fails soft, five screens assembled, manual theming, debugging and an installable build.

- [Lưu dữ liệu bằng key-value](https://dantech.academy/en/courses/kotlin-mobile-101/06-full-app/lesson-01-key-value-persistence.md): multiplatform-settings, khóa rời rạc thay vì một blob, đọc có giá trị dự phòng riêng từng khóa, và runCatching bọc API đồng bộ dễ vỡ.
- [JSON cho danh sách, và fail-soft](https://dantech.academy/en/courses/kotlin-mobile-101/06-full-app/lesson-02-json-for-lists.md): @Serializable, serializer tự viết cho ImmutableList, mô hình hóa kết quả đọc bằng sealed interface HistoryRead (Ok/Empty/Corrupt), lọc bản ghi hỏng, cắt về giới hạn, và cache tránh mã hóa lại khi không cần.
- [Ráp app: từ điểm khởi động tới màn hình](https://dantech.academy/en/courses/kotlin-mobile-101/06-full-app/lesson-03-assemble-the-app.md): App.kt làm điểm vào chung, AppHost làm gốc composable, và hai vỏ nền tảng Android với iOS mỏng nhất có thể.
- [Theme thủ công, và đưa app ra máy thật](https://dantech.academy/en/courses/kotlin-mobile-101/06-full-app/lesson-04-theme-debug-and-ship.md): Palette làm bảng token, dark mode thủ công cố ý bỏ qua theme hệ thống, màu Unspecified để lỗi to tiếng, và lệnh build cho cả hai nền tảng.