https://github.com/eygraber/compose-country-code-picker

A Compose Multiplatform library for selecting country codes in your application.
https://github.com/eygraber/compose-country-code-picker

compose compose-multiplatform country-codes country-picker kmp kotlin-multiplatform

Last synced: about 8 hours ago
JSON representation

A Compose Multiplatform library for selecting country codes in your application.

• Host: GitHub
• URL: https://github.com/eygraber/compose-country-code-picker
• Owner: eygraber
• License: mit
• Created: 2024-12-09T03:59:12.000Z (2 months ago)
• Default Branch: master
• Last Pushed: 2025-01-20T22:04:44.000Z (21 days ago)
• Last Synced: 2025-01-20T22:50:55.875Z (21 days ago)
• Topics: compose, compose-multiplatform, country-codes, country-picker, kmp, kotlin-multiplatform
• Language: Kotlin
• Homepage:
• Size: 75.2 KB
• Stars: 11
• Watchers: 1
• Forks: 0
• Open Issues: 1
• Metadata Files:
  • Readme: README.md
  • Changelog: changelog_config.json
  • License: LICENSE

Awesome Lists containing this project

README

        
# Compose Country Code Picker

A Compose Multiplatform library for selecting country codes in your application.

ComposeCountryCodePicker is designed to simplify the process of country selection in applications using 

Compose. This library provides an composable function that allows users to pick a country from a list,

typically for phone number input forms, internationalization settings, or any scenario requiring country selection.

## Features

  - **Multiplatform Support**: Works with Android, iOS, Desktop, ~~and Web~~ through Compose Multiplatform

    - Waiting on dependency support for `wasmJs`

  - **Customizable UI**: Adjust the appearance of the picker to match your app's theme or design requirements

  - **Search Functionality**: Allows users to easily search countries by name or calling code

  - **Flag Display**: Displays country flags using emoji, resulting in a higher quality rendering at no storage cost

## Usage

```kotlin

CountryCodePicker(

  onClick = { country -> ... },

)

```

You can optionally specify:

  - `Modifier`

  - A Composable to replace the default search

  - A Composable to replace the default search label

  - A Composable to replace the default search icon

  - A Composable to replace the default item leading content

  - A Composable to replace the default item headline content

  - The `ListItemColors` for each item

  - The list of `Country` to display

  - The search algorithm implementation

  - The initial `Country` to display

### Setup

```

repositories {

  mavenCentral()

}

dependencies {

  implementation("com.eygraber:compose-country-code-picker:0.5.1")

}

```

Snapshots can be found [here](https://s01.oss.sonatype.org/#nexus-search;gav~com.eygraber~compose-country-code-picker~~~).