diff --git a/README.md b/README.md
index 3af8f1c..22a64e7 100644
--- a/README.md
+++ b/README.md
@@ -93,8 +93,46 @@ The service URL is built using this priority:
+
+
+
```
+## Keyboard Shortcuts
+
+- **`/`** - Focus the search bar (press from anywhere)
+- **Arrow Keys** - Navigate between service cards (Up/Down/Left/Right)
+- **Enter** - Open the selected service in a new tab
+- **Esc** - Clear the current selection
+
+## Info Button
+
+When a service has both a hostname and port configured, a small info button (ⓘ) appears in the bottom-right corner of the card. Click it to view connection details including:
+- Service name
+- Hostname
+- Port number
+- Protocol
+
+## Status Indicators
+
+Add optional status indicators to services by including a `status` attribute:
+
+```xml
+
+
+
+
+
+
+
+
+```
+
+Status colors:
+- **Green** (online) - Service is running normally, pulsing animation
+- **Red** (offline) - Service is not available
+- **Orange** (maintenance) - Service is under maintenance
+
## Icon Management
### Using Included Icons