# Hammer

Hammer is a no-config cli tool for running concurrent tasks with monorepo support.
Monorepo tooling *should* be as simple as it can. Unfortunately, the current tooling is overly 
complex and can lead to a lot of time spent configuring and debugging, when you should be 
worried about writing your code.

You can think of Hammer as a lightweight alternative for turborepo. Currently, it only
supports JS/TS projects. In the future it could expand and have a larger number of languages
supported.

### The `hammer` bin

The `hammer` binary is hammer's CLI. It aims to be as simple as it can get.

Syntax:
```bash
hammer <SCRIPT> [OPTS]
```
 
Example:

```bash
hammer dev
```
*Runs all the workspaces projects "hammer:dev" scripts.*
 
#### Disabling the prefix 
By default, hammer will look up for all the scripts containing the prefix `hammer:` in package.json,
thus making it easy to gradually adopt the tool and run only the scripts you want using it.
If you don't want this, just use the `--no-prefix` flag and hammer will look for the `dev` script directly:

```bash
hammer dev --no-prefix
``` 
*Runs all workspace projects "dev" scripts.*

**alias**: -n

#### Filtering
 
You can filter which projects should be targeted by hammer:

```bash
hammer dev --filter web
```
*Will only run the dev script of the project that contains a package.json with the "name" being "web"* 

**alias**: -f

#### Environment variables

By default, hammer will load the root .env file and inject all of its variables in every child
process that it starts. You can also pass variables via the command line, and they will override system
variables or root .env variables. This is really useful for changing some environment in a testing script,
for example:

```bash
hammer test --env NODE_ENV:TESTING
```

*Will run all workspaces "hammer:test" scripts and inject a environment variable NODE_ENV=TESTING*

**alias**: -e

I recommend setting up some scripts in the root package.json so it becomes easy to have these separate
environments:

```json
{
    ...
    "scripts": {
        "dev": "hammer dev",
        "test": "hammer test -e NODE_ENV:TESTING"
    },
    ...
}
```
*Easy to run with `pnpm dev`, `pnpm test`*