Universal Search

Find anything in your SureStage workspace instantly with universal search. Search across simulations, blueprints, environments, routes, responses, and more without leaving your current page.

Opening Universal Search

Press the keyboard shortcut to open search from anywhere:

• macOS - Cmd + K
• Windows/Linux - Ctrl + K

Alternatively, click the search icon in the top navigation bar.

Search Interface

The search modal overlays your current page and displays:

• Search input - Type your query here
• Results dropdown - Real-time results as you type
• Entity type filters - Narrow results to specific types
• Keyboard shortcuts - Navigate results without a mouse

Press Esc to close the search modal at any time.

What You Can Search

Universal search indexes all entities in your workspace:

Simulations

Search by:

• Simulation name
• Description
• Tags
• Base URL or simulation ID
• Creator name

Result shows: Simulation name, status indicator, route count, last activity

Blueprints

Search by:

• Blueprint name
• Description
• Version number
• Tags
• Author name

Result shows: Blueprint name, version, deployment count, visibility

Environments

Search by:

• Environment name
• Description
• Associated simulation names
• Tags

Result shows: Environment name, simulation count, last updated

Routes

Search by:

• HTTP method and path (e.g., GET /users)
• Route description
• Simulation name containing the route
• Tags

Result shows: Method and path, simulation name, response count

Responses

Search by:

• Response body content (full-text search)
• Status code
• Response name or description
• Associated route path

Result shows: Status code, route, body preview, simulation name

Team Members

Search by:

• Name
• Email address
• Role

Result shows: Name, email, role, status

Search Syntax

Basic Search

Type any text to search across all fields:

payment

Finds simulations, routes, or responses containing "payment".

Entity Type Filters

Prefix your query to filter by type:

• sim: - Simulations only
• blueprint: - Blueprints only
• env: - Environments only
• route: - Routes only
• user: - Team members only

Examples:

sim:demo
blueprint:auth
route:/users

HTTP Method Filter

Search routes by method:

GET /users
POST /orders
DELETE /accounts

Status Code Filter

Find responses by status code:

status:404
status:5xx

Keyboard Navigation

Navigate search results without touching the mouse.

Key	Action
↓ or Tab	Move to next result
↑ or Shift + Tab	Move to previous result
Enter	Open selected result
Esc	Close search modal
Cmd/Ctrl + K	Clear search input

Quick Actions

Press Enter on a result to navigate directly to it. Each entity type opens in the appropriate view:

• Simulations - Opens simulation detail page
• Blueprints - Opens blueprint editor
• Environments - Opens environment page
• Routes - Opens simulation and highlights the route
• Responses - Opens simulation and expands the route's response list

Recently Viewed

When the search input is empty, you see recently viewed items.

The list shows:

• Last 10 items you viewed
• Entity type icon
• Item name
• Timestamp of last view

Click any item to return to it instantly.

Search Results

Results appear in real-time as you type. No need to press Enter.

Result Grouping

Results are grouped by entity type:

• Simulations
• Blueprints
• Environments
• Routes
• Responses

Each group shows up to 5 results. Click View all X results to see more.

Result Highlighting

Your search terms are highlighted in:

• Entity names
• Descriptions
• Route paths
• Response body previews

Empty State

If no results match your query, you see:

• A "No results found" message
• Suggestions for refining your search
• Link to create a new simulation or blueprint

Performance

Universal search is optimized for speed:

• Real-time indexing - Changes appear in search within seconds
• Debounced input - Searches trigger 150ms after you stop typing
• Cached results - Frequent queries return instantly

Search Tips

Use specific terms - "auth token" is better than "token".

Include context - "demo payment API" narrows results more than "payment".

Try different phrases - If you don't find something, try synonyms or shorter queries.

Use filters - Prefix searches with sim:, route:, etc. when you know the entity type.

Remember shortcuts - Cmd/Ctrl + K becomes muscle memory. Use it constantly.

Privacy

Universal search respects access controls:

• You only see simulations and blueprints you have access to
• Shared simulations appear in your results if you're a collaborator
• Organization-wide blueprints are visible to all members
• Private blueprints are only searchable by their owner

Common Issues

Search not returning expected results - Wait a few seconds for recent changes to index. Force a refresh by closing and reopening search.

Keyboard shortcut not working - Ensure you're not focused in a text input field. Press Esc first, then try the shortcut.

Results loading slowly - Large workspaces may take longer to search. Use entity type filters to speed up queries.

Next Steps

• Dashboard Overview - Navigate your workspace
• Simulations - Manage mock API simulations
• Blueprints - Reusable simulation templates