Every analytics tool wants a subscription. And your data. I built Twiligent instead. YouTube stats. Instagram stats. One dashboard. Runs locally on your machine.
import { useEffect, useId, useRef, useState } from 'react';
import { useNavigate } from 'react-router';
import MiniSearch from 'minisearch';
import { cn } from '@/lib/cn';
import { AltArrowRight, Hashtag, Magnifer } from '@/components/icons';
import { SEARCH_OPTIONS, resultCountText } from './searchShared';
import type { SearchDocument } from './searchShared';
type Result = Pick<SearchDocument, 'href' | 'title' | 'page'> & { id: string };
let index: MiniSearch<SearchDocument> | null = null;
// the index is built at build time and loaded the first time someone searches
async function loadIndex(): Promise<MiniSearch<SearchDocument>> {
if (!index) {
const { default: json } = await import('virtual:docs-search');
index = MiniSearch.loadJSON<SearchDocument>(json, SEARCH_OPTIONS);
}
return index;
}
const IS_MAC = typeof navigator !== 'undefined' && /Mac|iPhone|iPad/.test(navigator.platform);
export interface SearchProps {
className?: string;
}
// the search box in the docs top bar; Ctrl K or Cmd K opens it, and results drop down beneath it as on the Activepieces docs
export function Search({ className }: SearchProps) {
const navigate = useNavigate();
const input = useRef<HTMLInputElement>(null);
// the header and the phone drawer each hold a search box, so every id is unique to its box
const listId = useId();
const optionId = (i: number) => `${listId}-option-${i}`;
const [open, setOpen] = useState(false);
const [query, setQuery] = useState('');
const [results, setResults] = useState<Result[]>([]);
const [searched, setSearched] = useState('');
const [selected, setSelected] = useState(0);
useEffect(() => {
const onKey = (event: KeyboardEvent) => {
if ((event.ctrlKey || event.metaKey) && event.key.toLowerCase() === 'k') {
// only the visible box answers, so the hidden one in the closed drawer does not take focus
if (!input.current || input.current.offsetParent === null) return;
event.preventDefault();
setOpen(true);
input.current.focus();
}
};
document.addEventListener('keydown', onKey);
return () => document.removeEventListener('keydown', onKey);
}, []);
useEffect(() => {
if (!query.trim()) return;
let current = true;
loadIndex().then(search => {
if (!current) return;
setResults(
search
.search(query)
.slice(0, 8)
.map(r => ({ id: String(r.id), href: r.href as string, title: r.title as string, page: r.page as string })),
);
setSearched(query);
setSelected(0);
});
return () => {
current = false;
};
}, [query]);
function go(result: Result | undefined) {
if (!result) return;
setOpen(false);
setQuery('');
input.current?.blur();
navigate(result.href);
}
function onKeyDown(event: React.KeyboardEvent<HTMLInputElement>) {
if (event.key === 'ArrowDown') {
event.preventDefault();
setOpen(true);
setSelected(s => Math.min(s + 1, visible.length - 1));
} else if (event.key === 'ArrowUp') {
event.preventDefault();
setSelected(s => Math.max(s - 1, 0));
} else if (event.key === 'Enter') {
go(visible[selected]);
} else if (event.key === 'Escape') {
// the first Escape closes the results and keeps the place in the box; the second clears the query
event.preventDefault();
if (showResults) setOpen(false);
else setQuery('');
}
}
// an empty box shows nothing, whatever the last search found
const showResults = open && query.trim().length > 0;
const ready = showResults && searched === query;
const visible = ready ? results : [];
const status = ready ? resultCountText(visible.length) : '';
return (
<div
className={cn('relative', className)}
onBlur={event => !event.currentTarget.contains(event.relatedTarget) && setOpen(false)}
>
<label className="flex h-9 items-center gap-2 rounded-md border border-line bg-surface-raised px-3 text-sm text-ink-muted transition-colors focus-within:border-line-strong has-[input:focus-visible]:outline-2 has-[input:focus-visible]:outline-offset-2 has-[input:focus-visible]:outline-(--focus-ring)">
<Magnifer className="size-4 shrink-0" />
<span className="sr-only">Search the docs</span>
<input
ref={input}
type="search"
role="combobox"
aria-expanded={visible.length > 0}
aria-controls={listId}
aria-autocomplete="list"
aria-activedescendant={visible[selected] ? optionId(selected) : undefined}
value={query}
onChange={event => {
setQuery(event.target.value);
setOpen(true);
}}
onFocus={() => setOpen(true)}
onKeyDown={onKeyDown}
placeholder="Search..."
className="min-w-0 flex-1 bg-transparent text-ink outline-none placeholder:text-ink-muted [&::-webkit-search-cancel-button]:hidden"
/>
<kbd className="hidden shrink-0 font-sans text-xs font-semibold text-ink-muted sm:inline">
{IS_MAC ? 'Cmd K' : 'Ctrl K'}
</kbd>
</label>
<p role="status" aria-live="polite" className="sr-only">
{status}
</p>
<div
className={cn(
'absolute inset-x-0 top-11 z-50 overflow-hidden rounded-lg border border-line bg-surface-raised shadow-lg',
!showResults && 'hidden',
)}
>
{/* the list stays in the page while the box is in use, so aria-controls always points at it */}
<ul id={listId} role="listbox" aria-label="Matching pages" className="max-h-[60vh] overflow-y-auto p-1.5 empty:hidden">
{visible.map((result, i) => (
<li
key={result.id}
id={optionId(i)}
role="option"
aria-selected={i === selected}
// the input keeps focus while a result is clicked, so the list does not close before the click lands
onMouseDown={event => event.preventDefault()}
onMouseEnter={() => setSelected(i)}
onClick={() => go(result)}
className={cn(
'flex w-full cursor-pointer items-start gap-3 rounded-md px-3 py-2.5 text-left',
i === selected && 'bg-surface-sunken',
)}
>
<Hashtag className="mt-0.5 size-4 shrink-0 text-ink-muted" />
<span className="flex min-w-0 flex-col">
<span className="truncate text-sm font-semibold text-ink">{result.title}</span>
{result.title !== result.page && (
<span className="flex items-center gap-1 truncate text-xs text-ink-muted">
{result.page}
<AltArrowRight className="size-3" />
{result.title}
</span>
)}
</span>
</li>
))}
</ul>
{ready && visible.length === 0 && (
<p className="px-4 py-6 text-center text-sm text-ink-muted">No pages match "{query}". Try a shorter word.</p>
)}
<p className="flex items-center gap-4 border-t border-line px-4 py-2 text-xs text-ink-muted">
<span>Up and down to select</span>
<span>Enter to open</span>
<span className="ml-auto">Esc to close</span>
</p>
</div>
</div>
);
}