---

Utoo is a modern, high-performance frontend toolchain designed to provide a unified and optimized experience. It combines a fast package manager, a powerful bundler, and a flexible command system into a single, cohesive ecosystem.

💡 Why Utoo?

Feature	Description
Unified	One tool for package management, building, and workflow automation.
Performance	Core logic in Rust + Turbopack for extreme speed.
Compatible	Seamless migration with Webpack compatibility mode.
Universal	Run anywhere: Local, CI, or Browser (via WASM).

📦 Core Components

• utoo (alias ut): High-performance Rust package manager (Fast, Parallel, npm compatible).
• @utoo/pack: Next-gen bundler powered by Turbopack (HMR, TS/JSX, Less/Sass, and more).
• @utoo/pack-cli: Command-line interface for the bundler (dev server, build). A lightweight wrapper to run up commands — up is a shortcut alias for utoopack.
• @utoo/web: Web-compatible version of the toolchain (WASM, Browser-based bundling).

🚀 Quick Start

1. Install

# Install the core toolchain (pick one)
brew install utooland/tap/utoo   # macOS / Linux via Homebrew
npm install -g utoo              # cross-platform via npm
cargo install utoo-pm            # build from source via Cargo

# Install the bundler in nodejs environment
ut install @utoo/pack --save-dev

# Install the bundler cli in nodejs environment(Optional)
ut install @utoo/pack-cli --save-dev

# Install the web version
ut install @utoo/web --save

2. Use

Package Management

ut install          # Install dependencies (or use `ut install`)
ut add lodash       # Add a package (or use `ut add`)
ut x create-react   # Execute a package (npx style, or use `ut x`)

Bundling via @utoo/pack-cli

utx up dev          # Start dev server with HMR
utx up build        # Production build
utx up build --webpack # Build using webpack.config.js

✨ Key Features

• ⚡ Rust Powered: Maximum performance for dependency resolution and bundling.
• 🛠️ Turbopack Inside: Incremental builds and instant HMR.
• 🔌 Webpack Friendly: Partial support for existing Webpack configurations.
• 📦 Monorepo First: Built-in workspace management.
• 🌐 Web Ready: Run the entire toolchain in the browser via WASM.

📂 Project Structure

• crates/: Rust core (Package Manager, Bundler Core, WASM/NAPI bindings).
• packages/: TypeScript packages (CLI, Web version, Shared utilities).
• next.js/: Turbopack source integration (Git submodule).
• examples/: Demo projects (React, Ant Design, Webpack-compat, etc.).

🤝 Contributing

We love contributions! Check out CONTRIBUTING.md to get started.

📄 License

Utoo is licensed under the MIT License.