omarahmedx14/my-android-playground

MyAndroidPlayground is a public learning project where one developer practices and documents how to build a native Android app using the current toolset. It is not finished, and the author is honest about that: the README marks the project as being in a 'foundation phase', meaning the rules, the architecture decisions, and the tooling have been set up, but the actual app idea and its first feature still have to be picked. The headline list of technologies covers most of what a modern Android team would reach for in 2026: Kotlin as the language, Jetpack Compose for the user interface, Material 3 for the visual design, Hilt for dependency injection, Retrofit and OkHttp for talking to web services, Room for a local database, DataStore for small preferences, and Kotlin coroutines with Flow for asynchronous work. Navigation 3 is the planned navigation library, with the older Compose navigation as a fallback. The build uses Gradle's Kotlin DSL. The author follows Clean Architecture, which splits the codebase into three layers that depend in one direction: presentation reads from domain, and domain reads from data. The README states this clearly and adds that each layer must carry real responsibility, with no empty pass-through code added just for the sake of structure. State in the UI is held in a ViewModel as an immutable UiState that flows through Kotlin Flow and StateFlow. A stated core principle is 'learning before explainability before architecture reasoning before implementation speed'. The author also writes that no generated code is accepted unless the architectural decision behind it is understood. AI tools, in this case Claude Code, are used as a mentor, reviewer, and safety guard, with project-local agents for code review, debugging, Git safety, and testing, plus a project-local skill for Navigation 3. These files live in a .claude folder that is committed to the repo on purpose so the workflow is visible to anyone reading the project. What is already in the repo: a fresh Android Studio project with a Compose baseline, the package name 'com.omarahmedx14.myandroidplayground', a Gradle setup with a cleaned-up dependency list, the architecture contract written in CLAUDE.md, and a 'public-safe' gitignore. The license is listed as TBD.