Hopp — Local-first, Private AI API Workbench

Features

Local-first, private by default

API tooling that keeps your data on your machine, with AI as an opt-in enhancement.

🔥

Lightweight & Fast

Native performance with Flutter — no Electron bloat.

💻

Cross-Platform

Runs on macOS, Windows, and Linux.

📝

Request Editor

Params, Headers, and Body with JSON, Form, and Text editors.

🗂️

Collections

Organize requests into nested folders with import/export.

📑

Multiple Tabs

Work with many requests simultaneously.

🌓

Dark Mode

Light, dark, and system themes.

🌍

Internationalization

English and Simplified Chinese built in.

📊

Response Viewer

Body, headers, status, size, and timing in one place.

🔒

HTTPS Certificate

Inspect SSL/TLS certificate details.

⏱️

Timing Analysis

DNS, TCP, TLS, TTFB, and download time breakdown.

⚡

Optimized Display

Virtualized rendering for large responses (>50 KB).

⌨️

Keyboard Shortcuts

Cmd+N, Cmd+Enter, Cmd+S, Cmd+W, and more.

🧪

UI Test Mode

Built-in HTTP command server for automated testing.

🔐

Environment Variables

Multi-environment + globals with {{var}} interpolation, dynamic variables, and secret masking.

🔗

Pre-request Chain

Declarative login → token extraction, 401 auto-retry, sha1/aes/hmac transforms — no JS sandbox.

📥

OpenAPI Import

Import OpenAPI 3.x / Swagger 2.0 from file or URL, with pick-and-preview.

✅

Assertions + CLI

Status/Header/Body/JSONPath assertions, Tests result tab, and hopp run for CI.

Screenshots

Built for daily API work

Dark and light themes, timing breakdowns, pre-request chains, assertions, and OpenAPI import.

Hopp dark theme — request editor with response viewer — Request editor & response viewer — dark

Response timing breakdown — Timing breakdown

Pre-request chain with token extraction — Pre-request chain

OpenAPI import dialog — OpenAPI / Swagger import

Quick Start

Get up and running

Requirements and the commands you need to develop and build Hopp.

Prerequisites

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

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 the project's Flutter version and install dependencies
fvm use
fvm flutter pub get

# Run on macOS
fvm flutter run -d macos

Build

# Build for macOS / Windows / Linux
fvm flutter build macos --release
fvm flutter build windows --release
fvm flutter build linux --release

🇨🇳 Mainland China developers can speed up downloads with the Flutter mirrors — see the full setup in README.

Architecture

Clean, layered design

Built with a clear separation between presentation, state, domain, and data.

🎨

Presentation

Screens and reusable widgets rendering UI.

🧭

State

Riverpod providers and notifiers managing async state.

🧩

Domain

Freezed models and business services.

💾

Data

Hive, SharedPreferences, and Dio for storage and network.

Project structure

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 & widget tests
└── docs/                # Documentation

Tech stack

Concern	Technology
Framework	Flutter 3.27.x, Dart 3.6+
State management	Riverpod 2.x
HTTP client	Dio 5.x
Local storage	Hive + SharedPreferences
UI	Material Design 3
Code generation	Freezed, json_serializable
Testing	Mockito, integration_test, Peekaboo