How to customize CountryPicker for dark mode in SwiftUI?

CountryPicker supports dark mode out of the box with styling options. You can adjust colors and themes using the provided configuration in the SwiftUI example project, as shown in the screenshots and documentation.

CountryPicker vs PhoneNumberKit for iOS country selection?

CountryPicker focuses solely on country selection with flags and codes, while PhoneNumberKit is more comprehensive for phone number parsing and validation. Choose CountryPicker for a simple, customizable picker; opt for PhoneNumberKit if full phone number handling is required.

How to filter countries by dialing code in CountryPicker?

Use the CountryManager.shared.addFilter(.countryDialCode) method to enable filtering by dialing code. The library allows configuring multiple filters for name, code, or dialing code, as demonstrated in the README code snippets.

Does CountryPicker work with iOS 14?

For versions below 3.0.0, it supports older iOS, but version 3.0.0 and above require iOS 15+. Check the baseiOS11Example for UIKit support on earlier versions, but SwiftUI features are limited to iOS 15+ as specified in the requirements.

How to integrate CountryPicker using Swift Package Manager?

Add the package URL https://github.com/SURYAKANTSHARMA/CountryPicker with version 'from 4.0.0' to your Package.swift dependencies. Ensure your project targets iOS 15+ for the latest features, as per the installation instructions.

CountryPicker example project not building?

The example projects might require pod updates or specific Xcode versions. Clone the repo and run 'pod update' in the Example directory, and ensure you're using Xcode 15.x as specified in the requirements to avoid compatibility issues.

Open-Awesome

SKCountryPicker

MITSwift5.0.2

A Swift library for iOS that provides a customizable country picker with search, filtering, and SwiftUI support.

GitHub

315 stars90 forks0 contributors

What is SKCountryPicker?

CountryPicker is a Swift library for iOS that provides a customizable interface for selecting countries, including flags, dialing codes, and country codes. It solves the problem of implementing a robust, native-feeling country picker in iOS apps with minimal code, supporting both UIKit and SwiftUI.

Target Audience

iOS developers building apps that require country selection, such as sign-up forms, phone number inputs, or location-based features, especially those using SwiftUI or needing high customization.

Value Proposition

Developers choose CountryPicker for its ease of integration, native iOS design patterns, extensive customization options, and support for modern SwiftUI and Combine frameworks, all with high test coverage for reliability.

Overview

A simple, customizable Country picker for picking country or dialing code. 🇮🇳 🇯🇵 🇰🇷 🇩🇪 🇨🇳 🇺🇸 🇫🇷 🇪🇸 🇮🇹 🇷🇺 🇬🇧

Use Cases

Best For

Adding country selection to sign-up or profile forms in iOS apps
Building phone number input fields with country dialing codes
SwiftUI apps needing a customizable, native country picker
iOS projects requiring dark mode and accessibility support
Apps that filter countries by name, code, or dialing code
Replacing default pickers with a more feature-rich country selector

Not Ideal For

Apps targeting iOS versions below 15.0 that require the latest SwiftUI features
Projects needing real-time country data updates or extensive geopolitical changes
Teams looking for a completely pre-styled, zero-configuration component without any customization effort

Pros & Cons

Pros

Native iOS Experience

Implements search and index navigation similar to the iOS Contacts app, providing a seamless user experience as highlighted in the README.

Modern Swift Support

Rewritten with SwiftUI and Combine in version 3.0.0, making it ideal for modern iOS development workflows with example projects provided.

High Customizability

Offers extensive styling options, filter configurations, and supports dark mode and dynamic fonts for accessibility, as detailed in the features list.

Comprehensive Testing

Includes unit tests with 94% coverage, ensuring reliability and reducing bugs in production, which is explicitly mentioned in the README.

Cons

Limited iOS Version Support

Version 3.0.0 and above require iOS 15+, discontinuing support for older versions, which might alienate apps with a broader user base, as noted in the requirements.

Build Stability Concerns

The README shows a 'Build failed' badge, indicating potential issues with continuous integration or dependency management that could affect reliability.

Breaking Changes in Updates

The library was rewritten in version 3.0.0, which could require significant code changes for users upgrading from older versions, introducing migration complexity.

Frequently Asked Questions

Related Projects

ActionSheetPicker-3.0

Quickly reproduce the dropdown UIPickerView / ActionSheet functionality on iOS.

Stars3,387

Forks735

Last commit2 months ago

Mandoline

An iOS picker view to serve all your "picking" needs

Stars886

Forks33

Last commit7 years ago

PickerView

🔸 A customizable alternative to UIPickerView in Swift.

Stars527

Forks88