Skip to content

reaxi/wksp

Repository files navigation

wksp

npm Maintained

yarn workspaces extension

monorepo management tool

Table of Contents:

  1. Requirements
  2. Running
  3. Examples

Requirements

yarn

node.js

Running

Install

npm i -g wksp

then

wksp <cmd>

shorthand for: yarn workspace <cmd>

wksp will detect the package name automatically (if run inside the project folder)

if your current directory is the workspace root you can specify the name

wksp -n my-app <cmd>

shorthand for: yarn workspace <name> <cmd>

Variadic arguments

Variadic arguments are supported, (any arguments for the command)

wksp add react react-dom react-router
# cli cmd args...

Passing options

Options that are specific to yarn, require an -- --options

wksp add tailwindcss postcss autoprefixer -- --dev
# cli cmd args...                         -- yarn options

this applies when running scripts

wksp start -- --port 3002 --watch
# cli cmd -- script options

Compatibility options

-D or --dev save as dev dependency

-E or --exact save exact dependency

-P or --peer save as peer dependency

some terminals doesn't allow passing options --

you can use compatibility options directly:

wksp add -D typescript


Examples

root

cwd: .../monorepo/

projects/
    /client/
    /server/
    /ui-lib/
wksp start -n client

--name

project

cwd: .../monorepo/projects/server

wksp start

wksp will detect the package name related with this folder and run the start script defined in package.json


Have a great idea how we can extend yarn workspaces features ? suggest here