# Recall [![CI](https://github.com/Madlezz/Recall/actions/workflows/ci.yml/badge.svg)](https://github.com/Madlezz/Recall/actions/workflows/ci.yml) [![Release](https://img.shields.io/github/v/release/Madlezz/Recall)](https://github.com/Madlezz/Recall/releases/latest) [![License: MIT](https://img.shields.io/badge/License-MIT-green.svg)](LICENSE) [![Platform](https://img.shields.io/badge/platform-Windows%20%7C%20macOS%20%7C%20Linux%20%7C%20PWA-blue)](https://github.com/Madlezz/Recall/releases/latest) **Recall** is FSRS-grade spaced repetition that makes you want to come back. No manual, no account, your data stays yours. Built-in streaks, XP, and focus rituals turn review into a habit - not a chore. Available as a desktop app (Windows / macOS / Linux) and a PWA on mobile.

## Documentation | Doc | What | |---|---| | [Getting Started](docs/getting-started.md) | First run, study loop, import | | [Architecture](docs/ARCHITECTURE.md) | App layers, DB, Tauri vs browser | | [Sync](docs/SYNC.md) | Optional E2E self-host relay + folder sync | | [Deployment](docs/DEPLOYMENT.md) | Releases, PWA Pages, Worker | | [Card Formatting](docs/card-formatting.md) | Markdown, LaTeX, code, cloze | | [i18n](docs/i18n.md) | English + Bahasa Indonesia | | [Accessibility](ACCESSIBILITY.md) | Keyboard + screen reader | | [Roadmap](ROADMAP.md) | Planned work | | [Changelog](CHANGELOG.md) | Version history | | [Contributing](CONTRIBUTING.md) | Dev setup | --- ## Why Recall? Snapshot comparison for orientation only. **Third-party products change** - verify Anki / RemNote / Mochi in their own docs before relying on a cell. Anki version pin: **26.05** (upstream release tag as of mid-2026). | | Recall | Anki | RemNote | Mochi | |---|---|---|---|---| | Built-in engagement | **Yes** (XP, streaks, levels, achievements, focus timer, match game) | Via community add-ons | Some engagement features | Minimal | | No account, local-first | **Yes** (SQLite desktop, IndexedDB browser) | Local SQLite (+ optional AnkiWeb sync) | Cloud-first product with offline use | Local-first files; optional Pro sync | | FSRS on by default | **Yes** | Legacy **SM-2** by default; **FSRS opt-in** in deck options ([Anki manual](https://docs.ankiweb.net/deck-options.html#fsrs)) | Spaced repetition in a notes app (scheduler details product-defined; check in-app) | Spaced repetition (commonly SM-2-style; check Mochi docs) | | Open source | **Yes** (MIT) | Yes (AGPL) | No (proprietary) | App proprietary (some related OSS components) | | Add-on ecosystem | None (planned) | **Very large** (long history) | Extensions / plugins (product-defined) | Limited vs Anki | | Native desktop | **Yes** (Tauri + Rust) | Yes (Qt + Python) | Yes (desktop clients) | Yes (desktop clients) | | Mobile | **Installable PWA** | AnkiMobile / AnkiDroid (separate apps) | Mobile apps | Mobile apps | | Sync | Optional **E2E** (AES-256-GCM) via **self-hosted** relay, or folder/file sync - no maintainer-hosted cloud | AnkiWeb (not client-side E2E in the Anki sense); third-party options exist | Hosted product sync | Pro sync (see Mochi pricing/docs) | | Stack | **React + TypeScript** | Python + Qt | React-based web/desktop | ClojureScript (historically) | Anki pioneered desktop SRS and still has the deepest add-on ecosystem - that is an honest concession. Recall's edge is the habit loop: engagement features are native, not bolted on. **FSRS on by default**, local-first, MIT, TypeScript-friendly contributions, optional self-hosted E2E sync. --- ## Screenshots Dashboard - due cards, daily goal, deck grid: ![Dashboard](docs/screenshots/dashboard.png) Deck browser: ![Deck Browser](docs/screenshots/deck-browser.png) Deck detail - stats, tags, card list: ![Deck Detail](docs/screenshots/deck-detail.png) Study - card front: ![Study Mode](docs/screenshots/study.png) Study - answer revealed + FSRS interval preview: ![Study - Answer Revealed](docs/screenshots/study-revealed.png) Stats - activity, retention, forecast: ![Stats](docs/screenshots/stats.png) Tags - hierarchical tree: ![Tags](docs/screenshots/tags.png) Card browser - search, filter, bulk actions: ![Card Browser](docs/screenshots/card-browser.png) Settings - theme, accent, language, TTS: ![Settings](docs/screenshots/settings.png) > Recapture after UI changes: `pnpm dev` in one terminal, then `node scripts/take-screenshots.js`. --- ## Features ### Smart Study - **FSRS scheduling** - Again / Hard / Good / Easy - **Cloze deletion** - `{{c1::hidden text}}` - **Rich cards** - Markdown, LaTeX, syntax-highlighted code - **Anki import** - `.apkg` (review history + FSRS state) - **CSV / Markdown / `.recall` import** - **Custom study** - deck, count, tag filter, new-only - **Card browser** - search, filter, sort, bulk tag/delete/move - **Tags** - hierarchical tree, saved searches, autocomplete - **FSRS interval preview** on rating buttons - **FSRS optimizer** from review history - Keyboard-first: `Space` reveal, `1`-`4` rate, `R` review, `Ctrl+N` quick-add ### Stay Motivated - **XP & levels** - Curious Mind → Legend - **Achievements** - streaks, volume, accuracy, time-based - **Daily goal** + confetti on completion - **Session summaries** - **Onboarding gallery** - 6 starter decks ### Study Tools - **Focus timer** - 15 / 25 / 45m - **Ambient soundscapes** - Rain, Cafe, Lofi (synthesized, no assets) - **Match game** - **Review calendar** heatmap - **Sound effects** + optional TTS - **Swipe gestures** on mobile - **Voice input** in card editor (Web Speech API) - **Command palette** - `Ctrl+K` ### Analytics - Review volume, rating distribution, time-of-day - Deck health - retention, leeches, overdue - Activity heatmap, retention curve, 30-day workload forecast ### Privacy First - No account, no telemetry by default - Offline on your machine (SQLite desktop / IndexedDB browser) - JSON / `.recall` export - **Optional E2E cloud sync** - AES-256-GCM + PBKDF2; you deploy `sync-relay/` (Cloudflare Worker + R2) yourself - no maintainer-funded public relay - Optional folder sync (Dropbox, Drive, etc.) ### Customization - **6 accent colors** - zinc, blue, green, rose, amber, violet - **Dyslexia-friendly font** - **Dark / Light / High-contrast** - **English + Bahasa Indonesia** --- ## Quick Start ### Prerequisites - **Node.js** 22+ (dev pin: `.node-version` → 24.18.0) and **pnpm** 10+ - **Rust** stable (`rustup install stable`) for desktop builds - Platform libraries - see [CONTRIBUTING.md](CONTRIBUTING.md#prerequisites) ### Run ```bash pnpm install pnpm tauri dev # Desktop (Tauri) # or pnpm dev # Browser preview (no Rust) ``` ### PWA Installable PWA: **https://madlezz.github.io/Recall** Swipe left / right / up / down to rate after reveal. ### Testing ```bash pnpm test # Unit tests (806 as of 2026-07-18; count drifts) pnpm lint # ESLint pnpm build # tsc + Vite production build pnpm test:e2e # Playwright (starts `pnpm dev` via config) ``` --- ## Download Pre-built binaries on [Releases](https://github.com/Madlezz/Recall/releases/latest) (latest: **v1.2.0**): | Platform | File | |----------|------| | Windows | `.msi` | | macOS (Apple Silicon) | `.dmg` | | macOS (Intel) | `.dmg` | | Linux | `.AppImage` | Or build from source - [Quick Start](#quick-start). --- ## Security Local-first: card data stays on device unless you enable sync. - **CI audits**: `cargo audit`, Dependabot, CodeQL on push/PR - **Disclosure**: [SECURITY.md](SECURITY.md) Sync codes are E2E key material - never put them in exports or screenshots. --- ## Keyboard Shortcuts | Keys | Action | |------|--------| | `Space` | Reveal answer | | `1`-`4` | Again / Hard / Good / Easy | | `R` | Start review | | `B` | Bury card | | `S` | Snooze card | | `Ctrl+N` | Quick-add (in-app) | | `Ctrl+Shift+N` | Quick-add (global, desktop) | | `Ctrl+Z` | Undo last review | | `Ctrl+K` | Command palette | | `T` | Toggle TTS | | `?` | All shortcuts | --- ## Contributing See [CONTRIBUTING.md](CONTRIBUTING.md). - [`good first issue`](https://github.com/Madlezz/Recall/labels/good%20first%20issue) - [ROADMAP.md](ROADMAP.md) - Open an issue before large PRs --- ## Tech | What | With | |------|------| | Desktop | Tauri 2 + Rust (rusqlite) | | Mobile | PWA (`vite-plugin-pwa`) | | UI | React 19 + TypeScript (strict) | | Styling | Tailwind CSS + shadcn/ui primitives | | Browser storage | Dexie | | Desktop storage | SQLite via Tauri | | State | Zustand | | Algorithm | FSRS (`ts-fsrs`) | | Sync | AES-256-GCM + PBKDF2; self-hosted Worker relay or folder sync | | i18n | react-i18next | | Icons | Lucide | --- ## License MIT © [Madlezz](https://github.com/Madlezz)