# create-hq20-dapp

> HQ20 dapp boilerplate.

Latest version **0.0.1-beta.1** (published 2020-06-01) · Apache-2.0 license · 0 weekly downloads

## Install

```sh
npm install create-hq20-dapp
pnpm add create-hq20-dapp
yarn add create-hq20-dapp
bun add create-hq20-dapp
```

Provides the command `create-hq20-dapp`.

## Health

**Score 15/100 (F)** — status: abandoned.

Positive: no vulnerabilities.

Warnings: low downloads; no types; no esm support; pre 1.0.

Negative: abandoned; low maintenance score.

## Facts

| | |
|---|---|
| Version | 0.0.1-beta.1 |
| Published | 2020-06-01 |
| First published | 2020-06-01 |
| Weekly downloads | 0 |
| License | Apache-2.0 |
| TypeScript types | none |
| Module format | CommonJS |
| Node | >= 10.20.1 |
| Dependencies | 6 |
| Unpacked size | 19.1 KB |
| Known vulnerabilities | 0 (+19 in 2 direct dependencies) |
| Install scripts | no |
| GitHub stars | 28 |
| Author | TechHQ |
| Maintainers | hq20 |

## Links

- npm: https://www.npmjs.com/package/create-hq20-dapp
- Repository: https://github.com/HQ20/create-hq20-dapp
- Homepage: https://github.com/HQ20/create-hq20-dapp#readme
- Issues: https://github.com/HQ20/create-hq20-dapp/issues
- npm.io page: https://npm.io/package/create-hq20-dapp

## Dependencies (6)

- [got](https://npm.io/package/got.md) 11.1.3
- [tar](https://npm.io/package/tar.md) 6.0.2
- [meow](https://npm.io/package/meow.md) 7.0.1
- [execa](https://npm.io/package/execa.md) 4.0.1
- [listr](https://npm.io/package/listr.md) 0.14.3
- [mkdirp](https://npm.io/package/mkdirp.md) 1.0.4

## Recent versions

- 0.0.1-beta.1 (latest) — 2020-06-01
- 0.0.1-alpha.9 — 2020-06-01

## README

<div align="center">
    <img style="" width="768" src="title.webp">
</div>

> Welcome to HQ20 create-hq20-dapp. With a couple of different templates from a basic setup for smart contracts development, a react webui and an api with cache server. This is great for every new project. Contains examples of tests, coverage, documentation generators, linters, etc.

<div align="center">
    <div>
        <a
            href="https://travis-ci.org/HQ20/create-hq20-dapp"><img
                src="https://travis-ci.org/HQ20/create-hq20-dapp.svg?branch=master" /></a>&emsp;
        <a
            href="https://dependabot.com"><img
                src="https://api.dependabot.com/badges/status?host=github&repo=HQ20/contracts" /></a>&emsp;
    </div>
</div>

## Quick Overview

```sh
npx create-hq20-dapp my-app
cd my-app
npm start
```

The following templates are available:
- **smart-contracts** an example of a solidity smart contracts project
- **react-webui** using a *create-react-app* boilerplate with typescript and ethers.js connecting to a local network
- **api** an api with a cache server built with express.js and postgresql database, listening and caching events.

## Usage

**You’ll need to have Node 8.16.0 or Node 10.16.0 or later version on your local development machine** (but it’s not required on the server). You can use [nvm](https://github.com/creationix/nvm#installation) (macOS/Linux) or [nvm-windows](https://github.com/coreybutler/nvm-windows#node-version-manager-nvm-for-windows) to switch Node versions between different projects.

To create a new app:

### Yarn

```sh
yarn create hq20-dapp my-app
```

_[`yarn create <starter-kit-package>`](https://yarnpkg.com/lang/en/docs/cli/create/) is available in Yarn 0.25+_

It will create a directory called `my-app` inside the current folder.<br>
Inside that directory, it will generate the initial project structure and install the transitive dependencies:

```
my-app
├── README.md
├── node_modules
├── package.json
├── .gitignore
├── react-webui
│   ├── (to complete)
│   └── (to complete)
├── smart-contracts
│   └── (to complete)
└── api
    └── (to complete)
```

No configuration or complicated folder structures, only the files you need to build your app.<br>
Once the installation is done, you can open your project folder:

```sh
cd my-app
```

Inside the newly created project, you can run some built-in commands:

This is a step-by-step on how to get all the workspaces working, but of course, you might not want to run the android app, so, no need to install the dependencies on that workspace. Or, you might not want to start the cache server, so you can ignore steps 3, 5 and 6. That's up to you what to run. But whatever that is, it must be it the order shown above.

## Repository updates

This repository has automatic updates, thanks to [dependabot](https://dependabot.com), with an exception to **react-webui** template. We choose to only allow to update **react-scripts** and **security** issues, with no automatic merges because that template highly relies on [CRA](https://github.com/facebook/create-react-app).

## Contributing
Pull requests are welcome. For major changes, please open an issue first to discuss what you would like to change.

Please make sure to update tests as appropriate.

## License
[Apache-2.0](LICENSE)

## Credits
* Icons made by <a href="https://www.flaticon.com/authors/srip" title="srip">srip</a> from <a href="https://www.flaticon.com/" title="Flaticon"> www.flaticon.com</a>

---
_Source: https://npm.io/package/create-hq20-dapp · Machine-readable twin of the npm.io package page. Health data is recomputed on every publish._