Build from source

Folio is a native AppKit app. Its only third-party dependency is Sparkle, which installs updates. You need Xcode 27 and XcodeGen.

Get the code#

brew install xcodegen
git clone https://github.com/alexmodrono/folio.git
cd folio

The Xcode project is generated from project.yml. Don't edit Folio.xcodeproj by hand; the build script regenerates it.

Build and run#

scripts/build.sh            # Debug build into build/Products/Debug/Folio.app
scripts/run.sh              # build and launch the Debug app, logs in the terminal
scripts/test.sh             # unit tests

scripts/build.sh Release makes a Release build, which needs a Developer ID certificate. Debug builds never check for updates.

Try it without your library#

Point a Debug build at a scratch folder so it doesn't touch ~/Documents/Folio:

defaults write app.folio.Folio libraryPath ~/Desktop/folio-test
scripts/run.sh
defaults delete app.folio.Folio

When chatgpt.com changes#

The selectors Folio uses on chatgpt.com are at the top of Folio/Resources/chatgpt-bridge.js. The bridge tests run it against saved copies of chatgpt.com's markup in FolioTests/Fixtures/. Update both when the page changes.