🚀 SurfSense 2026 Roadmap

[MODSetter]

Good First Issues — Roadmap

Welcome! This discussion tracks curated good first issues for contributors. Each issue has a clear scope, affected files, and acceptance criteria so you can pick one up and ship it.

Thanks to everyone who has landed PRs — many earlier issues are now closed.

---

Performance

• #1241 — Replace full icons import from lucide-react with explicit icon whitelist in lib/source.ts
• #1242 — Lazy-load DocumentTabContent in LayoutShell to reduce dashboard shell bundle
• #1246 — Derive blog search results with useMemo instead of useState + useEffect
• #1249 — Remove unused _hasScrolledToCited state in source-detail-panel.tsx
• #1250 — Replace discarded isExportingKB useState with a ref in DocumentsSidebar
• #1047 — Build index Maps for repeated .find() lookups in chat and document hooks
• #1044 — Defer PostHog loading from the critical bundle path

React State Management

• #1247 — Use functional setIsDark in toggleTheme to remove stale closure dependency
• #1248 — Move duplicate-tag check inside functional setTags in EmailsTagField
• #1018 — Use key prop to reset LLM role manager form state instead of useEffect sync

Architecture / Refactor

• #1251 — Move dialog/popover open-reset effects into onOpenChange handlers (3 files)
• #1252 — Move ModelSelector reset effects into the open/tab event handlers
• #1245 — Deduplicate anonymous-chat upload logic: use anonymousChatApiService.uploadDocument in both call sites

SEO

• #1244 — Add SEO metadata for /announcements via a server layout.tsx

UX

• #1243 — Add loading.tsx skeletons for async marketing routes (docs, blog, changelog, free)
• #911 — Add error state handling in general settings manager

Accessibility

• #913 — Add keyboard accessibility to clickable media cards on homepage

---

How to contribute

1. Pick an issue that interests you and comment to claim it
2. Read the "What to do" and "Acceptance criteria" sections carefully — they're designed to keep scope small and unambiguous
3. Fork, make changes, run pnpm build in surfsense_web/
4. Open a PR linking the issue

New contributors welcome! If anything is unclear, leave a comment on the issue.