KeyboardKit helps you build custom keyboard extensions for iOS and iPadOS using SwiftUI.
The end result can look something like this...or entirely different:
KeyboardKit extends the native keyboard extension APIs to provide you with a lot more functionality, to simplify creating powerful keyboards. It also provides you with views to mimic the native system keyboards, with support for multiple locales, gestures, callouts etc.
If you're new to iOS keyboard extensions, this great guide will help you get started. You can also have a look at the demo app for inspiration.
The best way to add KeyboardKit to your app is to use the Swift Package Manager:
https://github.com/KeyboardKit/KeyboardKit.git
You can add the library to the main app, the keyboard extension and any other targets that needs it.
After adding KeyboardKit to your project, you can start using it in your application and keyboard extension.
- The main app target can use KeyboardKit to check if a keyboard is enabled, if full access is granted etc. which helps you build a more helpful application.
- The keyboard extension can use KeyboardKit to get access to a lot more functionality, which helps you build more powerful keyboard extensions.
In your extension, let your KeyboardViewController inherit KeyboardKit's KeyboardInputViewController instead of UIInputViewController. This gives it access to a lot of additional functionality, observables like keyboardContext, services like keyboardActionHandler, keyboardAppearance, autocomplete etc.
KeyboardInputViewController will call viewWillSetupKeyboard when the keyboard should be created or re-created. You can use setup(with:) to setup your extension with any SwiftUI view, to inject necessary environment objects, resize the keyboard extension to fit the view etc.
Have a look at the demo application and read more below to see how it all fits together.
The KeyboardKit documentation contains curated and structured information that makes it easy to overview the various parts of the library, see how the various parts connect to each other etc.
Just download the documentation, extract the zip file and double-tap the KeyboardKit.doccarchive file to view the documentation directly in Xcode.
KeyboardKit is localized in the following languages:
-
🇺🇸 English (US - Default)
-
🇩🇰 Danish
-
🇳🇱 Dutch
-
🇬🇧 English (UK)
-
🇪🇪 Estonian
-
🇫🇮 Finnish
-
🇫🇷 French
-
🇩🇪 German
-
🇮🇹 Italian
-
🇱🇻 Latvian
-
🇱🇹 Lithuanian
-
🇳🇴 Norwegian
-
🇷🇺 Russian
-
🇪🇸 Spanish
-
🇸🇪 Swedish
-
🇺🇦 Ukrainian
KeyboardKit also supports localized keyboards, where the keyboard layout, secondary actions etc. behave just like they should for a certain locale.
Even though KeyboardKit contains a lot of features, you can use its' extensions and views alone to simplify working with keyboard extensions. For instance, there are a bunch of UITextDocumentProxy extensions that make your life easier, and views that don't require you to use the rest of the library.
Check out the demo apps and source code for examples and more information.
KeyboardKit comes with many keyboard-specific actions, like character inputs, emojis, backspace, space, newline, image etc. You can even create your own actions.
KeyboardKit comes with an appearance engine that lets you easily style your keyboards.
KeyboardKit defines system audio types and ways to play them.
KeyboardKit can present autocomplete suggestions as users type.
KeyboardKit lets you show input callouts as users type, as well as secondary action callouts with secondary input actions.
KeyboardKit defines emojis and emoji categories that you can use in your own keyboards.
KeyboardKit provides a bunch of extensions to native types.
KeyboardKit lets you detect whether or not an external keyboard is used.
KeyboardKit keyboards can give audio and haptic feedback as users type.
Read more about audio feedback and haptic feedback.
KeyboardKit comes with keyboard-specific gestures that you can use in your own keyboards.
KeyboardKit defines haptic feedback types and ways to trigger them.
KeyboardKit comes with an input set engine that make it easy to create alphabetic, numeric and symbolic keyboards in different languages.
KeyboardKit comes with a layout engine that makes it easy to create specific keyboard layouts for various devices, orientations and locales.
KeyboardKit comes with many different keyboard types, like alphabetic, numeric, symbolic, emoji etc. You can even create your own types.
KeyboardKit defines keyboard-specific locales and provides localized content for the supported locales.
[Read more here][Locales]
KeyboardKit defines a bunch of preview-specific types that simplify previewing keyboard views in SwiftUI.
KeyboardKit defines a bunch of extensions to UITextDocumentProxy and ways to route text to other sources.
KeyboardKit defines a bunch of styles that simplify customizing the look of various keyboard components and buttons.
KeyboardKit comes with a bunch of keyboard-specific views:
Autocompletecontains autocomplete toolbars and toolbar items.Calloutscontains input and secondary input callout views.Emojiscontains various emoji keyboards and keyboard components.Inputcontains text inputs that can be used in a keyboard extension.Systemcontains views that can be used to mimic native systme keyboards.KeyboardGridcan be used to evenly space a set of views in a grid.NextKeyboardButtoncan be used to switch to the next keyboard.
You can also use these views without using the rest of KeyboardKit.
This repository contains a demo app that demonstrates different keyboards, like alphabetical (lowercased, uppercased and capslocked), numerical, symbols, emojis and images.
The demo app is not intended to be production ready, but rather to give you inspiration to how you can build your own keyboards. Just keep in mind that your keyboards can look anyway you like. They don't have to look like a system keyboard.
To run the demo app, open and run the Demo/Demo.xcodeproj project, then enable the keyboards under system settings. Enable full access to support all features, like audio and haptic feedback.
Note that you may have to update the KeyboardKit dependencies for the demo to run. If so, you can do that under File/Swift Packages/Update to Latest Package Versions.
KeyboardKit Pro is a license-based extensions that unlocks pro features, such as additional locales and an autocomplete engine. Going pro is also a way to support this project.
Feel free to reach out if you have questions or if you want to contribute in any way:
- E-mail: [email protected]
- Twitter: @getkeyboardkit
- Web site: getkeyboardkit.com
This project is proudly sponsored by the following individuals and companies:
You can support KeyboardKit by sponsoring the project on GitHub Sponsors, signing up for a KeyboardKit Pro license or hiring me for consultation.
KeyboardKit is available under the MIT license. See the [LICENSE][License] file for more info.