UNPKG

11.1 kBMarkdownView Raw
1# charlike [![npm version][npmv-img]][npmv-url] [![github release][ghrelease-img]][ghrelease-url] [![License][license-img]][license-url]
2
3> Small, fast and streaming project scaffolder with support for hundreds of template engines and sane defaults
4
5Please consider following this project's author, [Charlike Mike Reagent](https://github.com/tunnckoCore), and :star: the project to show your :heart: and support.
6
7<div id="thetop"></div>
8
9[![Code style][codestyle-img]][codestyle-url]
10[![CircleCI linux build][linuxbuild-img]][linuxbuild-url]
11[![CodeCov coverage status][codecoverage-img]][codecoverage-url]
12[![DavidDM dependency status][dependencies-img]][dependencies-url]
13[![Renovate App Status][renovateapp-img]][renovateapp-url]
14[![Make A Pull Request][prs-welcome-img]][prs-welcome-url]
15[![Semantically Released][new-release-img]][new-release-url]
16
17If you have any _how-to_ kind of questions, please read the [Contributing Guide](./CONTRIBUTING.md) and [Code of Conduct](./CODE_OF_CONDUCT.md) documents.
18For bugs reports and feature requests, [please create an issue][open-issue-url] or ping
19[@tunnckoCore](https://twitter.com/tunnckoCore) at Twitter.
20
21[![Become a Patron][patreon-img]][patreon-url]
22[![Conventional Commits][ccommits-img]][ccommits-url]
23[![NPM Downloads Weekly][downloads-weekly-img]][npmv-url]
24[![NPM Downloads Monthly][downloads-monthly-img]][npmv-url]
25[![NPM Downloads Total][downloads-total-img]][npmv-url]
26[![Share Love Tweet][shareb]][shareu]
27
28Project is [semantically](https://semver.org) & automatically released on [CircleCI](https://circleci.com) with [new-release][] and its [New Release](https://github.com/apps/new-release) GitHub App.
29
30<!-- Logo when needed:
31
32<p align="center">
33 <a href="https://github.com/tunnckoCoreLabs/charlike">
34 <img src="./media/logo.png" width="85%">
35 </a>
36</p>
37
38-->
39
40## Table of Contents
41
42- [Install](#install)
43- [API](#api)
44- [See Also](#see-also)
45- [Contributing](#contributing)
46 * [Follow the Guidelines](#follow-the-guidelines)
47 * [Support the project](#support-the-project)
48 * [OPEN Open Source](#open-open-source)
49 * [Wonderful Contributors](#wonderful-contributors)
50- [License](#license)
51
52_(TOC generated by [verb](https://github.com/verbose/verb) using [markdown-toc](https://github.com/jonschlinkert/markdown-toc))_
53
54## Install
55
56This project requires [**Node.js**](https://nodejs.org) **^8.11.0 || >=10.13.0**. Install it using
57[**yarn**](https://yarnpkg.com) or [**npm**](https://npmjs.com).
58_We highly recommend to use Yarn when you think to contribute to this project._
59
60```bash
61$ yarn add charlike
62```
63
64## API
65
66<!-- docks-start -->
67_Generated using [docks](http://npm.im/docks)._
68
69<!-- docks-end -->
70
71**[back to top](#thetop)**
72
73## See Also
74
75Some of these projects are used here or were inspiration for this one, others are just related. So, thanks for your
76existance!
77- [@tunnckocore/config](https://www.npmjs.com/package/@tunnckocore/config): All the configs for all the tools, in one place | [homepage](https://github.com/tunnckoCoreLabs/config "All the configs for all the tools, in one place")
78- [@tunnckocore/create-project](https://www.npmjs.com/package/@tunnckocore/create-project): Create and scaffold a new project, its GitHub repository and contents | [homepage](https://github.com/tunnckoCoreLabs/create-project "Create and scaffold a new project, its GitHub repository and contents")
79- [@tunnckocore/execa](https://www.npmjs.com/package/@tunnckocore/execa): Thin layer on top of [execa][] that allows executing multiple commands in… [more](https://github.com/tunnckoCoreLabs/execa) | [homepage](https://github.com/tunnckoCoreLabs/execa "Thin layer on top of [execa][] that allows executing multiple commands in parallel or in sequence")
80- [@tunnckocore/update](https://www.npmjs.com/package/@tunnckocore/update): Update a repository with latest templates from `charlike`. | [homepage](https://github.com/tunnckoCoreLabs/update "Update a repository with latest templates from `charlike`.")
81- [asia](https://www.npmjs.com/package/asia): Blazingly fast, magical and minimalist testing framework, for Today and Tomorrow | [homepage](https://github.com/olstenlarck/asia#readme "Blazingly fast, magical and minimalist testing framework, for Today and Tomorrow")
82- [docks](https://www.npmjs.com/package/docks): Extensible system for parsing and generating documentation. It just freaking works! | [homepage](https://github.com/tunnckoCore/docks "Extensible system for parsing and generating documentation. It just freaking works!")
83- [git-commits-since](https://www.npmjs.com/package/git-commits-since): Get all commits since given period of time or by default from… [more](https://github.com/tunnckoCoreLabs/git-commits-since) | [homepage](https://github.com/tunnckoCoreLabs/git-commits-since "Get all commits since given period of time or by default from latest git semver tag. Also detects and calculates next needed / recommended bump for your package. Based on [recommended-bump][], [parse-commit-message][], [detect-next-version][], [git-semver")
84- [gitcommit](https://www.npmjs.com/package/gitcommit): Lightweight and joyful `git commit` replacement. Conventional Commits compliant. | [homepage](https://github.com/tunnckoCore/gitcommit "Lightweight and joyful `git commit` replacement. Conventional Commits compliant.")
85
86**[back to top](#thetop)**
87
88## Contributing
89
90### Follow the Guidelines
91
92Please read the [Contributing Guide](./CONTRIBUTING.md) and [Code of Conduct](./CODE_OF_CONDUCT.md) documents for advices.
93For bugs reports and feature requests, [please create an issue][open-issue-url] or ping
94[@tunnckoCore](https://twitter.com/tunnckoCore) at Twitter.
95
96### Support the project
97
98[Become a Partner or Sponsor?][patreon-url] :dollar: Check the **Partner**, **Sponsor** or **Omega-level** tiers! :tada: You can get your company logo, link & name on this file. It's also rendered on package page in [npmjs.com][npmv-url] and [yarnpkg.com](https://yarnpkg.com/en/package/charlike) sites too! :rocket:
99
100Not financial support? Okey! [Pull requests](https://github.com/tunnckoCoreLabs/contributing#opening-a-pull-request), stars and all kind of [contributions](https://opensource.guide/how-to-contribute/#what-it-means-to-contribute) are always
101welcome. :sparkles:
102
103### OPEN Open Source
104
105This project is following [OPEN Open Source](http://openopensource.org) model
106
107> Individuals making significant and valuable contributions are given commit-access to the project to contribute as they see fit. This project is built on collective efforts and it's not strongly guarded by its founders.
108
109There are a few basic ground-rules for its contributors
110
1111. Any **significant modifications** must be subject to a pull request to get feedback from other contributors.
1122. [Pull requests](https://github.com/tunnckoCoreLabs/contributing#opening-a-pull-request) to get feedback are _encouraged_ for any other trivial contributions, but are not required.
1133. Contributors should attempt to adhere to the prevailing code-style and development workflow.
114
115### Wonderful Contributors
116
117Thanks to the hard work of these wonderful people this project is alive! It follows the
118[all-contributors](https://github.com/kentcdodds/all-contributors) specification.
119Don't hesitate to add yourself to that list if you have made any contribution! ;) [See how,
120here](https://github.com/jfmengels/all-contributors-cli#usage).
121
122<!-- ALL-CONTRIBUTORS-LIST:START - Do not remove or modify this section -->
123<!-- prettier-ignore -->
124| [<img src="https://avatars3.githubusercontent.com/u/5038030?v=4" width="120px;"/><br /><sub><b>Charlike Mike Reagent</b></sub>](https://tunnckocore.com)<br />[πŸ’»](https://github.com/tunnckoCoreLabs/charlike/commits?author=tunnckoCore "Code") [πŸ“–](https://github.com/tunnckoCoreLabs/charlike/commits?author=tunnckoCore "Documentation") [πŸ’¬](#question-tunnckoCore "Answering Questions") [πŸ‘€](#review-tunnckoCore "Reviewed Pull Requests") [πŸ”](#fundingFinding-tunnckoCore "Funding Finding") |
125| :---: |
126
127<!-- ALL-CONTRIBUTORS-LIST:END -->
128
129Consider showing your [support](#support-the-project) to them. :sparkling_heart:
130
131## License
132
133Copyright (c) 2016-present, [Charlike Mike Reagent](https://tunnckocore.com) `<mameto2011@gmail.com>` & [contributors](#wonderful-contributors).
134Released under the [Apache-2.0 License][license-url].
135
136<!-- Heading badges -->
137
138[npmv-url]: https://www.npmjs.com/package/charlike
139[npmv-img]: https://badgen.net/npm/v/charlike?icon=npm
140
141[ghrelease-url]: https://github.com/tunnckoCoreLabs/charlike/releases/latest
142[ghrelease-img]: https://badgen.net/github/release/tunnckoCoreLabs/charlike?icon=github
143
144[license-url]: https://github.com/tunnckoCoreLabs/charlike/blob/master/LICENSE
145[license-img]: https://badgen.net/npm/license/charlike
146
147<!-- Front line badges -->
148
149[codestyle-url]: https://github.com/airbnb/javascript
150[codestyle-img]: https://badgen.net/badge/code%20style/airbnb/ff5a5f?icon=airbnb
151
152[linuxbuild-url]: https://circleci.com/gh/tunnckoCoreLabs/charlike/tree/master
153[linuxbuild-img]: https://badgen.net/circleci/github/tunnckoCoreLabs/charlike/master?label=build&icon=circleci
154
155[codecoverage-url]: https://codecov.io/gh/tunnckoCoreLabs/charlike
156[codecoverage-img]: https://badgen.net/codecov/c/github/tunnckoCoreLabs/charlike?icon=codecov
157
158[dependencies-url]: https://david-dm.org/tunnckoCoreLabs/charlike
159[dependencies-img]: https://badgen.net/david/dep/tunnckoCoreLabs/charlike?label=deps
160
161[ccommits-url]: https://conventionalcommits.org/
162[ccommits-img]: https://badgen.net/badge/conventional%20commits/v1.0.0/dfb317
163[new-release-url]: https://ghub.io/new-release
164[new-release-img]: https://badgen.net/badge/semantically/released/05c5ff
165
166[downloads-weekly-img]: https://badgen.net/npm/dw/charlike
167[downloads-monthly-img]: https://badgen.net/npm/dm/charlike
168[downloads-total-img]: https://badgen.net/npm/dt/charlike
169
170[renovateapp-url]: https://renovatebot.com
171[renovateapp-img]: https://badgen.net/badge/renovate/enabled/green
172[prs-welcome-img]: https://badgen.net/badge/PRs/welcome/green
173[prs-welcome-url]: http://makeapullrequest.com
174[paypal-donate-url]: https://paypal.me/tunnckoCore/10
175[paypal-donate-img]: https://badgen.net/badge/$/support/purple
176[patreon-url]: https://www.patreon.com/bePatron?u=5579781
177[patreon-img]: https://badgen.net/badge/patreon/tunnckoCore/F96854?icon=patreon
178[patreon-sponsor-img]: https://badgen.net/badge/become/a%20sponsor/F96854?icon=patreon
179
180[shareu]: https://twitter.com/intent/tweet?text=https://github.com/tunnckoCoreLabs/charlike&via=tunnckoCore
181[shareb]: https://badgen.net/badge/twitter/share/1da1f2?icon=twitter
182[open-issue-url]: https://github.com/tunnckoCoreLabs/charlike/issues/new
183
184[detect-next-version]: https://github.com/tunnckoCoreLabs/detect-next-version
185[execa]: https://github.com/sindresorhus/execa
186[new-release]: https://github.com/tunnckoCore/new-release
187[parse-commit-message]: https://github.com/olstenlarck/parse-commit-message
188[recommended-bump]: https://github.com/tunnckoCoreLabs/recommended-bump
189[semantic-release]: https://github.com/semantic-release/semantic-release
\No newline at end of file