alanpog / keyboardkit Goto Github PK

KeyboardKit is a Swift library that helps you build custom keyboards with Swift and SwiftUI. It extends the native keyboard APIs and provides you with a lot more functionality than is otherwise available.

The end result can look something like this...or entirely different:

KeyboardKit lets you create keyboards that mimic the iOS stock keyboard in a single line of code. These keyboards can be customized to great extent to change their input keys, keyboard layout, design, behavior etc.

You can also use entirely custom views with the rich features of KeyboardKit, to create completely custom keyboard extensions. Most of the KeyboardKit features can be used on all major Apple platforms as well.

KeyboardKit supports iOS 13, macOS 11, tvOS 13 and watchOS 6.

Although KeyboardKit builds on all platform, some features are unavailable on some 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.

The online documentation has a getting-started guide that will help you get started with the library.

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 other platforms, open the package in Xcode, select a simulator then run Product/Build Documentation.

KeyboardKit is localized in 60 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 easily style your keyboards.
• 💡 Autocomplete - KeyboardKit can present autocomplete suggestions as the user types.
• 🗯 Callouts - KeyboardKit can show input callouts, as well as long press callouts with secondary actions.
• 😊 Emojis - KeyboardKit defines emojis and emoji categories that you can use in your own keyboards.
• ⌨️ External Keyboards - KeyboardKit lets you detect whether or not an external keyboard is used.
• 👋 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 creating alphabetic, numeric and symbolic and custom input sets.
• 💱 Layout - KeyboardKit supports creating keyboard layouts for various devices, locales etc.
• ⌨️ Keyboard - KeyboardKit supports keyboard types like alphabertic, can inspect a keyboard's state etc.
• 🌐 Locales- KeyboardKit defines keyboard-specific locales with localized content and assets.
• 👁 Previews - KeyboardKit defines a bunch of tools that simplify previewing keyboard views in SwiftUI.
• ➡️ Proxy - KeyboardKit defines a bunch of extensions to UITextDocumentProxy.
• 🚏 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 etc.
• ⚙️ Settings - KeyboardKit has tools for accessing and linking to an app's keyboard settings.
• 🎨 Styles - KeyboardKit defines a bunch of styles that simplify customizing the look of various components.

KeyboardKit Pro extends KeyboardKit with pro features, such as additional locales, autocomplete engines, more extensions, additional views etc. It lets you create fully localized system keyboards with a single line of code.

KeyboardKit Pro requires a commercial license. Licenses can be purchased from the website or from Gumroad.

This project contains a Demo folder with three demo apps that lets you try out KeyboardKit.

Demo uses KeyboardKit and lets you type in a light and dark text field. It has three keyboards:

• English has a SystemKeyboard with the standard, English locale.
• Unicode has a SystemKeyboard with custom, unicode-based inputs.
• Custom has a completely custom input sets and keyboard layout.

ProDemo uses KeyboardKit Pro and supports all keyboard locales, LTR and RTL, autocomplete etc. It has two keyboards:

• System LTR has a SystemKeyboard with all left-to-right locales.
• System RTL has a SystemKeyboard with all right-to-left locales.

Just open and run any of these projects, 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:

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 paid support.

Feel free to reach out if you have questions or if you want to contribute in any way:

• E-mail: [email protected]
• Twitter: @getkeyboardkit
• Website: getkeyboardkit.com

KeyboardKit is available under the MIT license. See the LICENSE file for more info.