Mini Map

Endpoints

Add the operations your service exposes. Method, path, and status codes make your API much easier to review.

Start with a template

Applies to all endpoints

Policies that aren't specific to a single endpoint — auth, rate limits, versioning, and other notes.

Authentication

Rate limiting

Versioning

Notes (idempotency, redirect choice, error shape, anything else)

Diagram

Draw the components and how traffic flows between them. Notes below the canvas are optional — the Walkthrough panel is the primary place to narrate flows.

Draw the architecture so the components and connections tell the core story; flow narration in Notes is optional but recommended.

Components

Click palette â†’ add

Drag edge dot â†’ connect

Double-click node/edge â†’ rename

Shift+drag or box-select â†’ multi

Click any component on the left to add it here.

Drag the edge of a node to connect it to another.

Double-click any arrow to label it.

Notes (optional) — flow narration, trade-offs, chosen alternatives0 elements on canvas

Request walkthrough

Trace each core requirement as an ordered sequence of hops through your diagram. Use component names from your canvas for the From / To columns.

1

Given a prefix string, return top 5-10 ranked suggestions.

FromToAction / payload

1.

2.

2

Suggestions ranked by a combination of query popularity and recency.

FromToAction / payload

1.

2.

3

Suggestions update as new popular queries emerge (within minutes, not real-time).

FromToAction / payload

1.

2.

Storage schema

For each entity, declare how it's stored. Sharding key is the interesting one — pick the access pattern it optimises for.

Query

A search string with associated popularity score and metadata.

In-memory / derived

Storage type

Primary key

Sharding / partition key

Critical fields

Notes (indexes, TTL, access pattern)

Prefix

A character sequence typed so far. Maps to a set of candidate queries.

In-memory / derived

Storage type

Primary key

Sharding / partition key

Critical fields

Notes (indexes, TTL, access pattern)

Suggestion

A ranked query returned to the user, with score and display metadata.

In-memory / derived

Storage type

Primary key

Sharding / partition key

Critical fields

Notes (indexes, TTL, access pattern)

Component choices

Pick one per row and give a one-line reason. These are the concrete technology decisions your diagram implies.

Load Balancer

How traffic is distributed to your app servers.

Cache

Where hot reads are served from.

Database

Primary durable store for entities.

Your diagram

No components drawn yet — edit the diagram before answering.

Iterate on your design — don't start over.

Each scenario below probes a specific weakness in a typical HLD. Reference components from your diagram by name, describe what breaks and at what load, then name the minimum change that fixes it. Strong answers identify the precise failure mode — not just "scale it up".

1

A celebrity dies and millions search their name within minutes. Your trie was rebuilt 10 minutes ago. What do users see?

Probes: high level architecture

Your answer

Design Search Autocomplete (Typeahead)

API & core entities

Endpoints

Applies to all endpoints

High-level design

Deep dives