# smocker-dev/smocker

Smocker is a simple and efficient HTTP mock server and proxy

Repository: https://github.com/smocker-dev/smocker
Canonical: https://ross.abutalabs.com/products/smocker
Homepage: https://smocker.dev
Language: TypeScript
License: MIT
License Family: permissive
Topics: mock-server, go, integration-testing, test, mock, api, react, typescript, functional-testing, proxy, wiremock
Last push: 2026-08-22T07:44:42+00:00

## Health v2 (maintenance only)
Score: 67/100 (v2, computed 2026-09-03T02:20:16.233290+00:00)
- activity 99, release rhythm 8, longevity 100
- inputs: {"age_days": 2561, "days_push": 11, "days_rel": 529, "gap_med": null, "n_releases_24m": 1}
- flags: none
- formula: round(0.45*activity + 0.35*rhythm + 0.20*longevity); archived -> min(score, 10)

## Adoption (not part of the score)
Stars 1284, forks 72 (observed 2026-08-28T04:04:14.615159+00:00)

## What it is
Smocker is a simple and efficient HTTP mock server and proxy designed to help mock the HTTP dependencies of an application, especially for integration test automation in microservice environments. It supports static, dynamic (Go templates/Lua), and proxying mock behaviors, configured via YAML/JSON or a web UI, and ships as a single static binary or Docker image.

## Use cases
- mock external http apis for integration tests
- replace an api gateway in a test environment
- run a mock server in docker for automated testing
- proxy http requests through a test double using http_proxy
- define mocks declaratively in yaml files
- inspect request history while writing tests iteratively

## When to choose
- you need to mock HTTP dependencies of a service during integration or functional testing
- you run microservices behind an API gateway and want a test-environment stand-in
- you want a dependency-free mock server deployable as a single binary or Docker container
- you prefer declarative YAML mock definitions with editor validation via JSON Schema

## When to avoid
- you need to mock non-HTTP protocols like gRPC or message queues
- you want a lightweight in-process mocking library embedded in your test code rather than a standalone server
- you need a full service virtualization platform with recording and replay of production traffic

## Facets
- artifact type: service
- maturity: active
- function: mock-api, http-server, proxy, testing, e2e-testing
- domain: testing, developer-tools, apis, microservices
- platform: self-hosted
- tags: mock-server, http-mocking, integration-testing, wiremock-alternative, yaml-configuration, go-templates, lua-scripting, docker, linux, web-server

## Member repositories
- smocker-dev/smocker (main) score 67

## Provenance
- Observed fields: from GitHub, fetched 2026-08-28T04:04:14.615159+00:00.
- Health v2: computed from the inputs above; adoption is never an input.
- Inferred fields (summary, facets, guidance): AI-extracted, prompt v1, taxonomy v1, on 2026-08-30T04:56:46.292078+00:00, confidence not recorded.
  - readme: https://github.com/smocker-dev/smocker (fetched 2026-08-28T04:04:14.615159+00:00, sha 87be3ff0d4bc)
  - homepage: https://smocker.dev (fetched 2026-08-29T12:12:51.499144+00:00, sha d5996f0d6e42)
  - site_page: https://smocker.dev/docs/guide/intro (fetched 2026-08-29T12:12:51.501453+00:00, sha ba2db02dbc50)
  - site_page: https://smocker.dev/docs/category/guide (fetched 2026-08-29T12:12:51.503161+00:00, sha 80bb769e70fb)
- Data as of 2026-08-30T08:39:29.467469+00:00.