1.3.0

What's Changed

• test: ⭐ star emoji in README title by @commrelayunit in #27
• Feature/semantic scholar integration by @velitchko in #32
• whats new? by @velitchko in #33
• Feat/dead code cleanup by @velitchko in #35
• chore: add feature request issue template by @commrelayunit in #36
• Wire RefHub API key management UI to backend routes by @commrelayunit in #39
• fix: tidy API key vault access layout by @commrelayunit in #41
• fix: pass API key management base URL to frontend build by @commrelayunit in #42
• docs: add frontend v2 roadmap by @commrelayunit in #44
• Add Google and GitHub OAuth login by @commrelayunit in #45
• Fix auth UI polish and narrow account settings layout by @commrelayunit in #48
• fix: auth UX polish — last-used provider badge, dark mode, settings alignment by @commrelayunit in #49
• fix: remove last-used badge from logged-in views by @commrelayunit in #50
• feat: public vault fork with RLS fix by @commrelayunit in #51
• fix: add public/read-only publication view dialog by @commrelayunit in #56
• fix: correct last updated attribution by @commrelayunit in #57
• feat: route Semantic Scholar frontend flows through backend by @commrelayunit in #55
• fix: refine public vault fork UI by @commrelayunit in #58
• fix: refine public vault fork UI by @commrelayunit in #59
• fix: polish account settings mobile tabs by @commrelayunit in #60
• fix: restore codex sidebar account actions by @commrelayunit in #61
• fix: align publication dialog spacing and table open behavior by @commrelayunit in #63
• fix: enrich related paper metadata rendering by @commrelayunit in #64

Full Changelog: 1.2.0...1.3.0

❤️ @velitchko @commrelayunit @claude

v1.2

refhub · Release v1.2.0 — 2026-03-02

TL;DR — Ship it, keyboard warriors: better exports, vim-style navigation, prettier markdown, smarter tags, and notes that tell you when they were last saved. Keyboard-first, nerd-approved.

---

Highlights

• Export: selectable BibTeX fields, hierarchical tags exported as keywords, optional personal notes, and an APA 7th preview for quick copy/paste into Word. Fast copy, clean paste.
• Keyboard-first UX: global & context-aware shortcuts, vim-ish navigation in vaults & publication lists (j/k, Enter, Space), Ctrl+S to save, Ctrl+E to export, and ? to summon the cheat-sheet.
• Tagging: single-sheet Tag Manager with inline add/edit/delete + color picker; optimistic creates reconcile with realtime updates so you don’t get tag spam.
• Notes & markdown: better markdown rendering (footnotes, anchors, code highlighting), fullscreen notes now include a Save button and a live, local-only “Last saved X ago” badge.
• Dialogs: publication edit dialog can stay open after save (power-edit mode via closeOnSave toggle).
• Import UX: unified add/import modal (tabs) — one modal to rule them all.

---

Geeky changelog (dev-focused)

• Export layer

  • BibTeX engine extended to support field selection and hierarchical-tag → keywords mapping. See src/lib/bibtex.ts and new helper src/lib/export.ts.
  • Export dialog UI and flow consolidated in src/components/publications/ExportDialog.tsx.

• Keyboard infra

  • Canonical keymap + help overlay introduced. Core pieces: src/lib/keyboard.ts, src/contexts/KeyboardContext.tsx, and list navigation hook src/hooks/useKeyboardNavigation.tsx.
  • Help UI: src/components/ui/KeyboardHelpOverlay.tsx and compact hints via src/components/ui/KbdHint.tsx.

• Tags & realtime

  • TagManager simplified to a single-sheet management view with color editing; optimistic create bookkeeping and realtime reconciliation handled in src/contexts/VaultContentContext.tsx.

• Notes & rendering

  • Centralized markdown renderer component and CSS tweaks for consistent spacing and footnote/anchor behavior; main usage in src/components/publications/PublicationDialog.tsx.
  • Local-only last-save indicator implemented in the fullscreen notes flow (no DB writes).

---

Upgrade / migration notes

• If you add a color attribute to tags, run the DB migration to add the column and update src/types/database.ts.
• No user-visible data migrations required for export or keyboard changes.
• Keyboard & UX features are feature-flag friendly for staged rollouts.

---

QA checklist

• Export: generate BibTeX with/without tags & notes; import into Zotero/EndNote; paste APA into Word.
• Keyboard: exercise vault & publication navigation (j/k, Enter, Space), Ctrl+S in dialogs, Ctrl+E to export, and ? to open help.
• Tags: create tags quickly from two clients to validate dedupe/reconciliation and color persistence.
• Notes: open fullscreen, edit, Ctrl+S, verify “Last saved X ago” updates and no extra DB writes.

---

Known limitations

• APA output is pragmatic — great for copy/paste, not a full citation engine. Edge cases for complex author lists may need tuning.
• Publishing snapshots / public vault snapshotting is planned but not included in this release.

---

Pro tips for power users

• Remap keys in src/config/kbd.config.ts — the help overlay reads from that file automatically.
• Export formatting helpers live in src/lib/export.ts (APA) and src/lib/bibtex.ts (BibTeX). Add tests before wide usage.

---

Credits & dev tips

Built with love, keystrokes, and a touch of chaos and Claude ❤️

first release

refhub.io v1.0.0 - initial release

first stable release of refhub.io, a modern reference management platform for organizing academic publications and building citation networks.

features

• publication management: store and organize academic papers with full metadata support (authors, journals, DOIs, abstracts, PDFs)
• bibtex support: import and export publications in bibtex format
• vaults: organize papers into project-based collections
• hierarchical tagging: create nested tag structures for advanced organization
• relationship mapping: link papers with semantic relationships (cites, cited-by, related-to, builds-on)
• interactive graph visualization: explore citation networks and paper connections
• the codex: browse and discover public vaults from the research community
• collaboration: share vaults with specific users (viewer/editor permissions)
• forking: clone public vaults from other researchers
• user profiles: showcase your research collections publicly
• social integration: connect via github, linkedin, and bluesky
• analytics: track views and downloads for public vaults
• responsive ui: full dark/light theme support with table, card, and graph views
• advanced filtering: build complex queries with the query builder

tech stack

built with react 18, typescript, vite, tailwind css, shadcn/ui, and powered by supabase (postgresql + auth + row level security).

getting started

see the readme for installation and setup instructions.

license

this project is licensed under gpl v3.