Skip to content
krwg edited this page Jul 8, 2026 · 1 revision

FAQ


General

Is Cultiva free?

Yes. Cultiva is open source under GPL-3.0. No subscription, no cloud paywall.

Do I need an account?

No. Core use is fully offline with local IndexedDB storage.

Where is my data stored?

Under Electron userData in your Windows profile (see Privacy and Security). Portable builds store data relative to the portable layout.

Does Cultiva send telemetry?

No telemetry in the default build. Network use is limited to optional features (plugin registry, weather API, Discord RPC, auto-update checks).


Habits

What happens after 365 days?

The habit becomes a Legacy tree — a permanent visual trophy in your garden.

What is a grace day?

Starting in 1.7, you get one missed day before a streak resets (configurable behavior — see release notes).

Can I track numeric habits?

Yes — quantity habits let you log counts instead of simple done/not-done.


Plugins

Why won't a plugin install?

Common causes:

  • Cultiva version below plugin's minAppVersion (need 1.7.0+ for current registry)
  • No internet / GitHub blocked
  • sha256 mismatch (registry out of date vs downloaded files)
  • Sandbox timeout on slow onEnable (e.g. blocking network before UI registers)

Check DevTools console: View → Toggle Developer Tools.

Why does Weather show the wrong city?

If you changed City in Settings but didn't pick from the plugin sheet, coordinates may still point to the default (Moscow). Use the Weather header chip → city search, or wait for the geocoding fix.

Why does Pomodoro look broken?

If Pomodoro is the only installed sheet plugin, shared sheet CSS may be missing. Install Weather or Time as a workaround, or wait for core sheet CSS injection.

Can I use my own plugin registry?

The registry URL is configurable in plugin settings (advanced). Your registry must follow the cultiva-plugins format.


Updates & builds

How do auto-updates work?

When a GitHub Release includes latest.yml, the packaged app checks for updates via electron-updater.

Can I build from source?

Yes — see Desktop Build. Requires Node 20+, npm ci, npm run build.


Contributing

How do I report bugs?

Open an issue on the main repo. Plugin-specific bugs can go to cultiva-plugins issues.

How do I publish a plugin?

See Cultiva Plugins Guide and the cultiva-plugins README.

Clone this wiki locally