Developer tools by FransHub

Developer tools that do one job well.

FransHub builds self-hosted tools for test and platform teams: fast, secure by default and at home on Kubernetes. The first one is FastMock, an API mock server for every protocol your tests touch.

  • Apache-2.0
  • Self-hosted
  • linux/amd64 and arm64
# add a stub through the admin API
$ curl -X POST localhost:9090/__admin/stubs \
    -H "Authorization: Bearer $FASTMOCK_TOKEN" \
    -H "content-type: application/json" -d '{
  "request":  {"method": "GET",
               "urlPathTemplate": "/hello/{name}"},
  "response": {"status": 200, "jsonBody":
               {"hello": "{{request.pathParams.name}}"}}
}'

# call it on the data plane
$ curl localhost:8080/hello/world
{"hello":"world"}
Products

One hub, focused tools

Each FransHub tool stands on its own: its own releases, documentation and images. They share the same principles and the same quality bar.

Preview · 0.1.0-dev10

FastMock

An API mock server for test environments. One Rust binary that mocks HTTP, gRPC, GraphQL, SOAP, WebSocket and Server-Sent Events, publishes Kafka messages and sends durable, signed callbacks. Replicas share state through PostgreSQL and Valkey; a web UI, a Helm chart and a Kubernetes operator come with it.

  • HTTP/1.1 & HTTP/2
  • gRPC
  • GraphQL
  • SOAP
  • WebSocket
  • SSE
  • Kafka
  • AsyncAPI

More tools on the way

New products appear here once they reach a first public release.

FastMock

Built for real test environments

Mocks that behave like services: shared by every replica, safe to expose inside a cluster and easy to move to from the tools you use today.

Durable callbacks

Webhooks go to an outbox first, then any replica delivers them with retries, backoff and an HMAC signature.

Shared state, any number of replicas

Stubs, journal and callbacks in PostgreSQL; scenarios and counters in Valkey. Call one replica, verify on another.

Secure by default

A separate control plane, mandatory tokens with roles, origin checks, no code in templates and one egress policy.

Bring your existing mocks

Imports WireMock, MockServer and Microcks, plus OpenAPI, AsyncAPI, Postman, HAR, WSDL and GraphQL schemas.

Kubernetes native

A Helm chart with NetworkPolicy, PDB, HPA and Gateway API, and an operator with FastMock and MockApi resources.

Observability built in

Prometheus metrics, OpenTelemetry traces that follow callbacks, JSON logs and a ready Grafana dashboard.

Read the FastMock documentation →

Quick start

FastMock running in a minute

All you need is Docker. Memory mode keeps everything in the process, which suits a laptop or a CI job.

  1. Pull the image

    Multi-arch, distroless, runs as a non-root user.

    $ docker pull franshub/fastmock:0.1.0-dev10
  2. Create an admin token

    FastMock keeps only the SHA-256 of each token. Export both values the command prints.

    $ docker run --rm franshub/fastmock:0.1.0-dev10 hash-token --generate
    $ export FASTMOCK_TOKEN=fm_...
    $ export FASTMOCK_TOKEN_HASH=...
  3. Start the server

    Port 8080 serves the mocks, port 9090 the admin API and the web UI at /ui/.

    $ docker run --rm -p 127.0.0.1:8080:8080 -p 127.0.0.1:9090:9090 \
        -e FASTMOCK_STORAGE=memory \
        -e FASTMOCK_ADMIN_TOKENS="me:admin:$FASTMOCK_TOKEN_HASH" \
        franshub/fastmock:0.1.0-dev10

Continue with the getting started guide →

About

About FransHub

FransHub is an independent home for developer and platform tooling. Each product starts from a problem teams hit in real environments, and aims to solve it with one well-made, self-hosted tool rather than another service to depend on.

FastMock is the first product. It grew out of running several mock servers side by side and wanting one that is fast, safe inside a shared cluster and simple to operate. More tools will follow, built on the same principles.

  • Self-hosted first

    Runs in your infrastructure, keeps your data there and needs no external service.

  • Secure by default

    Safe settings out of the box, least privilege and minimal distroless images.

  • Made for Kubernetes

    Helm charts, operators, Gateway API and network policies, tested on real clusters.

  • Openly licensed

    Apache-2.0, with documentation that covers operations as well as features.