Overview

TestForge Documentation

TestForge is a browser-based API inspection and debugging workspace. Quickly fire HTTP requests, inspect responses, validate assertions, and debug APIs from a single interface.

On this page

  • Core Features
  • How it works
  • Where to start

Core Features

API Inspector

Fire HTTP requests directly from your browser. Configure method, headers, auth, and body — then inspect the full response with formatted JSON, timing data, and status metadata.

Request History

TestForge stores your last 30 requests locally. Replay any past call instantly, star favorites, and diff responses across runs — your full debugging session is always one click away.

Secure Proxy

All outbound requests are routed through a server-side proxy, preventing CORS issues and keeping credentials out of browser logs. No data is persisted server-side.

Local AI Assistant

An on-device AI assistant explains error messages, suggests assertions, and helps you craft request bodies — all without sending your API data to a third-party cloud.

Collections & Environments

Organise related requests into named collections and swap between local, staging, and production configs using environment variables — no editing requests required.


How It Works

TestForge consists of three layers working together:

  1. Browser UI — A Next.js app where you configure and send requests. All state (history, saved tests, environment variables) lives in localStorage — nothing is sent to our servers.
  2. Server-side proxy — Your request is forwarded through a lightweight Next.js API route (/api/request). This eliminates CORS errors and prevents credentials from appearing in browser network logs.
  3. AI layer — An optional local AI model analyses the response structure and provides assertion suggestions, diagnostics, and debugging help. The model runs on your machine when available, or calls a privacy-respecting cloud endpoint as a fallback.
Note:TestForge never stores your API payloads, tokens, or responses on any server. The proxy is stateless and processes each request independently.

Where to Start

New to TestForge? Follow this path:

1Read the Quick Start guide to fire your first request in under a minute.
2Take the Interface Tour to understand all three panels.
3Visit API Inspection → Making Requests for detailed configuration options.
4Explore Assertions and Debug Insights to validate responses and diagnose failures.