Note taker

CHANGELOG.md

@@ -10,6 +10,9 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 ## [1.4.8] - 2026-02-12
 
 ### Added
+- **Referral Program**: Invite friends to earn free Pro months with referral dashboard, email invitations, invite tracking with status badges, and animated spectrogram share card with unique referral code
+- **Notes System**: Added sidebar navigation with notes system and dictionary view for organizing transcriptions
+- **Folder Organization**: Notes can be organized into custom folders with a default Personal folder, folder management UI, and folder-aware note filtering. Upload flow now includes folder selection
 - **Internationalization v1**: Full desktop localization across auth, settings, hooks, and UI with centralized renderer locale resources (#258)
 - **Chinese Language Split**: Split Chinese into Simplified (zh-CN) and Traditional (zh-TW) with tailored AI instructions and one-time migration for existing users (#267)
 - **Russian Interface Language**: Added Russian to interface language options
@@ -34,6 +37,7 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 - **Archive Extraction Retry**: Reuse existing archive on extraction retry with improved error handling
 - **Email Verification Polling**: Pass email param in verification polling and stop on 401 responses
 - **Auth Build Bundling**: Added @neondatabase/auth packages to rollup externals for correct production bundling (#256)
+- **Neon Auth Build Config**: Fixed Vite build configuration for Neon Auth packages (#266)
 
 ### Changed
 - **Build System**: Bumped Node version in build files

CLAUDE.md

@@ -399,12 +399,37 @@ On GNOME Wayland, Electron's `globalShortcut` API doesn't work due to Wayland's
 
 ## Development Guidelines
 
+### Internationalization (i18n) — REQUIRED
+
+All user-facing strings **must** use the i18n system. Never hardcode UI text in components.
+
+**Setup**: react-i18next (v15) with i18next (v25). Translation files in `src/locales/{lang}/translation.json`.
+
+**Supported languages**: en, es, fr, de, pt, it, ru, zh-CN, zh-TW
+
+**How to use**:
+```tsx
+import { useTranslation } from "react-i18next";
+
+const { t } = useTranslation();
+// Simple: t("notes.list.title")
+// With interpolation: t("notes.upload.using", { model: "Whisper" })
+```
+
+**Rules**:
+1. Every new UI string must have a translation key in `en/translation.json` and all other language files
+2. Use `useTranslation()` hook in components and hooks
+3. Keep `{{variable}}` interpolation syntax for dynamic values
+4. Do NOT translate: brand names (OpenWhispr, Pro), technical terms (Markdown, Signal ID), format names (MP3, WAV), AI system prompts
+5. Group keys by feature area (e.g., `notes.editor.*`, `referral.toasts.*`)
+
 ### Adding New Features
 
 1. **New IPC Channel**: Add to both ipcHandlers.js and preload.js
 2. **New Setting**: Update useSettings.ts and SettingsPage.tsx
 3. **New UI Component**: Follow shadcn/ui patterns in src/components/ui
 4. **New Manager**: Create in src/helpers/, initialize in main.js
+5. **New UI Strings**: Add translation keys to all 9 language files (see i18n section above)
 
 ### Testing Checklist
 
@@ -529,7 +554,7 @@ On GNOME Wayland, Electron's `globalShortcut` API doesn't work due to Wayland's
 
 - Streaming transcription support
 - Custom wake word detection
-- Multi-language UI
+- ~~Multi-language UI~~ (implemented — 9 languages via react-i18next)
 - Cloud model selection
 - Batch transcription
 - Export formats beyond clipboard

main.js

@@ -326,6 +326,7 @@ function navigateControlPanelWithVerifier(verifier) {
   windowManager.controlPanelWindow.focus();
 }
 
+
 function handleOAuthDeepLink(deepLinkUrl) {
   try {
     const parsed = new URL(deepLinkUrl);

package.json

@@ -84,6 +84,7 @@
     "vite": "^6.3.5"
   },
   "dependencies": {
+    "@neondatabase/auth": "^0.1.0-beta.21",
     "@neondatabase/neon-js": "^0.1.0-beta.22",
     "@radix-ui/react-accordion": "^1.1.2",
     "@radix-ui/react-dialog": "^1.1.14",

preload.js

@@ -1,4 +1,4 @@
-const { contextBridge, ipcRenderer } = require("electron");
+const { contextBridge, ipcRenderer, webUtils } = require("electron");
 
 /**
  * Helper to register an IPC listener and return a cleanup function.
@@ -39,6 +39,44 @@ contextBridge.exposeInMainWorld("electronAPI", {
   getDictionary: () => ipcRenderer.invoke("db-get-dictionary"),
   setDictionary: (words) => ipcRenderer.invoke("db-set-dictionary", words),
 
+  // Note functions
+  saveNote: (title, content, noteType, sourceFile, audioDuration, folderId) =>
+    ipcRenderer.invoke("db-save-note", title, content, noteType, sourceFile, audioDuration, folderId),
+  getNote: (id) => ipcRenderer.invoke("db-get-note", id),
+  getNotes: (noteType, limit, folderId) => ipcRenderer.invoke("db-get-notes", noteType, limit, folderId),
+  updateNote: (id, updates) => ipcRenderer.invoke("db-update-note", id, updates),
+  deleteNote: (id) => ipcRenderer.invoke("db-delete-note", id),
+  exportNote: (noteId, format) => ipcRenderer.invoke("export-note", noteId, format),
+
+  // Folder functions
+  getFolders: () => ipcRenderer.invoke("db-get-folders"),
+  createFolder: (name) => ipcRenderer.invoke("db-create-folder", name),
+  deleteFolder: (id) => ipcRenderer.invoke("db-delete-folder", id),
+  renameFolder: (id, name) => ipcRenderer.invoke("db-rename-folder", id, name),
+  getFolderNoteCounts: () => ipcRenderer.invoke("db-get-folder-note-counts"),
+
+  // Audio file operations
+  selectAudioFile: () => ipcRenderer.invoke("select-audio-file"),
+  transcribeAudioFile: (filePath, options) =>
+    ipcRenderer.invoke("transcribe-audio-file", filePath, options),
+  getPathForFile: (file) => webUtils.getPathForFile(file),
+
+  onNoteAdded: (callback) => {
+    const listener = (_event, note) => callback?.(note);
+    ipcRenderer.on("note-added", listener);
+    return () => ipcRenderer.removeListener("note-added", listener);
+  },
+  onNoteUpdated: (callback) => {
+    const listener = (_event, note) => callback?.(note);
+    ipcRenderer.on("note-updated", listener);
+    return () => ipcRenderer.removeListener("note-updated", listener);
+  },
+  onNoteDeleted: (callback) => {
+    const listener = (_event, data) => callback?.(data);
+    ipcRenderer.on("note-deleted", listener);
+    return () => ipcRenderer.removeListener("note-deleted", listener);
+  },
+
   onTranscriptionAdded: (callback) => {
     const listener = (_event, transcription) => callback?.(transcription);
     ipcRenderer.on("transcription-added", listener);
@@ -233,6 +271,15 @@ contextBridge.exposeInMainWorld("electronAPI", {
   cloudCheckout: () => ipcRenderer.invoke("cloud-checkout"),
   cloudBillingPortal: () => ipcRenderer.invoke("cloud-billing-portal"),
 
+  // Cloud audio file transcription
+  transcribeAudioFileCloud: (filePath) => ipcRenderer.invoke("transcribe-audio-file-cloud", filePath),
+  transcribeAudioFileByok: (options) => ipcRenderer.invoke("transcribe-audio-file-byok", options),
+
+  // Referral stats
+  getReferralStats: () => ipcRenderer.invoke("get-referral-stats"),
+  sendReferralInvite: (email) => ipcRenderer.invoke("send-referral-invite", email),
+  getReferralInvites: () => ipcRenderer.invoke("get-referral-invites"),
+
   // Assembly AI Streaming
   assemblyAiStreamingWarmup: (options) =>
     ipcRenderer.invoke("assemblyai-streaming-warmup", options),