Skip to content

VoidenHQ/voiden

Voiden logo

Voiden : The offline, Git-native API workspace.

Build, test, document, and collaborate on APIs with plain-text .void files.

No accounts. No required cloud sync. Just local files, reusable blocks, and Git.

Download Docs Changelog Blog

Discord X LinkedIn

License: Apache 2.0 Latest release

Voiden workspace showing requests, docs, and response panels

Why Voiden

Voiden is for developers, testers, and technical writers who want API work to feel like code instead of a SaaS dashboard.

  • Keep requests, notes, and reusable API building blocks (endpoint, auth, params, body) in the same .void files.
  • Work in Markdown and structured blocks instead of opaque collections locked inside an app.
  • Reuse headers, auth, bodies, and whole sections across files with linked blocks and linked files.
  • Test and document APIs without leaving the editor.
  • Collaborate with Git branches and pull requests instead of proprietary team workspaces.
  • Stay local-first with no signup and no required cloud sync.

Install

Current version: 1.5.0

Download installers for macOS, Windows, and Linux from voiden.md/download. Direct downloads are available for Apple Silicon and Intel macOS, Windows .exe, and Linux .deb, .rpm, and .AppImage builds.

Package managers

Platform Stable Early access
macOS brew install voiden brew install voiden@beta
Windows winget and Chocolatey coming soon winget and Chocolatey coming soon
Linux apt and snap support Beta apt and snap channels

Homebrew

brew install voiden
# beta
brew install voiden@beta

APT (Ubuntu / Debian)

curl -fsSL https://voiden.md/apt/stable/voiden.gpg | sudo gpg --dearmor -o /etc/apt/keyrings/voiden.gpg
echo "deb [arch=amd64 signed-by=/etc/apt/keyrings/voiden.gpg] https://voiden.md/apt/stable stable main" | sudo tee /etc/apt/sources.list.d/voiden.list
sudo apt update && sudo apt install voiden
# beta
curl -fsSL https://voiden.md/apt/beta/voiden.gpg | sudo gpg --dearmor -o /etc/apt/keyrings/voiden-beta.gpg
echo "deb [arch=amd64 signed-by=/etc/apt/keyrings/voiden-beta.gpg] https://voiden.md/apt/beta beta main" | sudo tee /etc/apt/sources.list.d/voiden-beta.list
sudo apt update && sudo apt install voiden

Snap

sudo snap install voiden
# beta
sudo snap install voiden --channel=beta

Looking for newer builds? Check the early access section on voiden.md/download.

Get started with Voiden

  1. Install Voiden and open it. No signup or login is required.
  2. Create a .void file in any folder and add your request, docs, and reusable blocks.
  3. Run the request with Cmd+Enter or Ctrl+Enter, then commit the file to Git.

For a guided first run, see the Voiden quick start.

Coming from Postman

If you already use Postman, you can bring your existing collections with you:

  1. In Postman, export your collection as JSON (v2.1 is recommended).
  2. Drag the exported JSON file into the Voiden file list on the left panel.
  3. Open the imported file and click Generate Voiden Files to create a folder of native .void files — one per request, with headers, auth, query params, path variables, bodies, and response examples preserved.

Full walkthrough: Postman Imports. OpenAPI specs work the same way via OpenAPI Imports.

What you can do

  • Build REST and HTTP requests with headers, query params, JSON/XML/YAML/form bodies, file uploads, and cURL import/export.
  • Work with GraphQL using schema import, a visual query builder, variables, and subscriptions.
  • Use WebSocket and gRPC workflows in the same workspace.
  • Add pre-request and post-response scripts in JavaScript, Python, or shell.
  • Run assertions and stitch multiple .void files into batch runs with aggregated results.
  • Import OpenAPI specs and Postman collections into native Voiden files.
  • Keep Git, terminal, docs, and API testing close together inside the desktop app.

What a .void file looks like

Voiden files combine frontmatter, Markdown, and structured void request blocks so the request and the documentation live together.

Document frontmatter:

---
version: 1.4.6
generatedBy: Voiden app
generatedAt: 2026-04-16T10:24:00.000Z
---

Markdown body:

# Hello, World

A simple GET request you can run with Cmd/Ctrl+Enter.

A void request block:

---
type: request
content:
  - type: method
    content: GET
  - type: url
    content: https://echo.apyhub.com
---

Voiden generates the document metadata and block IDs for you inside the app.

Documentation

User docs

Contributor docs

Topic Description
Fresh install Repository setup and local development
Architecture overview Core app, extension system, and request flow
Extension guide Build your own extension
Themes Create custom themes
Troubleshooting Common issues and fixes

See the documentation index for the full list.

Build from Source

For platform-specific prerequisites and troubleshooting, start with Fresh Install.

git clone https://github.com/VoidenHQ/voiden.git
cd voiden
corepack enable
yarn set version 4.3.1
yarn install
yarn workspace @voiden/core-extensions build
cd apps/electron && yarn start

If you hit Windows build issues, see Build Errors.

Project Structure

voiden/
├── apps/
│   ├── electron/          # Electron main process
│   └── ui/                # React renderer
├── core-extensions/       # Built-in extensions
└── docs/                  # Documentation

Why Electron?

Voiden is built on Electron. We are building something closer to an IDE for APIs than a lightweight request sender, so we wanted a mature, cross-platform foundation that ships consistently on macOS, Windows, and Linux, gives us deep system access for things like Git and the terminal, and lets us keep a rich, custom editor experience.

We also know Electron gets a bad reputation, often inherited from other API tools. Our take is that footprint matters, but stability, reliability, and cross-platform predictability matter more when users feel them every day. We would rather be transparent about resource usage and keep optimizing it than chase a lighter stack that breaks in subtle ways.

Read the full reasoning here: Why Voiden is Built on Electron?.

Community

Contributing

We welcome contributions. Start with:

License

This project is licensed under the Apache License 2.0.