@jaypie/repokit

Prerequisites: npm install -D @jaypie/repokit

Overview

@jaypie/repokit bundles common development tools to reduce dependency duplication across monorepo packages.

Installation

npm install -D @jaypie/repokit

Quick Reference

Bundled Tools

Tool	Purpose	Command
dotenv	Environment variables	npx dotenv
env-cmd	Run with env file	npx env-cmd
rimraf	Cross-platform rm -rf	npx rimraf
sort-package-json	Sort package.json	npx sort-package-json
tsx	TypeScript execution	npx tsx

Usage

Environment Variables

Load .env file:

npx dotenv -- node script.js

Run with Env File

npx env-cmd -f .env.local npm run dev

In package.json:

{
  "scripts": {
    "dev": "env-cmd -f .env.local tsx watch src/server.ts"
  }
}

Clean Build Output

npx rimraf dist

In package.json:

{
  "scripts": {
    "clean": "rimraf dist",
    "build": "npm run clean && vite build"
  }
}

Sort package.json

npx sort-package-json

In package.json:

{
  "scripts": {
    "format:package": "sort-package-json"
  }
}

TypeScript Execution

Run TypeScript directly:

npx tsx src/script.ts

Watch mode:

npx tsx watch src/server.ts

Monorepo Benefits

Install once at root, available to all packages:

project/
├── package.json          # Has @jaypie/repokit
├── packages/
│   ├── api/
│   │   └── package.json  # No need for rimraf, tsx, etc.
│   └── worker/
│       └── package.json

Common Scripts

{
  "scripts": {
    "build": "rimraf dist && vite build && tsc --emitDeclarationOnly",
    "clean": "rimraf dist",
    "dev": "env-cmd -f .env.local tsx watch src/server.ts",
    "format:package": "sort-package-json"
  }
}

dotenv-cli vs env-cmd

Both are included. Prefer env-cmd for:

• Multiple env files: env-cmd -f .env.local -f .env.secrets
• Fallback files: env-cmd -f .env.local --fallback

Use dotenv for simple cases:

dotenv -- node script.js

Related

• @jaypie/eslint - Linting configuration
• Project Structure - Monorepo setup