|
1 | | -# vertical-stepper |
2 | | -Vertical Stepper library |
| 1 | + <div align="center"> |
| 2 | + <img align="center" width="230" src="https://i.imgur.com/iHgtvmg.png" /> |
| 3 | + <h2>Typescript Library Boilerplate Basic</h2> |
| 4 | + <blockquote>Minimal Library Starter Kit for your Typescript projects</blockquote> |
| 5 | + |
| 6 | + <a href="https://www.npmjs.com/package/@hodgef/ts-library-boilerplate-basic"><img src="https://badgen.net/npm/v/@hodgef/ts-library-boilerplate-basic?color=blue" alt="npm version"></a> <a href="https://github.com/hodgef/ts-library-boilerplate"><img src="https://img.shields.io/github/last-commit/hodgef/ts-library-boilerplate" alt="latest commit"></a> <a href="https://github.com/hodgef/ts-library-boilerplate-basic/actions"><img alt="Build Status" src="https://github.com/hodgef/ts-library-boilerplate-basic/workflows/Build/badge.svg?color=green" /></a> <a href="https://github.com/hodgef/ts-library-boilerplate-basic/actions"> <img alt="Publish Status" src="https://github.com/hodgef/ts-library-boilerplate-basic/workflows/Publish/badge.svg?color=green" /></a> |
| 7 | + |
| 8 | +<strong>For a plain Javascript alternative, check out [js-library-boilerplate-basic](https://github.com/hodgef/js-library-boilerplate-basic).</strong> |
| 9 | + |
| 10 | +</div> |
| 11 | + |
| 12 | +## ⭐️ Features |
| 13 | + |
| 14 | +- Webpack 5 |
| 15 | +- Babel 7 |
| 16 | +- Hot reloading (`npm start`) |
| 17 | +- Automatic Types file generation (index.d.ts) |
| 18 | +- UMD exports, so your library works everywhere. |
| 19 | +- Jest unit testing |
| 20 | +- Customizable file headers for your build [(Example 1)](https://github.com/hodgef/ts-library-boilerplate-basic/blob/master/build/index.js) [(Example2)](https://github.com/hodgef/ts-library-boilerplate-basic/blob/master/build/css/index.css) |
| 21 | +- Daily [dependabot](https://dependabot.com) dependency updates |
| 22 | + |
| 23 | +## 📦 Getting Started |
| 24 | + |
| 25 | +``` |
| 26 | +git clone https://github.com/hodgef/ts-library-boilerplate-basic.git myLibrary |
| 27 | +npm install |
| 28 | +``` |
| 29 | + |
| 30 | +## 💎 Customization |
| 31 | + |
| 32 | +> Before shipping, make sure to: |
| 33 | +
|
| 34 | +1. Edit `LICENSE` file |
| 35 | +2. Edit `package.json` information (These will be used to generate the headers for your built files) |
| 36 | +3. Edit `library: "MyLibrary"` with your library's export name in `./webpack.config.js` |
| 37 | + |
| 38 | +## 🚀 Deployment |
| 39 | + |
| 40 | +1. `npm publish` |
| 41 | +2. Your users can include your library as usual |
| 42 | + |
| 43 | +### npm |
| 44 | + |
| 45 | +``` |
| 46 | +import MyLibrary from 'my-library'; |
| 47 | +const libraryInstance = new MyLibrary(); |
| 48 | +... |
| 49 | +``` |
| 50 | + |
| 51 | +### self-host/cdn |
| 52 | + |
| 53 | +``` |
| 54 | +<script src="build/index.js"></script> |
| 55 | +
|
| 56 | +const MyLibrary = window.MyLibrary.default; |
| 57 | +const libraryInstance = new MyLibrary(); |
| 58 | +... |
| 59 | +``` |
| 60 | + |
| 61 | +## ✅ Libraries built with this boilerplate |
| 62 | + |
| 63 | +> Made a library using this starter kit? Share it here by [submitting a pull request](https://github.com/hodgef/ts-library-boilerplate-basic/pulls)! |
| 64 | +
|
| 65 | +- [simple-keyboard](https://github.com/hodgef/simple-keyboard) - Javascript Virtual Keyboard |
| 66 | +- [react-simple-keyboard](https://github.com/hodgef/react-simple-keyboard) - React Virtual Keyboard |
| 67 | +- [simple-keyboard-layouts](https://github.com/hodgef/simple-keyboard-layouts) - Keyboard layouts for simple-keyboard |
0 commit comments