Skip to content

Repository files navigation

Contributors Forks Stargazers Issues MIT License


EasyKit Logo

EasyKit

A .NET-powered toolkit for web developers providing a unified console UI for Git, NPM, Composer, Laravel, and Python tools
Explore the docs »

Download Latest · Report Bug · Request Feature

Table of Contents
  1. About The Project
  2. Getting Started
  3. Usage
  4. Roadmap
  5. Contributing
  6. License
  7. Contact
  8. Acknowledgments

About The Project

EasyKit is a comprehensive Windows toolkit designed specifically for web developers. It provides a unified console interface that integrates multiple development tools including Git, NPM, Composer, Laravel Artisan, and uv (Python), making it easier to manage web development workflows on Windows systems.

Key features include:

  • Unified Interface: Single console application for all your development tools
  • Git Integration: Complete Git workflow management with secure command execution
  • NPM Support: Node.js package management
  • pnpm Support: First-class pnpm support with workspace/monorepo detection
  • uv Support: Python package/project/tool management
  • Composer Integration: PHP dependency management
  • Laravel Tools: Artisan command execution
  • Tool Marketplace: Detect and install missing development tools
  • EasyKit Doctor: Comprehensive environment diagnostics
  • Project Detection: Automatic detection of project types (Git, Node.js, pnpm, Python, uv, PHP, .NET, Docker)
  • Windows Optimized: Designed specifically for Windows 10/11
  • Modern .NET: Built with .NET 8.0 for performance and reliability
  • Security: Secure process execution with shell injection prevention
  • Context Menu Support: Quick access from Windows Explorer
  • Colorized Output: Enhanced console experience with notifications
  • Comprehensive Testing: 48+ unit tests covering security and functionality

(back to top)

Built With

  • .NET - .NET 8.0 Framework
  • C# - Primary programming language
  • Windows - Target platform
  • CommonUtilities - Shared utility library

(back to top)

Getting Started

EasyKit is designed to run on Windows systems and provides an easy way to get started with web development tools.

Prerequisites

Before running EasyKit, ensure you have the following installed:

  • Windows 10 or 11
  • .NET 8.0 Runtime - Download from Microsoft .NET
  • Optional Development Tools:
    • Git (for Git operations)
    • Node.js and NPM (for JavaScript/TypeScript projects)
    • PHP and Composer (for PHP/Laravel projects)

Installation

Option 1: Download Pre-built Release (Recommended)

  1. Visit the Releases page
  2. Download the latest EasyKit-x.x.x-x64.exe or EasyKit-x.x.x-x86.exe depending on your system
  3. Run the installer and follow the setup wizard

Option 2: Build from Source

  1. Clone the repository:
    git clone https://github.com/LoveDoLove/EasyKit.git
  2. Open EasyKit.sln in Visual Studio 2022+ or JetBrains Rider
  3. Build the solution (Release or Debug)
  4. Run the EasyKit project (admin rights recommended)

(back to top)

Usage

After installation, simply run EasyKit from your Start menu or by executing the installed application. The console interface will present you with a menu of available tools:

Key Feature Description
0 Exit Exit application
1 Git Tools Complete Git workflow management
2 NPM Tools Node.js package management
3 pnpm Tools pnpm package management with workspace support
4 Composer Tools PHP dependency management
5 Laravel Tools Laravel Artisan command execution
6 uv Tools Python package/project/tool management
7 Settings Application settings
8 Diagnostics EasyKit Doctor - Environment diagnostics
T Tool Marketplace Detect and manage development tools
Q Quit Exit application

Project Detection

EasyKit automatically detects your project type based on the following files:

  • .git/ → Git repository
  • package.json → Node.js project
  • pnpm-lock.yaml / pnpm-workspace.yaml → pnpm project
  • pyproject.toml / uv.lock → Python/uv project
  • composer.json → PHP/Composer project
  • artisan → Laravel project
  • *.csproj → .NET project
  • Dockerfile / docker-compose*.yml → Docker project

The current project type is displayed in the main menu.

Navigate through the menu using your keyboard to access the various development tools integrated into EasyKit.

For more usage details, see the in-app help or source code comments.

(back to top)

Roadmap

EasyKit has evolved significantly since its inception:

  • v3.x Series: Pure Python implementation with Windows focus
  • v4.0.6: Major transition to .NET framework
  • v4.1.x Series: Enhanced .NET implementation with improved performance
  • Current v4.2.3: Latest stable release with security fixes, pnpm/uv support, Doctor diagnostics, and project detection

Recent Additions (v4.2.3)

  • ✅ GitHub Actions CI/CD workflow for automated releases
  • ✅ Inno Setup installer packaging (x64/x86)
  • ✅ pnpm first-class support with workspace detection
  • ✅ uv Python package manager support
  • ✅ EasyKit Doctor diagnostic tool
  • ✅ Automatic project type detection
  • ✅ Secure process execution (shell injection prevention)
  • ✅ Comprehensive unit tests (48+ tests)

Future Plans

  • Improve UI/UX with project-aware menus
  • Add more Git features
  • Add Docker support
  • Add integration tests
  • Cross-platform support

See the open issues for a full list of proposed features and known issues.

(back to top)

Contributing

Contributions are what make the open source community such an amazing place to learn, inspire, and create. Any contributions you make are greatly appreciated.

To contribute:

  1. Fork the Project
  2. Create your Feature Branch (git checkout -b feature/AmazingFeature)
  3. Commit your Changes (git commit -m 'Add some AmazingFeature')
  4. Push to the Branch (git push origin feature/AmazingFeature)
  5. Open a Pull Request

Please follow the .NET Foundation code of conduct and best practices.

(back to top)

License

Distributed under the MIT License. See LICENSE for more information.

(back to top)

Contact

LoveDoLove - GitHub

Project Link: https://github.com/LoveDoLove/EasyKit

(back to top)

Sponsorship

This project is proudly supported by ZMTO as part of their open-source VPS program. We extend our sincere gratitude to ZMTO for their valuable resources and commitment to empowering open-source innovation.

(back to top)

Acknowledgments

(back to top)

About

EasyKit is a comprehensive Windows toolkit designed specifically for web developers. It provides a unified console interface that integrates multiple development tools including Git, NPM, Composer, and Laravel Artisan, making it easier to manage web development workflows on Windows systems.

Topics

Resources

Contributing

Stars

4 stars

Watchers

1 watching

Forks

Releases

Sponsor this project

Packages

Used by

Contributors

Languages