Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/awibox/react-npm-package-template

The template that will help you quickly start developing your NPM package for React
https://github.com/awibox/react-npm-package-template

coveralls css-modules eslint jest npm-package react-component scss template travis-ci webpack

Last synced: 28 days ago
JSON representation

The template that will help you quickly start developing your NPM package for React

Awesome Lists containing this project

README

        

![react-npm-package-template](https://repository-images.githubusercontent.com/236028186/e0034e00-3ee4-11ea-8676-b3f80c86678a)

[![Version](https://img.shields.io/npm/v/react-npm-package-template)](https://www.npmjs.com/package/react-npm-package-template)
[![Build](https://travis-ci.org/awibox/react-npm-package-template.svg?branch=master)](https://travis-ci.org/awibox/react-npm-package-template)
[![Coverage](https://coveralls.io/repos/github/awibox/react-npm-package-template/badge.svg?branch=master)](https://coveralls.io/github/awibox/react-npm-package-template?branch=master)
[![Minified size](https://img.shields.io/bundlephobia/min/react-npm-package-template)](https://github.com/awibox/react-npm-package-template/blob/master/LICENSE)
[![Downloads](https://img.shields.io/npm/dm/react-npm-package-template)](https://www.npmjs.com/package/react-npm-package-template)
[![Dependabot](https://api.dependabot.com/badges/status?host=github&repo=awibox/react-npm-package-template)](https://dependabot.com)
[![PRs Welcome](https://img.shields.io/badge/PRs-welcome-brightgreen.svg)](https://github.com/awibox/react-npm-package-template/pulls)
[![Tested with jest](https://img.shields.io/badge/tested_with-jest-99424f.svg)](https://github.com/facebook/jest)

## Table of contents
* [How to install](#howtoinstall)
* [Initializing the package](#initializing)
* [Rename a component](#rename)
* [Build of the package](#build)
* [Publishing a package](#publish)
* [Travis CI](#travis)
* [Coveralls](#coveralls)
* [Badges in the readme](#badges)
* [Community profile](#community)
* [Contributing](#contributing)


## How to install
You can use this project like template.
To do this, you need press button "**Use this template**".

Or clone repository and go to the project folder.
```bash
git clone https://github.com/awibox/react-redux-app-boilerplate.git ProjectName
cd ProjectName
```
Then you should install required dependencies.
```bash
yarn install
```

## Initializing the package
The first step is to initialize your package. You should execute following command:
```bash
npm init
```
And fill in the required fields (package name, version, license). You can correct the other fields manually in the **package.json**.


## Rename a component
The next step is to replace the ```YourComponentName``` in the entire project with the one you need.


## Build of the package
After writing the code you need to build the package with the following command:
```bash
yarn build
```


## Publishing a package
To publish a package, run the command:
```bash
npm publish
```
If you are not logged in to npm you should run the command before publishing:
```bash
npm login
```


## Travis CI
You need to register on the [Travis CI](https://travis-ci.org/) and connect the repository.


## Coveralls
You need to register on the [Coveralls](https://coveralls.io/) and connect the repository.


## Badges in the README.md
For **badges** to work you need to change the repository name in the link and image paths.


## Community profile
Don't forget to edit files such as [CONTRIBUTING.md](/.github/CONTRIBUTING.md) and [CODE_OF_CONDUCT.md](/.github/CODE_OF_CONDUCT.md).


## Contributing
Please read through our [CONTRIBUTING.md](/.github/CONTRIBUTING.md).