# canokcelik/wear-os-samples architecture

> Architecture diagram of the GitHub repository canokcelik/wear-os-samples, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-11-16). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/canokcelik/wear-os-samples
- Repository: https://github.com/canokcelik/wear-os-samples

## Overview

This repository is a collection of independent Wear OS sample projects, not one application. Its documented user workflows cover app and watch-face development, phone/watch communication, authentication, audio, tiles, and complication testing. The sampled Watch Face Format plugin adds XML validation and device installation tasks. Most sample implementation sources were not provided, so their internal calls are not mapped; those capabilities and links are based on the README.

Main entry points: [`WatchFaceFormat/validator-plugin/plugins/src/main/kotlin/WffValidatorPlugin.kt`](https://github.com/canokcelik/wear-os-samples/blob/main/WatchFaceFormat/validator-plugin/plugins/src/main/kotlin/WffValidatorPlugin.kt) (WFF validator plugin), [`DataLayer`](https://github.com/canokcelik/wear-os-samples/tree/main/DataLayer) (Data Layer sample), [`WearOAuth`](https://github.com/canokcelik/wear-os-samples/tree/main/WearOAuth) (Wear OAuth sample), [`WatchFaceFormat/validator-plugin/plugins/src/main/kotlin/AdbInstallTask.kt`](https://github.com/canokcelik/wear-os-samples/blob/main/WatchFaceFormat/validator-plugin/plugins/src/main/kotlin/AdbInstallTask.kt) (Install watch face)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_apps["Wear Apps"]
  node_compose["Compose starter app"]
  node_data["Data Layer sample"]
  node_auth["Wear OAuth sample"]
  node_speaker["Speaker sample"]
  node_tiles["Tiles sample"]
end

subgraph group_faces["Watch Faces"]
  node_kotlinface["Kotlin watch face"]
  node_complications["Complication sources"]
  node_wfffaces["WFF face samples"]
end

subgraph group_wff["Format Validation"]
  node_plugin["WFF validator plugin"]
  node_download["Validator download"]
  node_validate["XML validation"]
  node_install["Install watch face<br/>[AdbInstallTask.kt]"]
end

subgraph group_integrations["Device Integrations"]
  node_validatorhost(("Validator download host"))
end

node_developer(("Wear OS developer"))
node_wearable(("Wearable device"))
node_phone(("Mobile phone"))
node_companion(("Wear OS companion"))
node_oauth(("OAuth provider"))
node_adb(("ADB device"))

node_developer -->|"starts from"| node_compose
node_developer -->|"uses sample"| node_data
node_developer -->|"uses sample"| node_auth
node_developer -->|"uses sample"| node_speaker
node_developer -->|"uses sample"| node_tiles
node_developer -->|"uses sample"| node_kotlinface
node_developer -->|"tests sources"| node_complications
node_developer -->|"develops faces"| node_wfffaces
node_data -->|"communicates with"| node_phone
node_data -->|"communicates with"| node_wearable
node_auth -->|"requests authentication via"| node_companion
node_companion -->|"handles request on"| node_phone
node_auth -->|"uses OAuth"| node_oauth
node_speaker -->|"records and plays audio"| node_wearable
node_plugin -->|"registers"| node_download
node_plugin -->|"registers"| node_validate
node_plugin -->|"registers"| node_install
node_download -->|"downloads from"| node_validatorhost
node_plugin -->|"runs with debug builds"| node_validate
node_plugin -->|"depends on debug build"| node_install
node_install -->|"installs and sets face via"| node_adb

click node_compose "https://github.com/canokcelik/wear-os-samples/tree/main/ComposeStarter"
click node_data "https://github.com/canokcelik/wear-os-samples/tree/main/DataLayer"
click node_auth "https://github.com/canokcelik/wear-os-samples/tree/main/WearOAuth"
click node_speaker "https://github.com/canokcelik/wear-os-samples/tree/main/WearSpeakerSample"
click node_tiles "https://github.com/canokcelik/wear-os-samples/tree/main/WearTilesKotlin"
click node_kotlinface "https://github.com/canokcelik/wear-os-samples/tree/main/WatchFaceKotlin"
click node_complications "https://github.com/canokcelik/wear-os-samples/tree/main/Complications"
click node_wfffaces "https://github.com/canokcelik/wear-os-samples/tree/main/WatchFaceFormat"
click node_plugin "https://github.com/canokcelik/wear-os-samples/blob/main/WatchFaceFormat/validator-plugin/plugins/src/main/kotlin/WffValidatorPlugin.kt"
click node_download "https://github.com/canokcelik/wear-os-samples/blob/main/WatchFaceFormat/validator-plugin/plugins/src/main/kotlin/ValidatorDownloadTask.kt"
click node_validate "https://github.com/canokcelik/wear-os-samples/blob/main/WatchFaceFormat/validator-plugin/plugins/src/main/kotlin/ValidateWffFilesTask.kt"
click node_install "https://github.com/canokcelik/wear-os-samples/blob/main/WatchFaceFormat/validator-plugin/plugins/src/main/kotlin/AdbInstallTask.kt"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_compose,node_data,node_auth,node_speaker,node_tiles toneBlue
class node_kotlinface,node_complications,node_wfffaces toneAmber
class node_plugin,node_download,node_validate,node_install toneMint
class node_validatorhost toneRose
class node_developer,node_wearable,node_phone,node_companion,node_oauth,node_adb toneIndigo
```

## Components

### Wear Apps

- [Compose starter app](https://github.com/canokcelik/wear-os-samples/tree/main/ComposeStarter): `ComposeStarter`
- [Data Layer sample](https://github.com/canokcelik/wear-os-samples/tree/main/DataLayer): `DataLayer`
- [Wear OAuth sample](https://github.com/canokcelik/wear-os-samples/tree/main/WearOAuth): `WearOAuth`
- [Speaker sample](https://github.com/canokcelik/wear-os-samples/tree/main/WearSpeakerSample): `WearSpeakerSample`
- [Tiles sample](https://github.com/canokcelik/wear-os-samples/tree/main/WearTilesKotlin): `WearTilesKotlin`

### Watch Faces

- [Kotlin watch face](https://github.com/canokcelik/wear-os-samples/tree/main/WatchFaceKotlin): `WatchFaceKotlin`
- [Complication sources](https://github.com/canokcelik/wear-os-samples/tree/main/Complications): `Complications`
- [WFF face samples](https://github.com/canokcelik/wear-os-samples/tree/main/WatchFaceFormat): `WatchFaceFormat`

### Format Validation

- [WFF validator plugin](https://github.com/canokcelik/wear-os-samples/blob/main/WatchFaceFormat/validator-plugin/plugins/src/main/kotlin/WffValidatorPlugin.kt): `WatchFaceFormat/validator-plugin/plugins/src/main/kotlin/WffValidatorPlugin.kt`
- [Validator download](https://github.com/canokcelik/wear-os-samples/blob/main/WatchFaceFormat/validator-plugin/plugins/src/main/kotlin/ValidatorDownloadTask.kt): `WatchFaceFormat/validator-plugin/plugins/src/main/kotlin/ValidatorDownloadTask.kt`
- [XML validation](https://github.com/canokcelik/wear-os-samples/blob/main/WatchFaceFormat/validator-plugin/plugins/src/main/kotlin/ValidateWffFilesTask.kt): `WatchFaceFormat/validator-plugin/plugins/src/main/kotlin/ValidateWffFilesTask.kt`
- [Install watch face](https://github.com/canokcelik/wear-os-samples/blob/main/WatchFaceFormat/validator-plugin/plugins/src/main/kotlin/AdbInstallTask.kt): `WatchFaceFormat/validator-plugin/plugins/src/main/kotlin/AdbInstallTask.kt`

### Device Integrations

- **Validator download host**

### Other components

- **Wear OS developer**
- **Wearable device**
- **Mobile phone**
- **Wear OS companion**
- **OAuth provider**
- **ADB device**

## Connections

- Wear OS developer → Compose starter app: starts from
- Wear OS developer → Data Layer sample: uses sample
- Wear OS developer → Wear OAuth sample: uses sample
- Wear OS developer → Speaker sample: uses sample
- Wear OS developer → Tiles sample: uses sample
- Wear OS developer → Kotlin watch face: uses sample
- Wear OS developer → Complication sources: tests sources
- Wear OS developer → WFF face samples: develops faces
- Data Layer sample → Mobile phone: communicates with
- Data Layer sample → Wearable device: communicates with
- Wear OAuth sample → Wear OS companion: requests authentication via
- Wear OS companion → Mobile phone: handles request on
- Wear OAuth sample → OAuth provider: uses OAuth
- Speaker sample → Wearable device: records and plays audio
- WFF validator plugin → Validator download: registers (evidence: `WatchFaceFormat/validator-plugin/plugins/src/main/kotlin/WffValidatorPlugin.kt`)
- WFF validator plugin → XML validation: registers (evidence: `WatchFaceFormat/validator-plugin/plugins/src/main/kotlin/WffValidatorPlugin.kt`)
- WFF validator plugin → Install watch face: registers (evidence: `WatchFaceFormat/validator-plugin/plugins/src/main/kotlin/WffValidatorPlugin.kt`)
- Validator download → Validator download host: downloads from (evidence: `WatchFaceFormat/validator-plugin/plugins/src/main/kotlin/ValidatorDownloadTask.kt`)
- WFF validator plugin → XML validation: runs with debug builds (evidence: `WatchFaceFormat/validator-plugin/plugins/src/main/kotlin/WffValidatorPlugin.kt`)
- WFF validator plugin → Install watch face: depends on debug build (evidence: `WatchFaceFormat/validator-plugin/plugins/src/main/kotlin/WffValidatorPlugin.kt`)
- Install watch face → ADB device: installs and sets face via (evidence: `WatchFaceFormat/validator-plugin/plugins/src/main/kotlin/AdbInstallTask.kt`)
