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
    No fields configured for issues without a type.

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions