How do I customize the passcode UI colors in SmileLock?

Set properties like tintColor and highlightedColor on the PasswordContainerView instance. The README provides code examples for changing colors and toggling visual effects like blur backgrounds.

Can I use SmileLock with SwiftUI?

SmileLock is built for UIKit, so to use it in SwiftUI, you'll need to wrap it in a UIViewRepresentable. The README doesn't include SwiftUI examples, so some bridging code is required.

How to handle failed biometric attempts in SmileLock?

Implement the touchAuthenticationComplete delegate method to check the success boolean. On failure, you can clear the input with passwordContainerView.clearInput() and add custom logic like fallback to passcode.

SmileLock vs. other iOS passcode libraries like PasscodeLock: which should I choose?

SmileLock excels in aesthetic customization and out-of-the-box biometric support, making it ideal for polished apps. Compare based on factors like Swift version compatibility, additional features (e.g., auto-lock), or community support to fit your project's needs.

What are the requirements for using Face ID with SmileLock?

Add NSFaceIDUsageDescription to your Info.plist to describe Face ID usage, otherwise the app may crash. The library handles the biometric prompt, but you must implement the delegate callbacks for success or failure.

How to validate passcodes securely with SmileLock?

Use the passwordInputComplete delegate to compare the input string with a stored passcode. For security, consider integrating with iOS Keychain for storage, as SmileLock doesn't provide built-in secure handling.

Is SmileLock compatible with Carthage or Swift Package Manager?

The README only mentions CocoaPods and manual installation via dragging files. There's no official support for Carthage or SPM, which might limit dependency management options for some projects.

Open-Awesome

Smile-Lock

Apache-2.0Swift3.0.8

A Swift library for creating beautiful, customizable passcode lock views with Touch ID and Face ID support for iOS apps.

GitHub

594 stars115 forks0 contributors

What is Smile-Lock?

SmileLock is a Swift library for iOS that helps developers create beautiful and functional passcode lock views for authentication. It solves the problem of building secure, visually appealing passcode screens from scratch by providing ready-to-use components with biometric integration. The library simplifies adding Touch ID and Face ID support while allowing extensive UI customization.

Target Audience

iOS developers building apps that require secure authentication, such as banking, productivity, or privacy-focused applications. It's ideal for teams wanting to implement polished passcode screens quickly without deep custom UI development.

Value Proposition

Developers choose SmileLock for its balance of aesthetics and simplicity—it offers production-ready passcode UI with biometric support out of the box, reducing development time. Its clean API and customization options make it a flexible alternative to building authentication screens manually.

Overview

A library for make a beautiful Passcode Lock View

Use Cases

Best For

Adding secure passcode locks to iOS apps
Implementing Touch ID or Face ID authentication flows
Creating customizable authentication screens with visual effects
Building banking or finance apps with polished security UI
Prototyping authentication features quickly
Enhancing existing apps with biometric login options

Not Ideal For

Projects requiring cross-platform authentication (e.g., Android or web support)
Apps needing server-side or cloud-based authentication management (e.g., OAuth or Firebase integration)
Teams exclusively using SwiftUI without UIKit interoperability
Applications with highly complex security requirements beyond basic passcode and biometrics (e.g., multi-factor authentication with hardware tokens)

Pros & Cons

Pros

Elegant Pre-Built UI

Provides beautiful, customizable passcode views out of the box, including visual effects like blur backgrounds, as demonstrated in the README's demo GIFs and examples.

Seamless Biometric Integration

Supports Touch ID and Face ID with simple delegate callbacks, reducing the complexity of implementing biometric authentication, as shown in the code snippets for touchAuthenticationComplete.

Flexible Theming Options

Allows easy UI customization through properties like tintColor and highlightedColor, enabling developers to match app branding without deep CSS or design work.

Clean API Design

Uses protocol-based delegation (e.g., PasswordInputCompleteProtocol) for straightforward event handling, making the codebase maintainable and intuitive.

Cons

Swift Version Fragmentation

Different pod versions are tied to specific Swift versions (e.g., 3.x for Swift 4, 2.x for Swift 3), which can cause migration issues and breaking changes when updating Swift.

UIKit-Only Limitation

The library is built for UIKit and lacks native SwiftUI support, requiring additional work like UIViewRepresentable wrappers for modern iOS projects.

Basic Security Handling

Focuses on UI and biometrics but leaves secure passcode storage (e.g., Keychain integration) and validation logic to the developer, requiring extra effort for robust security.

Frequently Asked Questions

Related Projects

cocoapods-keys

A key value store for storing per-developer environment and application keys

Stars1,549

Forks90

Last commit2 years ago

BiometricAuthentication

Use Apple FaceID or TouchID authentication in your app using BiometricAuthentication.

Stars828

Forks112

Last commit4 years ago

SwiftPasscodeLock

An iOS passcode lock with TouchID authentication written in Swift.

Stars677

Forks257

Last commit6 years ago

LTHPasscodeViewController

iOS 7 style Passcode Lock

Stars616

Forks142

Last commit11 months ago

Community-curated · Updated weekly · 100% open source

Found a gem we're missing?

Open-Awesome is built by the community, for the community. Submit a project, suggest an awesome list, or help improve the catalog on GitHub.

Submit a project Star on GitHub