Ecosyste.ms: Awesome

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

Awesome Lists | Featured Topics | Projects

https://github.com/pluginjs/pluginjs

A flexible modern vanilla JavaScript plugin.
https://github.com/pluginjs/pluginjs

Last synced: about 2 months ago
JSON representation

A flexible modern vanilla JavaScript plugin.

Host: GitHub
URL: https://github.com/pluginjs/pluginjs
Owner: pluginjs
Created: 2018-05-11T08:58:53.000Z (over 6 years ago)
Default Branch: master
Last Pushed: 2022-08-29T21:55:28.000Z (about 2 years ago)
Last Synced: 2024-05-19T20:45:15.578Z (4 months ago)
Language: JavaScript
Homepage:
Size: 19.9 MB
Stars: 15
Watchers: 8
Forks: 4
Open Issues: 0
Metadata Files:
- Readme: README.md

Awesome Lists containing this project

README

# @pluginjs

[![lerna](https://img.shields.io/badge/maintained%20with-lerna-cc00ff.svg)](https://lernajs.io/)
[![PRs Welcome](https://img.shields.io/badge/PRs-welcome-brightgreen.svg?style=flat-square)](http://makeapullrequest.com)

## Installation
`Nodejs 16+` and `Yarn` are required, make sure Yarn version is up-to-date.

If you do not have yarn installed, follow https://yarnpkg.com/en/docs/install.

```sh
git clone https://github.com/pluginjs/pluginjs.git && cd pluginjs
yarn
```

## Usage

Run a development server:

```sh
npx plugin
# or npx plugin start
# or npx plugin run
```

Build production bundle:

```sh
npx plugin build
# or npx plugin b
npx plugin build all
```

Create a new plugin:

```sh
npx plugin new
```

Test by jest

```sh
## When execute test command first time
# npx plugin build all
npx plugin test
```

Generate samples

```sh
npx plugin samples --sections=foo,bar
```

Publish

```sh
npx plugin publish [--repo-version=x.x.x]
```

## Update
```sh
npx lerna exec -- npx ncu -u
```

## Contributing Guide

Hi, Thank you for chooing Plugin.js

Plugin.js is a collection of modern JavaScript components.
We are excited that you are interested in contributing to us. Before submitting your contribution though, please make sure to take a moment and read through the following guidelines.

## Pull Request Guide

- Fork this repository to your own account. Do not create branches here.
- Commit info reference [Commit Message Guidelines](COMMITMESSAGE.md).
- Make sure that running `yarn build` outputs the correct files.
- Rebase before creating a PR to keep commit history clear.
- Make sure PRs are created to `dev` branch instead of `master` branch
- If your PR fixes a bug, please provide a description about the related bug.
- Mergeing a PR takes two maintainers: one approves the changes after reviewing, and then the other reviews and merges.

## Issues Guide

- Before submitting an issue, please check if similar problems have already been issued.
- Please provide OS and browser information. [codesandbox](https://codesandbox.io/) is recommended to build a live demo so that your issue can be reproduced clearly.

## Code Style

- [Prettier](https://prettier.io/)
- [ESLint](https://eslint.org/)
- [Stylelint](https://stylelint.io)

## [CSS variables](CSSVARIABLES.md)

## [Commit Message Guidelines](COMMITMESSAGE.md)

## License

@pluginjs is Licensed under [the GPL-v3 license](LICENSE).

If you want to use @pluginjs project to develop commercial sites, themes, projects, and applications, the Commercial license is the appropriate license. With this option, your source code is kept proprietary.

For purchase an Commercial License, contact us [email protected].