Files
SnapOtter/apps/web/src/pages/home-page.tsx
T
SnapOtterandGitHub 86251434b5 feat(telemetry): Sentry + PostHog quality pass (#546)
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.
2026-07-17 01:51:48 +00:00

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">&#8984;</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>
);
}