Documentation

Revu is designed to help you remember everything you learn through scientifically-optimized spaced repetition.

Creating Your First Deck

1. Click the + button in the sidebar under “Decks”
2. Name your deck (e.g., “Spanish Vocabulary”)
3. Add optional notes in Markdown format
4. Click Save

Adding Cards

Revu supports three card types:

Studying Your Cards

1. Select a deck from the sidebar
2. Click the Study button
3. Read the question and try to recall the answer
4. Press Space to reveal the answer
5. Grade yourself: 1 (Again), 2 (Hard), 3 (Good), or 4 (Easy)

Revu uses the Free Spaced Repetition Scheduler (FSRS), a modern algorithm that adapts to your individual learning patterns.

How It Works

• Stability: How long you can remember something before forgetting
• Difficulty: How hard a card is for you personally (1-10 scale)
• Predicted Recall: The likelihood you'll remember when next reviewed
• Retention Target: Your goal recall rate (default: 90%)

The Four Queues

Grading Guidelines

Revu is completely local-first. Your data never leaves your device unless you explicitly export or sync it.

Storage Location

File Structure

• 📄 decks.json - All your decks
• 📄 cards.json - All your cards with SRS state
• 📄 review-logs.jsonl - Append-only review history
• 📄 settings.json - Your preferences
• 📁 attachments/ - Media files
• 📁 backups/ - Automatic snapshots

Human-Editable JSON

All data is stored in plain JSON. You can open these files in any text editor to:

• Bulk edit cards with find-and-replace
• Create decks programmatically
• Version control your study materials
• Migrate to other tools if needed

Import & Export

Export your decks to JSON with full fidelity including review history and scheduling state. Import handles:

• UUID-based merging - Only updates cards with newer timestamps
• Validation - Checks schema and required fields
• Preview - See what will change before importing
• Cloze regeneration - Automatically recreates front/back from source

Scheduling

Interface

Notifications