Remallow

The visual package manager for Node.js projects

Search, install, upgrade, and remove npm packages from your browser. No terminal commands needed.

---

Why Remallow?

Managing packages through the terminal can be tedious. You have to remember commands, manually check for outdated packages, and switch between terminal windows just to install a dependency. Remallow gives you a clean, visual interface that runs locally in your browser -- no cloud, no account, no setup. Just run remallow in your project and start managing packages visually.

---

Features

Feature	Description
Cross-platform	Works on Windows, macOS, and Linux
npm + yarn + pnpm	Supports all three major package managers
Smart search	Search npm registry with package details (description, version, publish date)
Dark & light mode	Toggle between themes with automatic persistence
Package details	View homepage, license, author, repository, and keywords for any package
Filter & organize	Filter by dependencies, devDependencies, or outdated packages
Bulk update	Update all outdated packages with one click
Toast notifications	Real-time success/error feedback with animated toasts
Skeleton loading	Smooth loading states instead of blank screens
Secure	Input validation, no shell injection, uses cross-spawn for safe command execution
Offline UI	All CSS and fonts bundled -- no CDN dependency
Configurable	Custom port via --port flag or PORT env variable

---

Quick Start

# Install globally
npm install -g remallow

# Navigate to any Node.js project
cd your-project

# Launch Remallow
remallow

That's it! Your default browser will open with the Remallow UI.

Validate Installation

remallow --test

Configuration

Option	Example	Description
--port	remallow --port 9000	Custom server port (default: 8081)
--test	remallow --test	Validate installation
PORT env	PORT=9000 remallow	Set port via environment variable

---

Screenshots

---

How It Works

Remallow is a lightweight local tool with two parts: an Express.js server that reads your project's package.json and executes package manager commands, and a React UI that renders in your browser.

Everything runs locally. No data is sent to external servers. No account needed.

Architecture

graph LR
    A[Your Browser] -->|HTTP API| B[Express Server]
    B -->|Reads| C[package.json]
    B -->|cross-spawn| D[npm / yarn / pnpm CLI]
    D -->|Modifies| E[node_modules]
    B -->|Serves| F[React SPA]
    F -->|API Calls| B

Loading

User Flow

flowchart TD
    A[Run 'remallow'] --> B[Express server starts]
    B --> C[Opens default browser]
    C --> D{Package manager selected?}
    D -->|No| E[Show npm / yarn / pnpm selector]
    E --> F[User picks one]
    F --> G[Load package list]
    D -->|Yes| G
    G --> H[Server reads package.json]
    H --> I[Display installed packages]
    I --> J{User action}
    J -->|Search| K[npm search -> dropdown results]
    J -->|Install| L[Run install -> toast notification]
    J -->|Uninstall| M[Run uninstall -> refresh list]
    J -->|Upgrade| N[Run upgrade -> refresh list]
    J -->|View details| O[npm view -> detail panel]
    K --> J
    L --> I
    M --> I
    N --> I
    O --> J

Loading

---

Comparison

Feature	Terminal	Remallow	npm-gui
Visual interface	No	Yes	Yes
Search with details	Manual (npm search)	Built-in dropdown	No
Bulk update outdated	No	One click	No
Dark mode	N/A	Yes	No
pnpm support	Yes	Yes	No
Package details panel	npm view	Built-in	No
Toast notifications	N/A	Yes	No
Cross-platform	Yes	Yes	Partial
Offline (no CDN)	N/A	Yes	No

---

Roadmap

Completed

• npm support
• yarn support
• pnpm support
• Search packages from npm registry
• Install / uninstall / upgrade packages
• View outdated packages
• Cross-platform (Windows, macOS, Linux)
• Dark / light mode
• Package detail viewer
• Toast notifications
• Security hardening (input validation, no shell injection)
• Bundled assets (no CDN dependency)
• Filter by dependency type
• Bulk update all outdated
• Skeleton loading states
• Version pinning (package@version syntax)

In Progress

• Vulnerability scanning (npm audit integration)
• Script runner (run npm scripts from the UI)
• Lock file viewer (show resolved versions)
• Package size impact (bundlephobia API integration)
• Keyboard shortcuts (Ctrl+K to search, etc.)
• Auto-detect package manager from lock file

Future

• Dependency graph visualization
• Auto-update checker with badge notifications
• Multi-project management
• Monorepo / workspace support
• Package.json diff view (before/after operations)
• Export / import dependency lists
• Plugin system for community extensions
• WebSocket-based real-time terminal output
• Package comparison view
• Favorites / bookmarks
• Install history log
• Peer dependency conflict resolver
• CI/CD integration (generate install commands)

---

Contributing

We welcome contributions! Please see CONTRIBUTING.md for details.

---

License

Released under MIT by @yokesharun.

---

If you find Remallow useful, please give it a star!