๐ฆ JS library boilerplate
Starter kit for your js library projects.
!NPMnpm-badgenpm-link !JavaScript Style Guidestyle-guide-badgestyle-guide
!Build Statusbuild-badgebuild !Semantic releasesemantic-release-badgesemantic-release !Code Coveragecoverage-badgecoverage !versionversion-badgepackage !downloadsdownloads-badgenpmtrends !MIT Licenselicense-badgelicense
!Storybookstorybook-badge
!All Contributorsall-contributors-badge !PRs Welcomeprs-badgeprs !Code of Conductcoc-badgecoc
!Watch on GitHubgithub-watch-badgegithub-watch !Star on GitHubgithub-star-badgegithub-star
Table of Contents
- โญ๏ธ Features
- ๐ฆ Getting started
- ๐ฟ Installation
- ๐ Customization
- โ๏ธ Configuration
- ๐ Deployment
- ๐ Versioning
- ๐งช Tests
- ๐ Style guide
- Issues
โญ๏ธ Features
- Rollup 2
- Babel 7
- Jest unit testing
- Test coverage and badges
- Storybook
- Travis
- Docs
- File templates for TODO, README, CONTRIBUTING, ISSUETEMPLATE, etc...
๐ฆ Getting Started
Built With
- Love :heart:
Prerequisites
- Node.js >=8
๐ฟ Installation
This module is distributed via npmnpm which is bundled with nodenode.# clone project
git clone https://github.com/nejcm/js-library-boilerplate.git my-project
# move into project
cd my-project
# install deps
npm install
๐ Customization
- Before shipping, make sure to:
- Edit
LICENSE
file - Edit
package.json
information (These will be used to generate the headers for your built files) - Replace and fill in FILL, FILL:... tags with your information
- Remove any files you do not need or edit them accordingly
โ๏ธ Configuration
Check package.json for configuration options.๐ Deployment
npm run build
๐ Versioning
We use SemVer for versioning. For the versions available see the link to tags on this repository.๐งช Tests
npm run tests
๐ Style guide
The code styles followed are documented and set with linter rules inside .eslintrc file.Issues
Looking to contribute? Look for the Good First Issuegood-first-issue label.๐ Bugs
Please file an issue for bugs, missing documentation, or unexpected behavior.See Bugsbugs
๐ก Feature Requests
Please file an issue to suggest new features. Vote on feature requests by adding a ๐. This helps maintainers prioritize what to work on.See Feature Requestsrequests
โ Questions
For questions related to using the library, please first read the docs instead of filing an issue on GitHub.Authors
Contributors
This project follows the all-contributorsall-contributors specification. Contributions of any kind welcome!