apiark

Why ApiArk?

Download

Latest Release

# Homebrew (macOS)
brew tap berbicanes/apiark
brew install --cask apiark

# Scoop (Windows)
scoop bucket add apiark https://github.com/berbicanes/apiark
scoop install apiark

# APT (Debian/Ubuntu)
curl -fsSL https://berbicanes.github.io/apiark-apt/install.sh | sudo bash
sudo apt install apiark

Also available on the Microsoft Store.

Prerequisites: Node.js 22+, pnpm 10+, Rust toolchain, Tauri v2 system deps

git clone https://github.com/berbicanes/apiark.git
cd apiark
pnpm install
pnpm tauri build

Switching from Postman

1. Export your Postman collection (Collection v2.1 JSON)
2. Open ApiArk
3. Ctrl+K > "Import Collection" > select your file
4. Done. Your requests are now YAML files you own.

Also imports from: Insomnia, Bruno, Hoppscotch, OpenAPI 3.x, HAR, cURL.

Features

Multi-Protocol — REST, GraphQL, gRPC, WebSocket, SSE, MQTT, Socket.IO in one app. No tool has broader protocol coverage.

Local-First Storage — Every request is a .yaml file. Collections are directories. Everything is git-diffable. No proprietary formats.

Dark Mode + Themes — Dark, Light, Black/OLED themes with 8 accent colors.

TypeScript Scripting — Pre/post-request scripts with full type definitions. ark.test(), ark.expect(), ark.env.set().

Collection Runner — Run entire collections with data-driven testing (CSV/JSON), configurable iterations, JUnit/HTML reports.

Local Mock Servers — Create mock APIs from your collections. Faker.js data, latency simulation, error injection. No cloud, no usage limits.

Scheduled Monitoring — Cron-based automated testing with desktop notifications and webhook alerts. Runs locally, not on someone else's server.

API Docs Generation — Generate HTML + Markdown documentation from your collections.

OpenAPI Editor — Edit and lint OpenAPI specs with Spectral integration.

Response Diff — Compare responses side-by-side across runs.

Proxy Capture — Local intercepting HTTP/HTTPS proxy for traffic inspection and replay.

AI Assistant — Natural language to requests, auto-generate tests, OpenAI-compatible API.

Plugin System — Extend ApiArk with JavaScript or WASM plugins.

Import Everything — Postman, Insomnia, Bruno, Hoppscotch, OpenAPI, HAR, cURL. One-click migration.

Performance

Built with Tauri v2 (Rust backend + native OS webview), not Electron.

Data Format

Your data is plain YAML. No lock-in. No proprietary encoding.

# users/create-user.yaml
name: Create User
method: POST
url: "{{baseUrl}}/api/users"

headers:
  Content-Type: application/json

auth:
  type: bearer
  token: "{{adminToken}}"

body:
  type: json
  content: |
    {
      "name": "{{userName}}",
      "email": "{{userEmail}}"
    }

assert:
  status: 201
  body.id: { type: string }
  responseTime: { lt: 2000 }

tests: |
  ark.test("should return created user", () => {
    const body = ark.response.json();
    ark.expect(body).to.have.property("id");
  });

CLI

# Run a collection
apiark run ./my-collection --env production

# With data-driven testing
apiark run ./my-collection --data users.csv --reporter junit

# Import a Postman collection
apiark import postman-export.json

No Lock-In Pledge

If you decide to leave ApiArk, your data leaves with you. Every file is a standard format. Every database is open. We will never make it hard to switch away.

Community

• GitHub Discussions — Ideas, Q&A, show & tell
• GitHub Issues — Bug reports and feature requests

Translations

ApiArk UI supports internationalization via react-i18next. Currently available in English.

Help us translate ApiArk into your language! See the locales/ directory and submit a PR.

Development

# Install dependencies
pnpm install

# Run in development mode
pnpm tauri dev

# TypeScript check
pnpm -C apps/desktop exec tsc --noEmit

# Build for production
pnpm tauri build

Project Structure

apiark/
├── apps/
│   ├── desktop/           # Tauri v2 desktop app
│   │   ├── src/           # React frontend
│   │   └── src-tauri/     # Rust backend
│   ├── cli/               # CLI tool (Rust)
│   ├── mcp-server/        # MCP server for AI editors
│   └── vscode-extension/  # VS Code extension
├── packages/
│   ├── types/             # Shared TypeScript types
│   └── importer/          # Collection importers
└── docs/                  # Documentation and legal

Tech Stack

Frontend: React 19, TypeScript, Vite 6, Zustand, Tailwind CSS 4, Monaco Editor, Radix UI

Backend: Rust, Tauri v2, reqwest, tokio, tonic (gRPC), axum (mock servers), deno_core (scripting)

Contributing

Contributions are welcome! Check out the GitHub Issues for open tasks and feature requests.

License

MIT