KeyboardKit helps you build custom keyboard extensions for iOS and iPadOS, using Swift and SwiftUI. It extends the native keyboard APIs and provides you with a lot more functionality than is otherwise available.
KeyboardKit lets you create keyboards that mimic the native iOS keyboards in a few lines of code. These keyboards can be customized to great extent to change input keys, keyboard layout, design, behavior etc.
You can also use entirely custom views together with the rich features of KeyboardKit, to create completely custom keyboards. Most of the library can be used on all major Apple platforms.
KeyboardKit can be installed with the Swift Package Manager:
https://github.com/KeyboardKit/KeyboardKit.git
or with CocoaPods:
pod KeyboardKit
You can add the library to the main app, the keyboard extension and any other targets that need it. If you prefer to not have external dependencies, you can also just copy the source code into your app.
KeyboardKit supports iOS 14
, macOS 11
, tvOS 14
and watchOS 7
.
KeyboardKit is localized in 61 keyboard-specific locales (read more):
๐ฆ๐ฑ ๐ฆ๐ช ๐ฆ๐ฒ ๐ง๐พ ๐ง๐ฌ ๐ฆ๐ฉ ๐ณ๏ธ ๐ญ๐ท ๐จ๐ฟ ๐ฉ๐ฐ
๐ณ๐ฑ ๐ง๐ช ๐บ๐ธ ๐ฌ๐ง ๐บ๐ธ ๐ช๐ช ๐ซ๐ด ๐ต๐ญ ๐ซ๐ฎ ๐ซ๐ท
๐ง๐ช ๐จ๐ญ ๐ฌ๐ช ๐ฉ๐ช ๐ฆ๐น ๐จ๐ญ ๐ฌ๐ท ๐บ๐ธ ๐ฎ๐ฑ ๐ญ๐บ
๐ฎ๐ธ ๐ฎ๐ฉ ๐ฎ๐ช ๐ฎ๐น ๐ฐ๐ฟ ๐น๐ฏ ๐น๐ฏ ๐น๐ฏ ๐ฑ๐ป ๐ฑ๐น
๐ฒ๐ฐ ๐ฒ๐พ ๐ฒ๐น ๐ฒ๐ณ ๐ณ๐ด ๐ฎ๐ท ๐ต๐ฑ ๐ต๐น ๐ง๐ท ๐ท๐ด
๐ท๐บ ๐ท๐ธ ๐ท๐ธ ๐ธ๐ฐ ๐ธ๐ฎ ๐ช๐ธ ๐ฐ๐ช ๐ธ๐ช ๐น๐ท ๐บ๐ฆ
๐บ๐ฟ
KeyboardKit comes packed features to help you build amazing and powerful keyboards:
- ๐ฅ Actions - KeyboardKit comes with keyboard actions like characters, emojis, actions, custom ones etc.
- ๐จ Appearance - KeyboardKit comes with an appearance engine that lets you style your keyboards.
- ๐ก Autocomplete - KeyboardKit can perform autocomplete and present suggestions as the user types.
- ๐ฏ Callouts - KeyboardKit can show input callouts as the user types, as well as callouts with secondary actions.
- ๐ค Dictation - (BETA) KeyboardKit can perform dictation from the keyboard extension.
- ๐ Emojis - KeyboardKit defines emojis and emoji categories, as well as emoji keyboards.
- โจ๏ธ External Keyboards - KeyboardKit lets you detect whether or not an external keyboard is connected.
- ๐ Feedback - KeyboardKit keyboards can give and haptic feedback feedback as the user types.
- ๐ Gestures - KeyboardKit comes with keyboard-specific gestures that you can use in your own keyboards.
- ๐ค Input - KeyboardKit supports
alphabetic
,numeric
,symbolic
and completely custom input sets. - โจ๏ธ Keyboard - KeyboardKit supports different keyboard types, provides observable keyboard state, etc.
- ๐ฃ Layout - KeyboardKit supports creating keyboard layouts for various devices, locales etc.
- ๐ Localization- KeyboardKit defines keyboard-specific locales with localized content and assets.
- ๐ Previews - KeyboardKit has utilites that help previewing keyboard views and components in SwiftUI.
- โก๏ธ Proxy - KeyboardKit extends
UITextDocumentProxy
and makes it do a lot more. - ๐ Routing - KeyboardKit lets you route text to other destinations than the main app.
- โฌ ๏ธ RTL - KeyboardKit supports RTL (right-to-left) locales, such as Arabic, Persian, Kurdish Sorani etc.
- โ๏ธ Settings - KeyboardKit has tools for accessing and linking to an app's keyboard settings.
The online documentation has a getting-started guide that will help you get started with the library.
To make your custom keyboard extension use KeyboardKit, just install and import KeyboardKit, then make it inherit KeyboardInputViewController
instead of UIInputController
:
import KeyboardKit
class KeyboardController: KeyboardInputViewController {}
This will by default set up a fully working U.S. English keyboard. You can then override any functions to customize how it sets up the keyboard, inject your own services, for instance:
override viewWillSetupKeyboard() {
super.viewWillSetupKeyboard()
setup(with: MyKeyboardView())
}
For more information, please see the online documentation and getting-started guide.
The online documentation has articles, code examples etc. that let you overview the various parts of the library and understand how they all connect to each other.
The online documentation is currently iOS-specific. To generate documentation for the other platforms, open the package in Xcode, select a simulator then run Product/Build Documentation
.
KeyboardKit Pro extends KeyboardKit with pro features, such as localized keyboards and services, autocomplete, dictation, emoji skintones, additional views etc. It lets you create fully localized keyboards with a single line of code.
This project has a Demo
folder with a demo app that lets you try out KeyboardKit and KeyboardKit Pro. The app has an input text field and shows you how to display the state of a keyboard extension, link to system settings etc.
The demo app has 5 keyboard extensions:
English
uses KeyboardKit and has aSystemKeyboard
with the standard, English locale.Unicode
uses KeyboardKit and has aSystemKeyboard
with unicode-based input keys.Custom
uses KeyboardKit and has aSystemKeyboard
with custom keys, layout and appearance.Pro
uses KeyboardKit Pro and has aSystemKeyboard
with all LRT locales, autocomplete etc.ProRtl
uses KeyboardKit Pro and has aSystemKeyboard
with all RTL locales, autocomplete etc.
Just open and run the demo app, then enable the keyboards you want to try under System Settings. Note that you need to enable full access to try some features, like audio and haptic feedback.
KeyboardKit is trusted and proudly sponsored by the following companies:
![Oribi Oribi Icon](https://raw.githubusercontent.com/brandy2015/KeyboardKit/master/Resources/sponsors/oribi.png)
![phonetoroam phonetoroam Icon](https://raw.githubusercontent.com/brandy2015/KeyboardKit/master/Resources/sponsors/phonetoroam.png)
![Vitalis Vitalis Icon](https://raw.githubusercontent.com/brandy2015/KeyboardKit/master/Resources/sponsors/vitalis.png)
![LetterKey LetterKey Icon](https://raw.githubusercontent.com/brandy2015/KeyboardKit/master/Resources/sponsors/letterkey.png)
![Anomaly Software Anomaly Software Icon](https://raw.githubusercontent.com/brandy2015/KeyboardKit/master/Resources/sponsors/anomaly.png)
![Milo Creative Milo Creative Icon](https://raw.githubusercontent.com/brandy2015/KeyboardKit/master/Resources/sponsors/milo.png)
KeyboardKit is open-source and completely free, but you can sponsor this project on GitHub Sponsors, upgrade to KeyboardKit Pro or get in touch for freelance work, paid support etc.
Feel free to reach out if you have questions or if you want to contribute in any way:
- Website: keyboardkit.com
- Mastodon: @keyboardkit@techhub.social
- Twitter: @getkeyboardkit
- E-mail: info@getkeyboardkit.com
KeyboardKit is available under the MIT license. See the LICENSE file for more info.