Skip to content

troubleshooting.md

Latest commit

 

History

History
37 lines (28 loc) · 1006 Bytes

troubleshooting.md

File metadata and controls

37 lines (28 loc) · 1006 Bytes

Troubleshooting Guide

Common Issues

Installation & Build

pnpm not found

Error: command not found: pnpm Solution:

  1. Ensure you have Node.js installed.
  2. Enable Corepack: corepack enable (Node.js >= 16.9.0).
  3. Or install globally: npm install -g pnpm.

Build Failures

Error: Typescript errors during pnpm build. Solution:

  1. Clean the artifacts: pnpm run clean.
  2. Install dependencies again: pnpm install.
  3. Build: pnpm build.
  4. If errors persist, check pnpm build --verbose output for specific package errors.

Runtime Issues

CLI Command Fails

Error: Error: Unknown command or similar. Solution:

  1. Check that you are passing the correct arguments.
  2. Refer to pnpm start --help.
  3. Ensure the CLI package (@forge-ts/cli) is built (pnpm --filter @forge-ts/cli run build).

Debugging

To get more verbose output, you can set the LOG_LEVEL environment variable:

LOG_LEVEL=debug pnpm start ...