PackageFlow

Developer workflow management tool for frontend and Node.js projects

Features • Installation • Screenshots • Development • Contributing • License

繁體中文

---

What is PackageFlow?

PackageFlow is a desktop application that streamlines your development workflow. Built with Tauri, React, and Rust, it provides a unified interface for managing Git operations, automating tasks, handling monorepo projects, and ensuring package security.

Features

Visual Workflow Automation

Create and execute custom workflows with a drag-and-drop visual editor. Chain multiple tasks together, set up webhooks for notifications, and trigger workflows from other workflows.

• Drag-and-drop workflow builder
• Real-time execution output
• Webhook notifications (Slack, Discord, custom)
• Workflow templates for common tasks
• Pause/resume execution

Git Integration

Comprehensive Git management without leaving the app.

• Stage/unstage files with visual diff viewer
• Commit with syntax-highlighted previews
• Branch management (create, switch, delete)
• Stash management
• Remote operations (push, pull, fetch)
• Rebase support

Git Worktree Management

Work on multiple branches simultaneously with Git worktrees.

• Create and manage worktrees
• Quick switcher (Cmd+K / Ctrl+K)
• Status badges showing changes
• Open in your preferred IDE (VS Code, Cursor, Zed)
• Worktree templates

Monorepo Support

First-class support for Nx and Turborepo workspaces.

• Auto-detect monorepo tools
• Run targets across packages
• Dependency graph visualization
• Cache management
• Batch script execution

Security Audit

Keep your dependencies secure with built-in vulnerability scanning.

• npm audit / Snyk integration
• Vulnerability severity breakdown
• CVSS scores and CVE details
• Fix recommendations
• Scan history and reminders

Terminal Integration

Full PTY terminal with session persistence.

• Interactive terminal sessions
• Auto-reconnect after refresh
• Output history preservation
• Multi-instance support

Additional Features

• Keyboard shortcuts - Customizable shortcuts for common actions
• iOS/Android build inspection - Analyze IPA and APK files
• Data export/import - Backup and restore your configurations
• Dark/Light theme - Easy on the eyes, day or night

Installation

Homebrew (macOS)

brew tap runkids/tap
brew install --cask packageflow

Manual Download

Download the latest release from the Releases page.

Screenshots

Click on any image to view full size

Development

Prerequisites

• Node.js 18+
• Rust 1.70+
• pnpm

Setup

# Clone the repository
git clone https://github.com/runkids/PackageFlow.git
cd PackageFlow

# Install dependencies
pnpm install

# Start development
pnpm tauri dev

Build

# Build for production
pnpm tauri build

Project Structure

├── src/                    # React frontend
│   ├── components/         # UI components
│   │   ├── project/        # Project management
│   │   ├── workflow/       # Workflow editor
│   │   ├── security/       # Security audit
│   │   └── ui/             # Reusable UI components
│   ├── hooks/              # Custom React hooks
│   ├── lib/                # Utilities & Tauri API
│   └── types/              # TypeScript types
├── src-tauri/              # Rust backend
│   └── src/
│       ├── commands/       # Tauri IPC handlers
│       └── models/         # Data structures
└── homebrew/               # Homebrew cask formula

Contributing

We welcome contributions! Please see our Contributing Guide for details.

Ways to Contribute

• Report bugs and request features via Issues
• Submit pull requests for bug fixes or new features
• Improve documentation
• Share your workflow templates

Development Guidelines

1. Fork the repository
2. Create a feature branch (git checkout -b feature/amazing-feature)
3. Commit your changes (git commit -m 'Add amazing feature')
4. Push to the branch (git push origin feature/amazing-feature)
5. Open a Pull Request

License

This project is licensed under the MIT License - see the LICENSE file for details.

Acknowledgments

• Tauri - For the amazing cross-platform framework
• React Flow - For the workflow visualization
• Lucide - For the beautiful icons
• Claude Code - AI-powered development assistance

---

Made with ❤️ by runkids