Skip to content

docs: Add local development & mock mode guide for TypeScript SDK #728

@hfurkanbozkurt

Description

@hfurkanbozkurt

Problem

There is no documentation explaining how to develop and test a Strands TS SDK app locally without real API credentials (Bedrock, OpenAI, Anthropic). The MockMessageModel exists in test fixtures but is undocumented for end-users.

Proposed Content

A new guide covering:

  1. How to implement a MockModel using the Custom Model Provider interface
  2. Drop-in env-var swap pattern (MOCK_MODE=true) for zero-code-change local dev
  3. How to simulate: text streaming, tool calls, structured output, errors, multi-turn
  4. How to use Ollama/llama.cpp as a local LLM backend

Location

Suggested: docs/user-guide/concepts/local-development.md or similar

Metadata

Metadata

Assignees

No one assigned

    Labels

    No labels
    No labels

    Type

    No type

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions