Skip to content

herbsjs/herbs-cli

Repository files navigation

CD Build codecov

herbs CLI

CLI helps speed up your development cycle with HerbsJS by generating use cases and infrastructure layers (REST, GraphQL, Repositories, etc) based on your entities.

Installing and generating a CRUD project

To install herbs-cli:

npm i -g @herbsjs/herbs-cli

Then run:

herbs new

project-setup

project-structure

Default generated project structure

.
├── package-lock.json
├── package.json
└── src
    ├── domain
    │   ├── entities
    │   └── usecases
    └── infra
        ├── api
        │   ├── graphql
        │   ├── rest
        ├── config
        └── data
            ├── database
            │   └── migrations
            └── repositories

commands

herbs new

Generate a new project based on your entities(or not)

herbs new

Options

Question Description Default value e.g
Project name? This is the Project Name that will be used int the project folder name and package.json. herbs-project my-project
Project description? This is the Project description that will be used int the package.json project generated by herbs-cli my beautiful project
Project author's name? This is the author's name that will be used int the package.json. herbs CLI Charlie
What license do you want to use? Use arrow keys to choose your License. -- --
Generate graphql layer? This will generate a graphql layer for your domain. Y n
Generate rest layer? This will generate a rest layer for your domain. Y n
What database do you want to use? Use arrow keys to choose your Database. -- --
Do you want to initialize a Git repository? This will initialize a git repository for your project. N y
Do you want to install dependencies? This will run npm install and npm start for you no yes

You also can run the project passing the options though CLI

herbs new --name MyAwesomeProjectName --description "my description" --author "name of the author" --license MIT --graphql --rest --database postgres --npmInstall yes

herbs update

Generate all necessary layers(graphql, rest, repository, etc) based on your new entity added into entities folder

After had created a new entity into entities folder, type in your terminal:

herbs update

Debugging

If you want to debug and/or run the CLI locally, you can do it by following the steps below:

npm link # On the CLI project folder

herbs # On the folder where you want to use the CLI

Contribute

Come with us to make an awesome herbs-cli.

Now, if you do not have the technical knowledge and also have intended to help us, do not feel shy, click here to open an issue and collaborate their ideas, the contribution may be a criticism or a compliment (why not?)

If you would like to help contribute to this repository, please see CONTRIBUTING