Wiremock Standalone Docker

Sets up WireMock as a standalone Docker container so you can mock external APIs during integration testing. You get a complete docker-compose config with WireMock 3.5.2, directory structure for mappings and response files, and JSON stubs for the scenarios that actually matter: success responses, 404s, 500s, timeouts, and rate limits. The skill walks you through pointing your app at localhost:8080 instead of real endpoints, then testing all the edge cases your HTTP client needs to handle. It's straightforward if you're tired of flaky tests that depend on external services or need to simulate API failures without breaking production systems.

skills.sh installs: 3.5K
GitHub stars: 369
last updated: Aug 21, 2026

View on GitHub

Install

$ npx -y skills add giuseppe-trisciuoglio/developer-kit --skill wiremock-standalone-docker --agent claude-code

Installs into .claude/skills of the current project.

Files

WireMock Standalone Docker Skill

Overview

Provides patterns for running WireMock as a standalone Docker container to mock external APIs during integration and end-to-end testing. Runs WireMock as a separate service that simulates real API behavior for testing HTTP clients, retry logic, and error handling.

When to Use

Use when you need to:

Mock external APIs during integration or end-to-end testing
Simulate error conditions (timeouts, 5xx, rate limiting) without real services
Test HTTP client configurations, retry logic, and error handling
Create portable, reproducible test environments
Validate API contracts before implementing the real service

Instructions

Step 1: Set Up Docker Compose

Create a docker-compose.yml with WireMock 3.5.2, port mapping, and volume mounts for mappings and files:

version: "3.8"
services:
  wiremock:
    image: wiremock/wiremock:3.5.2
    ports:
      - "8080:8080"
    volumes:
      - ./wiremock:/home/wiremock
    command: ["--global-response-templating"]