Skip to content

Repository files navigation

Package Pilot

Version License Platform Tech Stack

The Problem It Solves

Package Pilot replaces manual, error-prone terminal commands with a clean GUI for local package linking and testing. Before publishing your Node.js libraries, test them locally with confidence in a sandboxed environment.

Key Features

  • Project Management: Add projects, scan for packages automatically, filter by CLI packages
  • Package Discovery: Browse all packages across projects with dependency details, versions, and package manager detection
  • Multiple Linking Strategies:
    • Symlink (npm link) — Fast symbolic linking via npm
    • Yalc — Local publish/install with best balance of speed and reliability
    • npm pack — Creates a tarball and installs it for realistic simulation
    • Workspace (file:) — Adds file: reference in package.json for monorepos
    • File Copy — Directly copies files to node_modules
  • Package Selection: Searchable dropdown grouped by project for quick package selection
  • Automated Sandboxes: Instantly create isolated environments for testing CLI packages
  • Built-in Terminal: Integrated xterm.js terminal with PTY support and command persistence
  • Live Watcher: Automatically run build scripts when your source code changes
  • File Change Events: Real-time file system monitoring with event type detection (Created, Modified, Deleted)
  • System Doctor: Diagnose symlink permissions, Node.js installation, and environment setup
  • Activity Logs: Real-time log stream from all backend operations with filtering and search
  • Settings: Configurable default package manager, auto-build, auto-install peer deps, watcher debounce, theme
  • Dashboard: Overview of projects, packages, active links, and watchers with quick actions

Getting Started

Prerequisites

Installation

Clone the repository and install the dependencies:

npm install

Running the App

Start the application in development mode:

npm run tauri dev

Building for Production

npm run tauri build

Tech Stack

  • Backend: Tauri (Rust)
  • Frontend: React with Fluent UI
  • State Management: Zustand
  • Terminal: xterm.js with PTY integration
  • Build Tool: Vite & TypeScript

License

This project is licensed under the MIT License.

About

An app to test node packages locally before shipping them off to NPM

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages