Files
cinny/docs/handoff/features/global-search/HANDOFF.md
T
litruv a6ad8651b3
Checks / checks (push) Successful in 2m11s
Trigger cinny-mobile / dispatch (push) Successful in 1s
Apply the auto-fixable lint rules and the formatter, and drop the Vite build artifacts.
2026-11-01 04:23:53 +11:00

76 lines
1.9 KiB
Markdown

# Global search — handoff
## Summary
Quick global search modal for jumping to rooms, users, and recent conversations. Distinct from full message search — optimized for navigation, not event content search.
## User-facing behavior
- Keyboard shortcut / sidebar tab opens search modal
- Type to filter rooms and users
- Select result to navigate
## Architecture
```
SearchModalRenderer (in Router.tsx)
→ features/search/Search.tsx
→ searchModal.ts atom for open state
useAsyncSearch or similar for filtering
```
## Key files
| Path | Role |
| -------------------------------------------------- | ---------------- |
| `cinny/src/app/features/search/Search.tsx` | Modal UI |
| `cinny/src/app/state/searchModal.ts` | Open/close state |
| `cinny/src/app/pages/client/sidebar/SearchTab.tsx` | Sidebar entry |
## Data model
| Key | Storage |
| ------------------ | ------- |
| `searchModal` atom | memory |
## Dependencies
- Local room list + user index from sync
## Integration points
- **routing-and-navigation**: `SearchModalRenderer` in router
- **home-and-sidebar**: SearchTab
- **message-search**: different feature — don't merge UIs
## Testing
### Manual
1. Open search modal from sidebar.
2. Filter rooms by name.
3. Select room; navigates and modal closes.
### Automated
- None
## Known issues & gotchas
- Two "search" features confuse users — message search vs global nav search
- Modal focus trap via folds Overlay patterns
## Future work
- Unify search entry points with tabs (rooms / messages / users)
- Recent searches persistence
## Related docs
- [message-search HANDOFF](../message-search/HANDOFF.md)
- [routing-and-navigation HANDOFF](../routing-and-navigation/HANDOFF.md)
## Add your extra things here
- `SearchModalRenderer` mounted at client root level in Router.tsx