Getting Started

Welcome to Samvad (संवाद) — a modern, lightweight desktop HTTP API client built with Tauri and React. This guide will get you up and running in minutes.

Prerequisites

Before you begin, ensure you have the following installed:

Requirement Version Notes
Node.js 18+ Or use Bun
Bun Latest Recommended package manager
Rust 1.70+ Required for building Tauri
Xcode CLT Latest macOS only

Install Rust

curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh

Install Bun

curl -fsSL https://bun.sh/install | bash

Installation

Option 1 — Download Binary (Recommended)

Head to the GitHub Releases page and download the latest binary for your platform:

  • macOS — .dmg or .app.tar.gz
  • Linux — .AppImage or .deb
  • Windows — .msi or .exe

Option 2 — Build from Source

  1. Clone the repository
git clone https://github.com/iamdhakrey/samvad.git
cd samvad
  1. Install dependencies
bun install
  1. Start the development server
bun run tauri dev

This starts the Vite dev server and opens the native Tauri window.

  1. Build for production
bun run tauri build

The built application will be in src-tauri/target/release/bundle/.

Your First Request

Once Samvad is open, follow these steps to make your first HTTP request:

1. Create a new request tab

Click the + button in the tab bar, or press Cmd+T (macOS) / Ctrl+T (Windows/Linux).

2. Set the method and URL

  • Select GET from the method dropdown
  • Type a URL: https://jsonplaceholder.typicode.com/posts/1

3. Send the request

Click the Send button, or press Cmd+Enter / Ctrl+Enter.

4. View the response

The response panel shows:

  • Status — 200 OK
  • Time — request duration in milliseconds
  • Size — response body size
  • Headers tab — all response headers
  • Body tab — syntax-highlighted JSON response

Interface Overview

┌─────────────────────────────────────────────────────────────┐
│ TitleBar  [File] [View] [Help]              [Window controls]│
├──────────────────────────────────────────────────────────────┤
│ [Tab 1] [Tab 2] [+]                                         │
├────────────────┬─────────────────────────────────────────────┤
│                │  [GET ▾] [URL input ............] [Send]    │
│  Sidebar       │  [Params] [Headers] [Auth] [Body]           │
│  - Collections │  ─────────────────────────────────────────  │
│  - History     │  Response:                                  │
│  - Environments│  Status: 200 OK  Time: 42ms  Size: 1.2KB   │
│                │  [Body] [Headers] [Cookies] [Metrics]       │
└────────────────┴─────────────────────────────────────────────┘

Next Steps