🐰 Hopp

Lightweight, cross-platform API testing tool built with Flutter

简体中文 | English

🤖 100% AI Developed — Built with Kimi Code CLI · Powered by Kimi 2.5 Model

---

✨ Features

• 🔥 Lightweight & Fast - Native performance with Flutter
• 🖥️ Cross-Platform - macOS, Windows, Linux
• 📝 Request Editor - Support for Params, Headers, Body (JSON, Form, Text)
• 🗂️ Collections - Organize requests into folders
• 📑 Multiple Tabs - Work with multiple requests simultaneously
• 🌓 Dark Mode - Support for light/dark/system themes
• 🌍 Internationalization - English and Chinese support
• 📊 Response Viewer - View response body, headers, and timing information
• 🔒 HTTPS Certificate - View SSL/TLS certificate details
• ⏱️ Timing Analysis - DNS, TCP, TLS, TTFB, Download time breakdown
• ⚡ Optimized Display - Virtualized rendering for large responses (>50KB)
• ⌨️ Keyboard Shortcuts - Cmd+N, Cmd+Enter, Cmd+S, Cmd+W, etc.
• 🧪 UI Test Mode - Built-in HTTP command server for automated testing

---

🚀 Quick Start

Prerequisites

• Flutter 3.27+
• FVM (recommended for version management)
• Dart 3.6+

Development

# Clone the repository
git clone https://github.com/scottli139/hopp.git
cd hopp

# Install FVM (if not installed)
dart pub global activate fvm

# Use project Flutter version
fvm use

# Install dependencies
fvm flutter pub get

# Run development
fvm flutter run -d macos

China Mirror Setup

For developers in mainland China, configure Flutter mirrors:

# Add to ~/.zshrc or ~/.bashrc
export PUB_HOSTED_URL=https://pub.flutter-io.cn
export FLUTTER_STORAGE_BASE_URL=https://storage.flutter-io.cn

Build

# Build for macOS
fvm flutter build macos --release

# Build for Windows
fvm flutter build windows --release

# Build for Linux
fvm flutter build linux --release

---

🏗️ Architecture

hopp/
├── lib/
│   ├── models/          # Data models (Freezed + Hive)
│   ├── providers/       # Riverpod state management
│   ├── services/        # HTTP & Storage services
│   ├── widgets/         # UI components
│   ├── screens/         # App screens
│   ├── utils/           # Utilities
│   └── l10n/            # Localization
├── macos/               # macOS platform code
├── windows/             # Windows platform code
├── linux/               # Linux platform code
├── test/                # Unit tests
└── docs/                # Documentation

---

🛠️ Tech Stack

• Framework: Flutter 3.27.x, Dart 3.6+
• State Management: Riverpod 2.x
• HTTP Client: Dio 5.x
• Local Storage: Hive + SharedPreferences
• UI Components: Material Design 3
• Code Generation: Freezed, json_serializable
• Testing: Mockito, integration_test, Peekaboo

---

📝 License

MIT License

---

🤝 Contributing

Contributions are welcome! Please read CONTRIBUTING.md for details.

---

Built with ❤️ by AI · Powered by Kimi