Folyo

Folyo is a private financial memory that turns the records you already have into a clear, searchable story of your money.

Folyo is a local-first release-candidate implementation for website and desktop. It detects supported local delimited, structured, and narrow text-PDF statements; previews before commit; preserves source evidence; handles duplicates and transfers cautiously; supports local search, recovery, portable backups, browser opt-in persistence, and an encrypted desktop vault. It has no bank connection, cloud sync, financial advice, budget workflow, or mobile application.

The product is not production-ready yet. Signed distribution, supported-platform verification, accessibility validation, threat-model review, external usability research, recovery testing, and operational readiness are explicit gates in the production readiness plan. See the release-candidate scope for exact limits.

Run locally

Requirements:

• Node.js 20 or newer
• npm 10 or newer
• Rust and Cargo for the desktop application

Install dependencies:

npm install

Run the website:

npm run dev:site

Build the website:

npm run build:site

Run the desktop frontend in a browser:

npm run dev:desktop

Run the Tauri desktop shell:

npm run tauri:dev

Run checks:

npm run typecheck
npm test
npm run format:check

Privacy boundary

The website and desktop read selected files locally and do not upload them. The website offers browser-local persistence only after explicit consent. Desktop protects its local vault using the operating-system key store and encrypted storage. Portable backups are open JSON and should be treated as sensitive; desktop encrypted backups are device-bound.

See the documentation index for the product direction, roadmap, ease-of-use strategy, execution plan, production-readiness plan, and technical references.