ComposeSample: Instructions file for Claude Code

CLAUDE.md — ComposeSample Project Guide

A guide that helps Claude Code write consistent code in this project.

---

Tech Stack

• Language: Kotlin
• UI: Jetpack Compose + Material3
• Architecture: Clean Architecture + MVVM
• DI: Koin
• Network: Retrofit + Gson, Ktor
• Local DB: Room
• Async: Coroutine + Flow
• Target SDK: 35 / Min SDK: 24
• Kotlin: 2.4.21 / ComposeBom: 2026.09.00 (Compose 1.12.1)

---

Module Structure

ComposeSample
├── app        # UI layer (Compose, ViewModel, DI modules)
├── data       # Data layer (Repository implementations, API, Room)
├── domain     # Domain layer (Repository interfaces, UseCase, Model) — pure Kotlin
├── Core       # Navigation interface
└── Coordinator # Coordinator pattern implementation

presentation package structure inside app:

presentation/example/
├── component/
│   ├── ui/           # UI components & layout
│   ├── interaction/  # Gestures & click events
│   ├── navigation/   # Navigation
│   ├── data/         # Network & cache
│   ├── system/       # System integration (platform, media, background)
│   └── architecture/ # Architecture patterns & dev tools
├── list/             # ExampleObject list definitions
├── ExampleUiRegistry.kt # exampleType → Composable routing map (add new examples here)
├── ExampleRouter.kt  # ExampleMoveType dispatch + registry lookup
└── ExampleObjectList.kt # Aggregation of the full example list + subCategoryList()

---

How to Add a New Example

Always follow the steps below when adding an example.

Step 1: Add a constant to ConstValue.kt

// app/src/main/java/com/example/composesample/util/ConstValue.kt
const val NewFeatureExample = "newFeatureExample"

When adding a constant, also update the comment for that section:

// ==================== Test examples ====================
// Test(UI test TDD), RecompositionTest(...), NewFeature(new feature description)  ← added
const val NewFeatureExample = "newFeatureExample"