> ## Documentation Index
> Fetch the complete documentation index at: https://celerity-wiki.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Celerity Search: Navigate URLs, Shortcuts, and the Web

> Use the Celerity search bar to navigate to URLs, trigger site-specific searches, and fall back to Google when nothing else matches.

The search bar is the heart of Celerity. Open any new tab, start typing, and Celerity instantly resolves your input — navigating to a URL, launching a shortcut, searching within a site, or falling back to Google — all without touching the mouse.

## Opening and closing the search bar

Any character keypress on a new tab page opens the search bar and places the character you typed directly into the input field. Celerity will not intercept keystrokes while a modal (settings, help, feedback, or confirmation) is open, or while the cursor is already inside a text input or editable element.

Press <kbd>Escape</kbd> at any time to close the search bar and return to the shortcut grid.

> [!NOTE]
>
> The settings, help, and feedback buttons in the top-right corner are hidden while the search bar is open. They reappear when you close it.

## How Celerity resolves your input

When you press Enter, Celerity evaluates your input in a fixed priority order:

**1. Direct URL**

If your input looks like a URL (e.g. `github.com` or `https://example.com`), Celerity navigates there immediately. A missing `https://` prefix is added automatically — you never need to type the protocol.

**2. Exact shortcut key**

If your input exactly matches a shortcut key (e.g. `g`), Celerity opens that shortcut's site.

**3. Shortcut key + space + query**

If your input is a shortcut key followed by a space and a query (e.g. `y lofi music`), Celerity performs a site-specific search by substituting your query into that shortcut's `searchTemplate`. The delimiter between the key and the query is always a single space.

**4. Google fallback**

If none of the above match, Celerity sends your input to Google Search: `https://www.google.com/search?q={}`.

## Live autocomplete suggestions

As you type, Celerity fetches up to **4** autocomplete suggestions and displays them below the input field. When you are typing a site-specific search (e.g. `y lo`), each suggestion is automatically prefixed with the shortcut key so selecting it triggers a site search rather than a web search.

### Navigating suggestions

The available navigation keys depend on whether focus is on the text input or on a suggestion item.

**From the text input:**

| Action | Keys |
| - | - |
| Move to next suggestion | <kbd>↓</kbd> <kbd>Tab</kbd> <kbd>Ctrl</kbd>+<kbd>N</kbd> |
| Move to previous suggestion | <kbd>↑</kbd> <kbd>Shift</kbd>+<kbd>Tab</kbd> <kbd>Ctrl</kbd>+<kbd>P</kbd> |

**From a focused suggestion:**

| Action | Keys |
| - | - |
| Next suggestion | <kbd>↓</kbd> <kbd>→</kbd> <kbd>Tab</kbd> <kbd>Ctrl</kbd>+<kbd>N</kbd> |
| Previous suggestion | <kbd>↑</kbd> <kbd>←</kbd> <kbd>Shift</kbd>+<kbd>Tab</kbd> <kbd>Ctrl</kbd>+<kbd>P</kbd> |
| Select focused suggestion | <kbd>Enter</kbd> or click |
| Return focus to input | Navigate past the first or last suggestion |

> [!TIP]
>
> <kbd>←</kbd> and <kbd>→</kbd> are only available for suggestion navigation once a suggestion item is already focused. From the text input, use <kbd>↓</kbd> / <kbd>↑</kbd>, <kbd>Tab</kbd> / <kbd>Shift</kbd>+<kbd>Tab</kbd>, or <kbd>Ctrl</kbd>+<kbd>N</kbd> / <kbd>Ctrl</kbd>+<kbd>P</kbd> to move into the suggestions list.

## Example inputs

The table below shows common inputs and what Celerity does with each one.

| Input | Result |
| - | - |
| `g` | Opens Gmail inbox |
| `y javascript tutorial` | Searches YouTube for "javascript tutorial" |
| `gh react` | Searches GitHub for "react" |
| `s lofi hip hop` | Searches Spotify for "lofi hip hop" |
| `github.com` | Navigates to `https://github.com` |
| `what is rust lang` | Google search for "what is rust lang" |

## URL navigation

Type any bare domain or full URL and press Enter — Celerity recognises the pattern and navigates directly without treating it as a search. The URL regex matches hostnames with optional ports and paths:

```
github.com            → https://github.com
docs.example.com/api  → https://docs.example.com/api
https://localhost:3000 → https://localhost:3000
```

`https://` is prepended automatically unless a protocol is already present. Any scheme is accepted (including `ftp://` and `chrome://`), so custom browser URLs pass through unchanged.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.