Skip to content

build: remove monorepo and lerna#3508

Merged
eablack merged 22 commits intov11.0.0from
eb/remove-monorepo-and-lerna
Feb 5, 2026
Merged

build: remove monorepo and lerna#3508
eablack merged 22 commits intov11.0.0from
eb/remove-monorepo-and-lerna

Conversation

@eablack
Copy link
Contributor

@eablack eablack commented Feb 2, 2026 •
edited
Loading

Summary

This PR removes the monorepo structure and Lerna dependency from the Heroku CLI. All CLI code has been moved from packages/cli/ to the root directory, and the project now uses standard npm publishing instead of Lerna.

Motivation

  • Simplifies the project structure by removing unnecessary monorepo overhead
  • Eliminates Lerna as a dependency, reducing complexity
  • Makes the repository structure more straightforward for contributors
  • Streamlines the publishing process using native npm commands

Changes Overview

1. Project Structure

  • Moved all source files from packages/cli/src/ → src/
  • Moved all test files from packages/cli/test/ → test/
  • Moved all assets and scripts from packages/cli/ to root
  • Deleted lerna.json and monorepo configuration
  • Deleted packages/cli/package.json (consolidated into root package.json)

2. Configuration Updates

  • Updated oclif.config.mjs with proper paths pointing to ./dist directory
  • Updated package.json from workspace root to actual CLI package
  • Converted README.md from symlink to actual file
  • Updated .eslintrc.cjs to reference root dist/ directory
  • Updated .versionrc.json, .gitignore, cspell.json with new paths

3. Build and Publishing

  • Created bin/run as actual file (was symlink to packages/cli/bin/run)
  • Updated GitHub Actions workflows to remove cd packages/cli commands:
    • .github/workflows/ci.yml - simplified test commands
    • .github/workflows/publish-npm.yml - replaced lerna publish with npm publish
    • .github/workflows/pack-upload.yml - updated paths
    • .github/workflows/create-cli-release.yml - updated paths
    • Other workflow files updated with new paths
  • Updated all release scripts to reference root directory
  • Updated package.json scripts to run from root
  • Updated all scripts to be ESM compatible

4. Code Changes

  • Fixed import in src/lib/pg/backups.ts (changed path reference after move)

