mirror of
https://github.com/snapotter-hq/SnapOtter.git
synced 2026-08-03 07:46:42 +02:00
Comprehensive telemetry quality improvements across Sentry and PostHog, grounded in an audit of the live data plus current best-practice research. Sentry: job_id/instance_id tags, operational fingerprinting, PII-safe settings context on bug events, web tag population + extension-noise filtering, an early-crash buffer, http status/method kept on breadcrumbs, and a gated-off-by-default performance-tracing re-enable (tracesSampler that zeroes db/redis/queue-poll root spans + drops the Redis integration) with worker job spans and canonical-host cron monitors. PostHog: history_change SPA pageviews, instance_id super property for fleet rollups, enriched tool_used (formats, byte sizes, is_batch, execution_hint, real error_kind taxonomy), the previously-dead result_saved/batch_processed/ai_bundle_prompted events fired, search click-through, editor + Automate authoring + auth instrumentation, a before_send PII boundary, and minimal opt-in landing-site pageviews.
609 lines
20 KiB
TypeScript
609 lines
20 KiB
TypeScript
import type { Tool } from "@snapotter/shared";
|
|
import { ANALYTICS_EVENTS, CATEGORIES, SECTIONS, TOOLS, toolSection } from "@snapotter/shared";
|
|
import { ChevronDown, Plus, Search, X } from "lucide-react";
|
|
import { useCallback, useEffect, useMemo, useRef, useState } from "react";
|
|
import { Link, useLocation, useNavigate } from "react-router-dom";
|
|
import { ToolCard } from "@/components/common/tool-card.js";
|
|
import { FeedbackDialog } from "@/components/feedback/feedback-dialog.js";
|
|
import { AppLayout } from "@/components/layout/app-layout.js";
|
|
import { useTranslation } from "@/contexts/i18n-context";
|
|
import { useFuseSearch } from "@/hooks/use-fuse-search.js";
|
|
import { usePageTitle } from "@/hooks/use-page-title.js";
|
|
import { useRecentTools } from "@/hooks/use-recent-tools.js";
|
|
import type { FeedbackPromptVariant } from "@/lib/feedback.js";
|
|
import { format } from "@/lib/format.js";
|
|
import { ICON_MAP } from "@/lib/icon-map.js";
|
|
import { getCategoryName, getToolName } from "@/lib/tool-i18n.js";
|
|
import { buildToolRequestDiscussionUrl } from "@/lib/tool-request.js";
|
|
import { cn } from "@/lib/utils.js";
|
|
import { useAnalyticsStore } from "@/stores/analytics-store";
|
|
import { usePinnedToolsStore } from "@/stores/pinned-tools-store";
|
|
import { useSettingsStore } from "@/stores/settings-store";
|
|
|
|
interface TabDef {
|
|
key: string;
|
|
label: string;
|
|
}
|
|
|
|
const COLLAPSE_STORAGE_KEY = "snapotter-collapsed-sections";
|
|
|
|
function getCollapsedSections(): Set<string> {
|
|
try {
|
|
const raw = localStorage.getItem(COLLAPSE_STORAGE_KEY);
|
|
return raw ? new Set(JSON.parse(raw)) : new Set();
|
|
} catch {
|
|
return new Set();
|
|
}
|
|
}
|
|
|
|
function saveCollapsedSections(collapsed: Set<string>) {
|
|
localStorage.setItem(COLLAPSE_STORAGE_KEY, JSON.stringify([...collapsed]));
|
|
}
|
|
|
|
const SECTION_TABS = new Set<string>(["all", ...SECTIONS.map((s) => s.id)]);
|
|
|
|
export function HomePage() {
|
|
const { t } = useTranslation();
|
|
const [activeTab, setActiveTab] = useState<string>("all");
|
|
const [search, setSearch] = useState("");
|
|
const { fetch: fetchSettings, disabledTools, experimentalEnabled, loaded } = useSettingsStore();
|
|
const recentToolIds = useRecentTools();
|
|
const pinnedIds = usePinnedToolsStore((s) => s.pinnedTools);
|
|
const fetchPins = usePinnedToolsStore((s) => s.fetch);
|
|
const analyticsConfig = useAnalyticsStore((s) => s.config);
|
|
const analyticsConfigLoaded = useAnalyticsStore((s) => s.configLoaded);
|
|
const analyticsOn = analyticsConfigLoaded && analyticsConfig?.enabled === true;
|
|
const [requestOpen, setRequestOpen] = useState(false);
|
|
const [requestVariant, setRequestVariant] = useState<FeedbackPromptVariant>("search-empty-v1");
|
|
|
|
const openRequest = useCallback((variant: FeedbackPromptVariant) => {
|
|
setRequestVariant(variant);
|
|
setRequestOpen(true);
|
|
}, []);
|
|
|
|
const location = useLocation();
|
|
const navigate = useNavigate();
|
|
|
|
usePageTitle();
|
|
|
|
useEffect(() => {
|
|
fetchSettings();
|
|
}, [fetchSettings]);
|
|
|
|
useEffect(() => {
|
|
fetchPins();
|
|
}, [fetchPins]);
|
|
|
|
// Open a specific section tab when arriving via a breadcrumb link
|
|
// (/?section=<sectionId>), then clean the URL so refresh/back doesn't re-pin it.
|
|
useEffect(() => {
|
|
const s = new URLSearchParams(location.search).get("section");
|
|
if (s && SECTION_TABS.has(s)) {
|
|
setActiveTab(s);
|
|
navigate("/", { replace: true });
|
|
}
|
|
}, [location.search, navigate]);
|
|
|
|
const tabs: TabDef[] = useMemo(
|
|
() => [
|
|
{ key: "all", label: t.homePage.all },
|
|
...SECTIONS.map((s) => ({
|
|
key: s.id,
|
|
label: s.id === "pdf" ? t.homePage.pdf : s.id === "files" ? t.homePage.files : s.name,
|
|
})),
|
|
],
|
|
[t],
|
|
);
|
|
|
|
const visibleTools = useMemo(() => {
|
|
if (!loaded) return [];
|
|
return TOOLS.filter((tool) => {
|
|
if (tool.disabled) return false;
|
|
if (disabledTools.includes(tool.id)) return false;
|
|
if (tool.experimental && !experimentalEnabled) return false;
|
|
return true;
|
|
});
|
|
}, [disabledTools, experimentalEnabled, loaded]);
|
|
|
|
const searchResults = useFuseSearch(visibleTools, search);
|
|
|
|
useEffect(() => {
|
|
if (!search || search.length < 2) return;
|
|
const timer = setTimeout(() => {
|
|
import("@/lib/analytics").then(({ track }) => {
|
|
track(ANALYTICS_EVENTS.SEARCH, { results_count: searchResults.length });
|
|
});
|
|
}, 1000);
|
|
return () => clearTimeout(timer);
|
|
}, [search, searchResults.length]);
|
|
|
|
const tabTools = useMemo(() => {
|
|
if (activeTab === "all") return visibleTools;
|
|
return visibleTools.filter((tool) => toolSection(tool) === activeTab);
|
|
}, [visibleTools, activeTab]);
|
|
|
|
const groupedTools = useMemo(() => {
|
|
const map = new Map<string, Tool[]>();
|
|
for (const tool of tabTools) {
|
|
const existing = map.get(tool.category);
|
|
if (existing) {
|
|
existing.push(tool);
|
|
} else {
|
|
map.set(tool.category, [tool]);
|
|
}
|
|
}
|
|
return map;
|
|
}, [tabTools]);
|
|
|
|
const tabCounts = useMemo(() => {
|
|
const counts: Record<string, number> = { all: visibleTools.length };
|
|
for (const tool of visibleTools) {
|
|
const sec = toolSection(tool);
|
|
counts[sec] = (counts[sec] ?? 0) + 1;
|
|
}
|
|
return counts;
|
|
}, [visibleTools]);
|
|
|
|
const pinnedTools = useMemo(() => {
|
|
const byId = new Map(visibleTools.map((tool) => [tool.id, tool]));
|
|
return pinnedIds.map((id) => byId.get(id)).filter((tool): tool is Tool => tool != null);
|
|
}, [pinnedIds, visibleTools]);
|
|
|
|
const recentTools = useMemo(() => {
|
|
const pinnedSet = new Set(pinnedIds);
|
|
return recentToolIds
|
|
.filter((id) => !pinnedSet.has(id))
|
|
.map((id) => visibleTools.find((tool) => tool.id === id))
|
|
.filter((tool): tool is Tool => tool != null);
|
|
}, [recentToolIds, visibleTools, pinnedIds]);
|
|
|
|
return (
|
|
<AppLayout>
|
|
<div>
|
|
<h1 className="sr-only">{t.homePage.heading}</h1>
|
|
<div className="mx-auto max-w-6xl px-4 py-8 sm:px-6 lg:px-8">
|
|
<HomeSearchBar
|
|
value={search}
|
|
onChange={setSearch}
|
|
placeholder={format(t.homePage.searchPlaceholder, {
|
|
count: visibleTools.length,
|
|
})}
|
|
/>
|
|
|
|
<ModalityTabs
|
|
tabs={tabs}
|
|
activeTab={activeTab}
|
|
onTabChange={setActiveTab}
|
|
counts={tabCounts}
|
|
/>
|
|
|
|
{search ? (
|
|
<SearchResults
|
|
results={searchResults}
|
|
query={search}
|
|
onClear={() => setSearch("")}
|
|
analyticsOn={analyticsOn}
|
|
onRequest={openRequest}
|
|
/>
|
|
) : activeTab === "all" ? (
|
|
<AllTabContent
|
|
pinnedTools={pinnedTools}
|
|
recentTools={recentTools}
|
|
visibleTools={visibleTools}
|
|
/>
|
|
) : (
|
|
<CategoryGrid groupedTools={groupedTools} />
|
|
)}
|
|
|
|
<FeedbackDialog
|
|
open={requestOpen}
|
|
source="search_miss"
|
|
searchQuery={search}
|
|
promptVariant={requestVariant}
|
|
onClose={() => setRequestOpen(false)}
|
|
/>
|
|
</div>
|
|
</div>
|
|
</AppLayout>
|
|
);
|
|
}
|
|
|
|
// ── Search Bar ───────────────────────────────────────────────────
|
|
|
|
function HomeSearchBar({
|
|
value,
|
|
onChange,
|
|
placeholder,
|
|
}: {
|
|
value: string;
|
|
onChange: (v: string) => void;
|
|
placeholder: string;
|
|
}) {
|
|
const inputRef = useRef<HTMLInputElement>(null);
|
|
const location = useLocation();
|
|
const navigate = useNavigate();
|
|
|
|
useEffect(() => {
|
|
const params = new URLSearchParams(location.search);
|
|
if (params.get("focus") === "search") {
|
|
inputRef.current?.focus();
|
|
navigate("/", { replace: true });
|
|
}
|
|
}, [location.search, navigate]);
|
|
|
|
return (
|
|
<div className="relative mb-8">
|
|
<Search className="absolute start-4 top-1/2 -translate-y-1/2 h-4 w-4 text-muted-foreground pointer-events-none" />
|
|
<input
|
|
ref={inputRef}
|
|
data-search-input
|
|
type="text"
|
|
value={value}
|
|
onChange={(e) => onChange(e.target.value)}
|
|
onKeyDown={(e) => {
|
|
// Escape steps out of the search field: clear a query if present,
|
|
// otherwise drop focus back to the page.
|
|
if (e.key === "Escape") {
|
|
if (value) onChange("");
|
|
e.currentTarget.blur();
|
|
}
|
|
}}
|
|
placeholder={placeholder}
|
|
aria-label={placeholder}
|
|
className="w-full ps-11 pe-20 py-2.5 rounded-lg border border-border bg-card text-sm text-foreground placeholder:text-muted-foreground/60 focus:outline-none focus:ring-2 focus:ring-primary/30 focus:border-primary/40 transition-shadow"
|
|
/>
|
|
{value ? (
|
|
<button
|
|
type="button"
|
|
onClick={() => {
|
|
onChange("");
|
|
inputRef.current?.focus();
|
|
}}
|
|
className="absolute end-3 top-1/2 -translate-y-1/2 p-1 rounded hover:bg-muted transition-colors"
|
|
aria-label="Clear search"
|
|
>
|
|
<X className="h-4 w-4 text-muted-foreground" />
|
|
</button>
|
|
) : (
|
|
<kbd className="absolute end-3 top-1/2 -translate-y-1/2 hidden sm:inline-flex items-center gap-0.5 px-2 py-0.5 rounded border border-border bg-muted/50 text-[11px] text-muted-foreground font-mono">
|
|
<span className="text-xs">⌘</span>K
|
|
</kbd>
|
|
)}
|
|
</div>
|
|
);
|
|
}
|
|
|
|
// ── Modality Tabs ────────────────────────────────────────────────
|
|
|
|
function ModalityTabs({
|
|
tabs,
|
|
activeTab,
|
|
onTabChange,
|
|
counts,
|
|
}: {
|
|
tabs: TabDef[];
|
|
activeTab: string;
|
|
onTabChange: (key: string) => void;
|
|
counts: Record<string, number>;
|
|
}) {
|
|
return (
|
|
<div className="mb-8 overflow-x-auto scrollbar-none -mx-4 px-4 sm:mx-0 sm:px-0">
|
|
<div className="flex gap-1.5 min-w-max">
|
|
{tabs.map((tab) => (
|
|
<button
|
|
key={tab.key}
|
|
type="button"
|
|
onClick={() => onTabChange(tab.key)}
|
|
className={cn(
|
|
"px-3.5 py-1.5 rounded-full text-sm font-medium transition-colors whitespace-nowrap",
|
|
activeTab === tab.key
|
|
? // Fixed dark text on the orange pill (the orange is the same
|
|
// in both themes). White on Otter Orange is only ~3:1, below
|
|
// WCAG AA for this 14px label; near-black reaches ~5.8:1.
|
|
"bg-primary text-[#1a1814] shadow-sm"
|
|
: "text-muted-foreground hover:bg-muted hover:text-foreground",
|
|
)}
|
|
>
|
|
{tab.label}
|
|
<span className={cn("ms-1", activeTab === tab.key ? "opacity-80" : "opacity-50")}>
|
|
{counts[tab.key] ?? 0}
|
|
</span>
|
|
</button>
|
|
))}
|
|
</div>
|
|
</div>
|
|
);
|
|
}
|
|
|
|
// ── Search Results ───────────────────────────────────────────────
|
|
|
|
function RequestToolAffordance({
|
|
query,
|
|
variant,
|
|
analyticsOn,
|
|
onRequest,
|
|
}: {
|
|
query: string;
|
|
variant: "empty" | "below";
|
|
analyticsOn: boolean;
|
|
onRequest: (promptVariant: FeedbackPromptVariant) => void;
|
|
}) {
|
|
const { t } = useTranslation();
|
|
const label =
|
|
variant === "empty"
|
|
? format(t.homePage.requestToolCta, { query })
|
|
: t.homePage.requestToolBelowResults;
|
|
const promptVariant: FeedbackPromptVariant =
|
|
variant === "empty" ? "search-empty-v1" : "search-results-v1";
|
|
const className = "inline-flex items-center gap-1.5 text-sm text-primary hover:underline";
|
|
|
|
if (analyticsOn) {
|
|
return (
|
|
<button
|
|
type="button"
|
|
data-testid="request-tool"
|
|
onClick={() => onRequest(promptVariant)}
|
|
className={className}
|
|
>
|
|
<Plus className="h-4 w-4" aria-hidden="true" />
|
|
{label}
|
|
</button>
|
|
);
|
|
}
|
|
|
|
return (
|
|
<a
|
|
href={buildToolRequestDiscussionUrl(query)}
|
|
target="_blank"
|
|
rel="noopener noreferrer"
|
|
data-testid="request-tool"
|
|
className={className}
|
|
>
|
|
<Plus className="h-4 w-4" aria-hidden="true" />
|
|
{label}
|
|
</a>
|
|
);
|
|
}
|
|
|
|
function SearchResults({
|
|
results,
|
|
query,
|
|
onClear,
|
|
analyticsOn,
|
|
onRequest,
|
|
}: {
|
|
results: Tool[];
|
|
query: string;
|
|
onClear: () => void;
|
|
analyticsOn: boolean;
|
|
onRequest: (promptVariant: FeedbackPromptVariant) => void;
|
|
}) {
|
|
const { t } = useTranslation();
|
|
|
|
if (results.length === 0) {
|
|
return (
|
|
<div className="text-center py-16">
|
|
<p className="text-muted-foreground">{format(t.homePage.noToolsMatch, { query })}</p>
|
|
<div className="mt-4 flex flex-col items-center gap-3">
|
|
<RequestToolAffordance
|
|
query={query}
|
|
variant="empty"
|
|
analyticsOn={analyticsOn}
|
|
onRequest={onRequest}
|
|
/>
|
|
<button type="button" onClick={onClear} className="text-sm text-primary hover:underline">
|
|
{t.homePage.clearSearch}
|
|
</button>
|
|
</div>
|
|
</div>
|
|
);
|
|
}
|
|
|
|
return (
|
|
<div className="space-y-4">
|
|
<div className="grid grid-cols-1 sm:grid-cols-2 lg:grid-cols-3 gap-2">
|
|
{results.map((tool) => (
|
|
<ToolCard
|
|
key={tool.id}
|
|
tool={tool}
|
|
variant="descriptive"
|
|
showModalityBadge
|
|
showPin
|
|
onNavigate={() => {
|
|
// search -> click attribution: which result the user opened.
|
|
import("@/lib/analytics").then(({ track }) =>
|
|
track(ANALYTICS_EVENTS.SEARCH, {
|
|
results_count: results.length,
|
|
clicked_tool_id: tool.id,
|
|
}),
|
|
);
|
|
}}
|
|
/>
|
|
))}
|
|
</div>
|
|
<div className="pt-1 text-center">
|
|
<RequestToolAffordance
|
|
query={query}
|
|
variant="below"
|
|
analyticsOn={analyticsOn}
|
|
onRequest={onRequest}
|
|
/>
|
|
</div>
|
|
</div>
|
|
);
|
|
}
|
|
|
|
// ── All Tab: Grouped by section, then by category ───────────────
|
|
|
|
function AllTabContent({
|
|
pinnedTools,
|
|
recentTools,
|
|
visibleTools,
|
|
}: {
|
|
pinnedTools: Tool[];
|
|
recentTools: Tool[];
|
|
visibleTools: Tool[];
|
|
}) {
|
|
const { t } = useTranslation();
|
|
const [collapsed, setCollapsed] = useState<Set<string>>(getCollapsedSections);
|
|
|
|
const toggleSection = useCallback((sectionId: string) => {
|
|
setCollapsed((prev) => {
|
|
const next = new Set(prev);
|
|
if (next.has(sectionId)) next.delete(sectionId);
|
|
else next.add(sectionId);
|
|
saveCollapsedSections(next);
|
|
return next;
|
|
});
|
|
}, []);
|
|
|
|
const toolsBySection = useMemo(() => {
|
|
const map = new Map<string, Map<string, Tool[]>>();
|
|
for (const tool of visibleTools) {
|
|
const sec = toolSection(tool);
|
|
let catMap = map.get(sec);
|
|
if (!catMap) {
|
|
catMap = new Map();
|
|
map.set(sec, catMap);
|
|
}
|
|
const existing = catMap.get(tool.category);
|
|
if (existing) existing.push(tool);
|
|
else catMap.set(tool.category, [tool]);
|
|
}
|
|
return map;
|
|
}, [visibleTools]);
|
|
|
|
return (
|
|
<div className="space-y-6">
|
|
{/* Pinned */}
|
|
{pinnedTools.length > 0 && (
|
|
<section>
|
|
<h2 className="text-[11px] font-semibold uppercase text-muted-foreground/70 tracking-widest mb-2">
|
|
{t.homePage.pinned}
|
|
</h2>
|
|
<div className="grid grid-cols-1 sm:grid-cols-2 lg:grid-cols-3 gap-2">
|
|
{pinnedTools.map((tool) => (
|
|
<ToolCard key={tool.id} tool={tool} variant="descriptive" showPin />
|
|
))}
|
|
</div>
|
|
</section>
|
|
)}
|
|
|
|
{/* Recent */}
|
|
{recentTools.length > 0 && (
|
|
<section>
|
|
<h2 className="text-[11px] font-semibold uppercase text-muted-foreground/70 tracking-widest mb-2">
|
|
{t.homePage.recent}
|
|
</h2>
|
|
<div className="flex flex-wrap gap-1.5">
|
|
{recentTools.map((tool) => (
|
|
<Link
|
|
key={tool.id}
|
|
to={tool.route}
|
|
className="inline-flex items-center gap-1.5 px-3 py-1 rounded-md text-sm text-muted-foreground border border-border/60 hover:border-border hover:text-foreground hover:bg-muted/50 transition-colors"
|
|
>
|
|
{getToolName(t, tool.id, tool.name)}
|
|
</Link>
|
|
))}
|
|
</div>
|
|
</section>
|
|
)}
|
|
|
|
{/* Section groups */}
|
|
{SECTIONS.map((sec) => {
|
|
const categoryMap = toolsBySection.get(sec.id);
|
|
if (!categoryMap || categoryMap.size === 0) return null;
|
|
|
|
const totalCount = [...categoryMap.values()].reduce((sum, arr) => sum + arr.length, 0);
|
|
const isCollapsed = collapsed.has(sec.id);
|
|
const SectionIcon = ICON_MAP[sec.icon] as
|
|
| React.ComponentType<{ className?: string }>
|
|
| undefined;
|
|
|
|
return (
|
|
<section key={sec.id}>
|
|
<button
|
|
type="button"
|
|
onClick={() => toggleSection(sec.id)}
|
|
className="w-full flex items-center gap-2 py-2 mb-2 border-b border-border/40 group cursor-pointer"
|
|
>
|
|
{SectionIcon && (
|
|
<div
|
|
className="p-1 rounded"
|
|
style={{
|
|
backgroundColor: `${sec.color}15`,
|
|
color: sec.color,
|
|
}}
|
|
>
|
|
<SectionIcon className="h-4 w-4" />
|
|
</div>
|
|
)}
|
|
<span className="text-sm font-semibold text-foreground">{sec.name}</span>
|
|
<span className="text-xs text-muted-foreground">{totalCount}</span>
|
|
<div className="flex-1" />
|
|
<ChevronDown
|
|
className={cn(
|
|
"h-4 w-4 text-muted-foreground transition-transform",
|
|
isCollapsed && "-rotate-90",
|
|
)}
|
|
/>
|
|
</button>
|
|
|
|
{!isCollapsed && (
|
|
<div className="space-y-5 ps-1">
|
|
{CATEGORIES.filter((cat) => categoryMap.has(cat.id)).map((category) => {
|
|
const tools = categoryMap.get(category.id) ?? [];
|
|
return (
|
|
<div key={category.id}>
|
|
<h3 className="text-[11px] font-semibold uppercase text-muted-foreground/50 tracking-widest mb-1.5">
|
|
{getCategoryName(t, category.id, category.name)}
|
|
</h3>
|
|
<div className="grid grid-cols-1 sm:grid-cols-2 lg:grid-cols-3 gap-2">
|
|
{tools.map((tool) => (
|
|
<ToolCard key={tool.id} tool={tool} variant="descriptive" showPin />
|
|
))}
|
|
</div>
|
|
</div>
|
|
);
|
|
})}
|
|
</div>
|
|
)}
|
|
</section>
|
|
);
|
|
})}
|
|
</div>
|
|
);
|
|
}
|
|
|
|
// ── Category Grid (used by modality tabs) ────────────────────────
|
|
|
|
function CategoryGrid({ groupedTools }: { groupedTools: Map<string, Tool[]> }) {
|
|
const { t } = useTranslation();
|
|
|
|
if (groupedTools.size === 0) {
|
|
return (
|
|
<p className="text-center text-muted-foreground py-16">{t.fullscreenGrid.noToolsFound}</p>
|
|
);
|
|
}
|
|
|
|
return (
|
|
<div className="space-y-6">
|
|
{CATEGORIES.filter((cat) => groupedTools.has(cat.id)).map((category) => {
|
|
const tools = groupedTools.get(category.id) ?? [];
|
|
return (
|
|
<section key={category.id}>
|
|
<h2 className="text-[11px] font-semibold uppercase text-muted-foreground/70 tracking-widest mb-2 pb-1.5 border-b border-border/40">
|
|
{getCategoryName(t, category.id, category.name)}
|
|
</h2>
|
|
<div className="grid grid-cols-1 sm:grid-cols-2 lg:grid-cols-3 gap-2">
|
|
{tools.map((tool) => (
|
|
<ToolCard key={tool.id} tool={tool} variant="descriptive" showPin />
|
|
))}
|
|
</div>
|
|
</section>
|
|
);
|
|
})}
|
|
</div>
|
|
);
|
|
}
|