Summary

Revu is a local-first, open-source macOS application designed for efficient studying. It addresses the need for a powerful, privacy-focused desktop study tool by integrating spaced repetition, a comprehensive workspace, and a polished SwiftUI interface. The project offers a robust, standalone version of its commercial counterpart, benefiting users who prioritize local data control and advanced study management.

How It Works

Revu employs a local-first, SQLite-backed architecture on macOS, utilizing MVVM with actor-isolated persistence and pure scheduling logic. Its core is the FSRS algorithm for adaptive spaced repetition, integrated with a comprehensive study workspace. A token-based SwiftUI design system ensures UI consistency and responsiveness, while keyboard-driven workflows prioritize efficiency.

Quick Start & Requirements

Installation is via a macOS DMG file (macOS 14+ required). Building from source necessitates Xcode 16+. App data resides locally at ~/Library/Application Support/revu/v1/. No backend setup or environment variables are needed for building or running.

Highlighted Details

• FSRS-based adaptive review scheduling.
• Comprehensive study workspace: decks, folders, cards, exams, guides, courses, history.
• Extensive import pipeline: Anki (.apkg, .colpkg, profiles), CSV/TSV, Markdown, Revu JSON.
• Local-first, SQLite-backed architecture with no account or network dependency.
• Token-based SwiftUI design system for consistent UI elements.
• Keyboard-driven workflows for enhanced speed.
• Full-fidelity Revu JSON export for backup and interoperability.
• Study session forecasting for workload, retention, and velocity.

Maintenance & Community

Contributions are welcome, with guidelines provided in CONTRIBUTING.md. The project emphasizes focused PRs, adherence to the MVVM split, use of design system tokens, and running the test suite. Bug reports should include detailed steps and system information.

Licensing & Compatibility

Licensed under GPL-3.0-only. The Revu name and logo are trademarks and are not licensed for reuse under the GPL. This is a standalone macOS application; the commercial product is available at revu.cards.

Limitations & Caveats

Requires macOS 14+. This is a standalone, open-source version; the commercial product at revu.cards offers sync and AI features. The Revu name and logo are trademarks and are not licensed under the GPL.