https://github.com/campfirium/foliole

An approachable incremental reading app.
https://github.com/campfirium/foliole

fsrs incremental-reading knowledge-management learning local-first markdown note-taking personal-knowledge-management reading spaced-repetition

Last synced: 18 days ago
JSON representation

An approachable incremental reading app.

• Host: GitHub
• URL: https://github.com/campfirium/foliole
• Owner: campfirium
• License: apache-2.0
• Created: 2025-07-14T00:50:46.000Z (11 months ago)
• Default Branch: dev
• Last Pushed: 2026-05-31T13:45:49.000Z (21 days ago)
• Last Synced: 2026-05-31T15:06:00.966Z (21 days ago)
• Topics: fsrs, incremental-reading, knowledge-management, learning, local-first, markdown, note-taking, personal-knowledge-management, reading, spaced-repetition
• Language: TypeScript
• Homepage: https://foliole.app
• Size: 17.1 MB
• Stars: 1
• Watchers: 1
• Forks: 0
• Open Issues: 0
• Metadata Files:
  • Readme: README.md
  • Contributing: CONTRIBUTING.md
  • License: LICENSE
  • Code of conduct: CODE_OF_CONDUCT.md
  • Support: SUPPORT.md
  • Agents: AGENTS.md

Awesome Lists containing this project

• awesome-fsrs - Foliole

README

          


  

    English ·

    简体中文

  



# Foliole

Make reading actually complete.


An approachable incremental reading app.

Windows alpha is open for testing.


Android alpha is expected around July.


macOS and iOS alpha builds are expected around August.



  



## Design Principles

### Open Source

The code is open source. Anyone can review the implementation, build it from source, or contribute improvements.



  



### Open Data

Uses a SQLite database and provides a Markdown mirror, making materials easier to read, migrate, and reuse.



  



### Local First

No account system. No central cloud sync. All data stays on your personal devices; devices sync over the local network.



  



## Core Features

### Native Incremental Reading

Built around Piotr Woźniak’s incremental reading ideas, with a native workflow for extracting passages, creating cloze deletions, and refining materials without leaving the reading flow.



  



### Integrated FSRS Scheduling

Integrates FSRS (Free Spaced Repetition Scheduler), an open and efficient review scheduling algorithm.



  



### Bring Reading Materials Together

Handles reading materials from different sources, whether local files, web documents, notes managed in Obsidian, or materials exported from Readwise Reader.



  



### Index External Documents

Indexes other local folders on your computer without copying or moving the original files, creating an external document library that can be searched, viewed, and used across supported clients.



  



### Complex Content Support

Supports Markdown, PDF, EPUB, LaTeX math, code blocks, and other content rendering needs.



  



## Acknowledgements

Special thanks to Piotr Woźniak and Jarrett Ye. Without SuperMemo, incremental reading, and FSRS, Foliole would not exist.

Many thanks to the following open-source projects and components:

- better-sqlite3

- Capacitor

- CodeMirror 6

- Drizzle ORM

- Electron

- React

- SQLite

- TypeScript

- Vite