simple-keyboard/README.md

51 lines
3.3 KiB
Markdown
Raw Normal View History

2018-10-20 14:21:40 -04:00
[![GitHub license](https://img.shields.io/badge/license-MIT-blue.svg)](https://github.com/hodgef/simple-keyboard/blob/master/LICENSE)
[![npm version](https://img.shields.io/npm/v/simple-keyboard.svg?style=flat)](https://www.npmjs.com/package/simple-keyboard)
2018-10-14 22:52:00 -04:00
[![Build Status](https://travis-ci.org/hodgef/simple-keyboard.svg?branch=master)](https://travis-ci.org/hodgef/simple-keyboard)
2018-10-16 18:00:21 -04:00
[![codecov](https://codecov.io/gh/hodgef/simple-keyboard/branch/master/graph/badge.svg)](https://codecov.io/gh/hodgef/simple-keyboard)
2018-10-14 18:58:03 -04:00
[![](https://img.shields.io/badge/discord--chat-join-green.svg?longCache=true&style=flat-square&colorB=7289DA&logo=discord)](http://franciscohodge.com/simple-keyboard/chat/join)
2018-07-19 10:13:09 -04:00
2018-10-20 14:21:40 -04:00
<a href="https://simple-keyboard.com/demo" title="View Demo" target="_blank"><img src="https://franciscohodge.com/project-pages/simple-keyboard/images/simplekeyboard-banner_B.png" align="center" width="100%"></a>
<a href="https://simple-keyboard.com/demo" title="View Demo" target="_blank"><img src="https://franciscohodge.com/project-pages/simple-keyboard/images/simple-keyboard-10172018.gif" align="center" width="100%"></a>
2018-04-20 16:34:02 -04:00
2018-05-30 23:15:01 -04:00
> The easily customisable and responsive on-screen virtual keyboard for Javascript projects.
2018-04-20 16:34:02 -04:00
2018-10-14 19:02:14 -04:00
This package works with <a href="https://codesandbox.io/s/github/hodgef/demo_npm_simple-keyboard" title="View Vanilla JS Demo" target="_blank">**Vanilla JS**</a> projects, yet it is also compatible with <a href="https://codesandbox.io/s/github/hodgef/demo_npm_simple-keyboard_angular-js" title="View Angular Demo" target="_blank">**Angular**</a>, <a href="https://codesandbox.io/s/github/hodgef/demo_npm_simple-keyboard_vue-js" title="View Vue Demo" target="_blank">**Vue**</a>, and other libraries and frameworks.
2018-10-06 19:00:30 -04:00
Looking for **React** support? Check out [react-simple-keyboard](https://www.npmjs.com/package/react-simple-keyboard) !
2018-04-20 16:34:02 -04:00
## Installation
2018-10-20 14:21:40 -04:00
You can use simple-keyboard as a <script> tag from a CDN, or install it from npm.
Check out the [**Getting Started**](https://simple-keyboard.com/getting-started) docs for more info.
2018-04-20 16:34:02 -04:00
2018-10-20 14:21:40 -04:00
## Usage
You can find the **simple-keyboard documentation** [on the website](https://simple-keyboard.com/documentation).
2018-04-24 09:38:14 -04:00
2018-10-20 14:21:40 -04:00
Feel free to browse the [Q&A / Use-cases](https://simple-keyboard.com/qa-use-cases/) page for advanced use-cases.
2018-09-24 15:52:54 -04:00
2018-04-20 16:34:02 -04:00
## Demo
[https://franciscohodge.com/simple-keyboard/demo](https://franciscohodge.com/simple-keyboard/demo)
2018-10-14 18:58:03 -04:00
<a href="https://codesandbox.io/s/github/hodgef/demo_npm_simple-keyboard" title="run demo" target="_blank"><img src="https://franciscohodge.com/project-pages/simple-keyboard/images/rundemo200.png" width="150" align="center"></a>
2018-05-30 22:28:51 -04:00
2018-04-20 16:34:02 -04:00
### To run demo on your own computer
* Clone this repository
* `npm install`
* `npm start`
* Visit [http://localhost:3000/](http://localhost:3000/)
2018-06-08 10:59:11 -04:00
### Other versions
2018-04-20 16:34:02 -04:00
2018-06-08 10:59:11 -04:00
* ReactJS - [react-simple-keyboard](https://github.com/hodgef/react-simple-keyboard)
2018-10-08 19:12:51 -04:00
### Questions?
<a href="http://franciscohodge.com/simple-keyboard/chat/join" title="Join our Discord chat" target="_blank"><img src="https://franciscohodge.com/project-pages/simple-keyboard/images/discord.png" align="center" width="200"></a>
2018-06-08 10:59:11 -04:00
## Contributing
PR's and issues are welcome. Feel free to submit any issues you have at:
2018-04-20 16:34:02 -04:00
[https://github.com/hodgef/simple-keyboard/issues](https://github.com/hodgef/simple-keyboard/issues)