Statistics

  • 846 files renamed/moved (packages/cli/* → root)
  • 14 files deleted (monorepo configuration and package.json files)
  • 1 actual code change (import fix in backups.ts)
  • 20+ configuration files updated with new paths

Files to Review

While there are 860+ files changed, most are simple file moves that don't require review. Please focus your review on:

Critical Configuration Files

  • package.json - consolidated package configuration
  • oclif.config.mjs - new oclif configuration with updated paths
  • bin/run - CLI entry point (was symlink, now actual file)

GitHub Workflows (Publishing)

  • .github/workflows/publish-npm.yml - now uses npm publish instead of lerna publish
  • .github/workflows/ci.yml - simplified test commands

GitHub Workflows (Supporting)

  • .github/workflows/pack-upload.yml
  • .github/workflows/create-cli-release.yml
  • .github/workflows/devcenter-doc-update.yml
  • .github/workflows/publish-to-fig-autocomplete.yml
  • .github/workflows/start-prerelease.yml
  • .github/workflows/tag-create-github-release.yml

Build & Test Configuration

  • nyc-config.js - code coverage configuration
  • .eslintrc.cjs - linting configuration
  • .eslintignore - ignored paths
  • .gitignore - ignored files
  • .versionrc.json - versioning configuration
  • cspell.json - spell check configuration

Scripts

  • scripts/comment-commands.sh
  • scripts/create-release-pr
  • scripts/release/* - all release scripts
  • scripts/sign/deb
  • scripts/upload/deb
  • scripts/utils/* - utility scripts

Code Changes

  • src/lib/pg/backups.ts - small import fix after file move

Documentation

  • README.md - converted from symlink to actual file

Testing

All existing tests should pass without modification:

  • ✓ Unit tests
  • ✓ Integration tests
  • ✓ Smoke tests
  • ✓ Acceptance tests (on main/release branches)

Deployment Notes

  • The package name remains heroku on npm
  • Publishing process changes from lerna publish to npm publish

https://gus.lightning.force.com/lightning/r/ADM_Work__c/a07EE00002TufpBYAR/view

@eablack eablack temporarily deployed to AcceptanceTests February 2, 2026 17:52 — with GitHub Actions Inactive
@eablack eablack temporarily deployed to AcceptanceTests February 2, 2026 17:52 — with GitHub Actions Inactive
@eablack eablack temporarily deployed to AcceptanceTests February 2, 2026 17:59 — with GitHub Actions Inactive
@eablack eablack temporarily deployed to AcceptanceTests February 2, 2026 17:59 — with GitHub Actions Inactive
@eablack eablack temporarily deployed to AcceptanceTests February 2, 2026 18:40 — with GitHub Actions Inactive
@eablack eablack temporarily deployed to AcceptanceTests February 2, 2026 18:40 — with GitHub Actions Inactive
@eablack eablack temporarily deployed to AcceptanceTests February 2, 2026 18:40 — with GitHub Actions Inactive
@eablack eablack temporarily deployed to AcceptanceTests February 2, 2026 18:40 — with GitHub Actions Inactive
@eablack eablack temporarily deployed to AcceptanceTests February 3, 2026 00:44 — with GitHub Actions Inactive
@eablack eablack temporarily deployed to AcceptanceTests February 3, 2026 00:44 — with GitHub Actions Inactive
@eablack eablack temporarily deployed to AcceptanceTests February 5, 2026 00:19 — with GitHub Actions Inactive
eablack added 22 commits February 5, 2026 08:54
@eablack
remove monorepo structure. move everything from packages/cli to root.
907c18a
@eablack
switch from /lib to /dist, fix eslint config
67fb9ca
@eablack
remove unneeded ignores
73bb441
@eablack
fix: regenerate package-lock.json after monorepo removal
63be552 
The package-lock.json was out of sync with package.json after removing
the monorepo structure, causing npm ci to fail in CI. Regenerated the
lock file to resolve dependency mismatches.
@eablack
fix: update paths after monorepo removal
4672225 
Update test and config file paths that were still referencing the old
monorepo structure (packages/cli).
@eablack
fix: update oclif config to use dist directory and set test root
7aa5c68 
After switching from /lib to /dist in commit 1fad4d5, the
oclif.config.mjs wasn't updated to point to the new directory.
This caused commands to not be discovered.

Also set OCLIF_TEST_ROOT environment variable in test init to help
@oclif/test find the CLI root after monorepo removal.
@eablack
fix: clean up git remotes created by apps:create tests
0d1a9b0 
The apps:create command creates actual git remotes when running in a
git repository. In tests, this was creating a 'heroku' remote pointing
to 'foobar' which then interfered with other tests that check for app
names from git remotes.

Added cleanup in afterEach to remove any heroku remotes created during
the tests.
@eablack
fix(test): add Procfile fixture for local command tests
c968304 
After removing the monorepo structure, the example Procfile that local
command tests depended on was deleted. Created a test fixture at
test/fixtures/local/Procfile with the same content.

Updated tests that verify default Procfile loading to change directory
to the fixtures location before running, ensuring they can find the
default Procfile without explicitly specifying the path.
@eablack
remove converted redis commands
5fb1a38
@eablack
make sure we run oclif manifest when we build
eab62bc
@eablack
remove dependence on lerna for publishing to npm
cd22e23
@eablack
no longer private now that the monorepo structure is gone
e6e6b4c
@eablack
move husky install to prepare so it won't run when publishing
c6e11fd
@eablack
only run husky if .git exists
c9f0ad7
@eablack
convert scripts to esm
54f421e
@eablack
fix use of execa
8969886
@eablack
actually run npm shrinkwrap, fix create-release-pr
99d61b3
@eablack
remove converted redis commands
66889cc
@eablack
publish oclif config, add protection to bin/run, and run npm install
0606c33
@eablack
fix invalidate cache script to include alpha releases
1cd25b9
@eablack
really fix cache invalidation for prereleases.
3dd0f30
@eablack
move config back into package.json
f1e4770
@eablack eablack force-pushed the eb/remove-monorepo-and-lerna branch from 194d6e7 to f1e4770 Compare February 5, 2026 16:54
@eablack eablack temporarily deployed to AcceptanceTests February 5, 2026 16:54 — with GitHub Actions Inactive
@eablack eablack temporarily deployed to AcceptanceTests February 5, 2026 16:54 — with GitHub Actions Inactive
@eablack eablack temporarily deployed to AcceptanceTests February 5, 2026 16:54 — with GitHub Actions Inactive
@eablack eablack temporarily deployed to AcceptanceTests February 5, 2026 16:54 — with GitHub Actions Inactive
@eablack eablack merged commit b439846 into v11.0.0 Feb 5, 2026
13 checks passed
@eablack eablack deleted the eb/remove-monorepo-and-lerna branch February 5, 2026 17:22
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Reviewers

@k80bowman k80bowman k80bowman approved these changes

@michaelmalave michaelmalave michaelmalave approved these changes

Assignees

No one assigned

Labels

None yet

Projects

None yet

Milestone

No milestone

Development

Successfully merging this pull request may close these issues.

3 participants

@eablack @k80bowman @michaelmalave