1.1.0

Cultiva 1.1.0 · Cypress

Grow your habits. Grow yourself.

Highlights

• Кипарис / Cypress theme — a new evergreen look for this release.
• Three new animated backgrounds: Cypress Drift, Morning Dew, Canopy Sunbeam.
• Accent color and ambient intensity — fine-tune the atmosphere without turning backgrounds off.
• Search habits from the garden (Ctrl/Cmd+F).
• Keyboard shortcuts — plant habits, open settings, complete or log quantity, close modals.
• Export ZIP — habits and settings in one archive (desktop app).

Install

Download Cultiva-Setup-1.1.0.exe (installer) or Cultiva-Portable-1.1.0.exe (portable).

Data stays on your device. No account required.

Upgrade from 0.4.x

Your IndexedDB garden is preserved. Open Settings → Data to export a JSON or ZIP backup before upgrading if you want a safety copy.

0.4.0 Coconut: Notifications & Plugins & Ambient Layers

Desktop habit tracker — offline first, Windows 10/11.

Grow your habits. Grow yourself.
This release refines how Cultiva feels on screen, how plugins run safely, and how the Windows build ships — including a fix for portable installers.

---

I For everyone using Cultiva

Look & feel

Choose how the app reads in your space. Themes are grouped so light and dark palettes stay predictable, with Auto following the OS.

Appearance	Themes you can pick
Light	Light · Blossom · Frost · Cedar · Meadow · Orchard · Honeycrisp
Dark	Dark · Evergreen · Ocean · Sunset · Pink · Moon · Dusk · Inkwell · Sequoia
System	Auto (matches light/dark mode)

Ambient backgrounds

Garden and calendar share the same ambient layer. Pick a preset or your own photo:

Preset	Notes
None	Clean, distraction-free
Aurora Garden · Rainfall · Starlight · Snowfall · Fireflies	Classic animated layers
Petal Drift · Silicon Mist · Ember Glow · Breeze Glass	New motion presets
My Photo…	JPEG / PNG / WebP / GIF, stored locally in your profile

Calendar

The calendar page uses the same ambient background pipeline as the garden, so switching theme or background feels consistent everywhere you plan your week.

Plugins (desktop)

• Install community widgets from the registry (HTTPS), with safer fetching from the packaged app.
• Plugin code runs in a sandboxed iframe — no direct access to privileged Electron APIs or the main DOM from plugin JavaScript.
• New in 0.4.0: Cultiva can show plugin sheets, header chips, and garden HTML in the main window through a small, documented bridge (see https://github.com/krwg/Cultiva/wiki/Cultiva-Plugins-Guide).

Notifications & updates

• Native OS notifications where supported, with settings that match the rest of the UI.
• Auto-update from GitHub Releases is more resilient (softer handling when no update exists, respect for dev flags and DISABLE_AUTO_UPDATER).

Habits

• Quantity habits get a proper log flow on desktop.
• Numeric values are normalized so streaks and comparisons stay reliable.

---

II For GitHub contributors & packagers

Downloads

Artifact	When to use it
Cultiva-Setup.exe	Default install — shortcuts, uninstall entry, in-app updates when published on Releases
Cultiva-Portable.exe	Copy-run workflows, USB sticks, machines where you prefer not to run an installer

Windows icon & portable build

electron-builder requires the Windows .ico to include at least a 256×256 image for the portable target. Cultiva’s favicon historically embedded smaller sizes only.

Fix: scripts/sync-build-icon.mjs (runs in prebuild) now:

1. Decodes src/images/favicon.ico with decode-ico
2. Upscales the best frame to 256×256 with sharp
3. Writes a multi-size ICO via to-ico → build/icon.ico and electron/app-icon.ico

After npm install, npm run electron:build should produce both NSIS and portable artifacts without the previous image … must be at least 256x256 error.

Plugin architecture (summary)

Layer	Responsibility
Main process	File I/O, pluginHttpGet, install paths, notifications
Renderer + plugin-manager	Registry fetch, sandbox host, injecting manifest.styles, main-window UI bridge
Sandbox iframe	index.js as new Function(context, hooks, …) — storage RPC, hooks, sheet/header/garden messages

Instance methods on ES classes are exposed to the host proxy via prototype enumeration (so openWeatherModal and friends work reliably).

Notable commits (themes & scope)

High-level themes from main — use git log for the full graph:

• 0.4.0 “Coconut” — appearance module split (theme-config.js, ambient-bg.js), settings & i18n refresh, updater hardening, plugin HTTP path, CSP relaxations for GitHub assets.
• Plugins — sandboxed execution, IPC hardening, style injection from manifest, main-window bridge for sheets / header / garden.
• Security & data — credential handling with safeStorage where available, XSS-hardening in plugin-facing UI paths, integrity checks on plugin flows.
• Desktop polish — app icon in the packaged .exe and shortcuts, native notification wiring, sandbox CSP fixes.

Upgrade checklist

• Back up %APPDATA%/Cultiva (or your portable folder) if you rely on local data.
• Install 0.4.0 over 0.3.x — IndexedDB layout is forward-compatible for this track; if you hit issues, open an issue with logs from Help → DevTools (if exposed) or the terminal when running electron:dev.
• Plugin authors: if you use the new main-window APIs, set "minAppVersion": "0.4.0" and republish on CultivaPlugins.

---

Links

Resource	URL
Latest release	https://github.com/krwg/Cultiva/releases/latest
Plugin author guide	https://github.com/krwg/Cultiva/wiki/Cultiva-Plugins-Guide
Public plugin registry	https://github.com/krwg/CultivaPlugins

0.3.5 Sequoia: Plugins, Themes & Auto-Updates

The biggest update since the beginning. Everything that's happened since the last release on the original repo — in one place.

---

Make Cultiva yours.

Three releases worth of work, now landing here as the new home of the project.
This update brings the plugin system, four new themes, animated backgrounds, and automatic updates — all at once.

---

Plugins

Browse, install, and manage plugins right from Settings → Plugins. Each plugin lives in your header — always within reach, never in the way.

Plugins are sandboxed, versioned, and pulled directly from the CultivaPlugins registry. The API exposes onAppStart, onHabitComplete, header slots, and garden widgets — enough to build something genuinely useful.

%APPDATA%/cultiva/cultiva-plugins/

Weather Widget — the first official plugin

Powered by Open-Meteo — free, no API key required.

• Current temperature, feels like, humidity, wind speed
• Geocoding search — any city on Earth
• Live temperature in the header icon
• Optional garden widget
• Extreme weather notifications

→ Browse all plugins · Build your own

---

Auto-Updates

Cultiva now keeps itself up to date. Updates download in the background — when a new version is ready, you get a notification and one click to install.

• Background download with progress indicator
• One-click restart to apply
• Manual check available at Settings → Updates

---

New Themes

Four new themes join the collection — each with its own mood.

Frost — cool morning palette with soft blues

Cedar — warm wood tones

Dusk — purple twilight ambiance

Meadow — fresh green meadow colors

---

New Animated Backgrounds

Snowfall — gentle falling snowflakes
Fireflies — glowing floating particles in a dark forest

---

Fixes & Polish

• DevTools disabled in production builds
• Holiday region now properly syncs between Settings and Calendar
• Fixed duplicate CSP headers causing plugin fetch failures
• Fixed avatar aspect ratio in dropdown menu
• Fixed button alignment in avatar customization modal
• Release notes cached to avoid GitHub API rate limits
• Version display in About now includes "Desktop" suffix
• Holiday region selector shows country names instead of emoji flags

---

Technical

Changed files & internals

New files

• src/core/plugin-manager.js — plugin lifecycle, version compatibility
• electron/plugin-ipc.cjs — file operations in userData

Modified

• src/main.js — plugin UI integration
• electron/main.cjs — CSP (connect-src allows GitHub API + Open-Meteo) and IPC setup
• src/pages/calendar/calendar.js — holiday sync fix

CSS

• New theme variables: --frost-*, --cedar-*, --dusk-*, --meadow-*
• Background generators: generateSnowflakes(), generateFireflies()

Updates

• electron-updater configured with publish to GitHub Releases

---

Download

Format	Description
Installer .exe	Recommended — installs to Program Files, creates shortcuts, auto-updates
Portable .exe	No install required — run directly or from a USB drive

---

Developer setup

git clone https://github.com/krwg/Cultiva.git
cd Cultiva
npm install

# Development (Vite + Electron, hot reload)
npm run electron:dev:watch

# Production build
npm run electron:build
# → ./release/Cultiva_x64.exe
# → ./release/Cultiva_portable_x64.exe

---

Full changelog: 0.3.0...0.3.5

_{Built by krwg · «Sequoia» Release · Discussions · Plugins}

[0.3.0] — Sequoia: Calendar & Settings2 & GrowthKit2

[0.3.0] Sequoia

The foundation update. Refined, rebuilt, and ready to grow.

---

GrowthKit2

The habit engine, rewritten.

• Accurate streak calculation — timezone-aware, edge cases handled
• Cleaner data model — currentStreak and bestStreak properly separated
• Migration-ready — built for future features

---

Settings2

iPadOS-style, two-column layout.

• Profile — avatar, account status, member since
• Appearance — language, theme, background
• Garden — trophy toggle, focus mode
• Calendar — timezone, holiday region, time format
• Data — export, import, reset
• About — version, tips, privacy, GitHub

---

Calendar

Month, week, and day views.

• 12 event colors + rich notes

• Auto-sync with completed habits

• Smart timezone handling
• Holiday region support (5 countries)
• 12h / 24h time format

---

New & Redesigned Pages

• Tips — 12 expert-backed strategies with filters

• Privacy — clear principles while full policy is finalized

• Landing — Apple-style, animated gradient, desktop CTA

• Changelog — clean release cards

---

Themes & Polish

• New themes: Pink , Moon , Sunset , Ocean , Blossom , Evergreen

• 12 themes total
• Avatar emojis expanded
• Backgrounds: Three new backgrounds
• Unified navigation across all pages

---

Download Cultiva Desktop [0.2.1]

[0.2.1] — Aspen: Themes & Pages

Features:

• Added Tips & Privacy pages
• New themes: Pink & Moon

• Avatar emojis

Desktop

Native Windows app now available: Download Cultiva Desktop [0.2.1]

[0.2.0] Aspen Release: Accounts, GrowthKit & IBD2

Features

• User accounts with salted SHA-256 auth
• IndexedDB storage with user-scoped data
• GrowthKit: streak tracking, gamified progress

[0.1.5] Maple Release: Auth UI & Docs

[EN] What's New

This release focuses on infrastructure, documentation, and the foundation for user accounts.

New Features

• Auth UI: Added Login/Register modal interface (local storage mock).

• User Menu: Redesigned dropdown menu with avatar preview.

• Documentation: Full Wiki setup (Getting Started, Architecture, Roadmap).
• Dev Portal: Added developer promo page via GitHub Pages.

Bug Fixes

• Fixed streak calculation for quantity-based habits.
• Fixed background color issue in the user dropdown menu.
• Optimized CSS (removed duplicates, consolidated avatar styles).
• Fixed duplicate habit completion (double-click bug).

Developer Notes

• Codebase optimized for readability.
• New GitHub Issues created for future contributions (IndexedDB, Notifications).

[0.1.0] Maple

[EN] [0.1.0] Maple —— Initial Release

Welcome to the first official release of Cultiva, a minimalist, gamified habit tracker built from the ground up. This release establishes the complete foundation of the project: a fast, dependency-free core, a Apple-inspired interface, local-first data architecture, and full bilingual support.

Key Features

• Gamified Growth System: Watch habits evolve through 5 visual stages (Seed → Sprout → Sapling → Tree → Legacy)
• Trophy Garden: Automatically archives habits that reach 365+ days
• Focus Mode: Distraction-free tracking with a minimal, clean UI
• Custom Avatars: 12 gradient backgrounds × 24 emojis with live preview
• Full i18n Support: Seamless English/Russian switching without page reload
• Smart Theming: Light, Dark, and Auto modes synced with OS preferences
• Analytics & Calendar: GitHub-style contribution grid + streak statistics
• Local-First Backup: Full JSON export/import, zero cloud dependency required
• Responsive & PWA-Ready: Mobile-optimized layout, installable on any device

Tech Stack

• Core: Vanilla JavaScript (ES6+), CSS3 Custom Properties, Semantic HTML5
• Build: Vite 5 (HMR, tree-shaking, zero external dependencies)
• State & Storage: Modular architecture, localStorage persistence
• Design: Apple-inspired glassmorphism, fluid typography, 60fps CSS transitions

Quick Start

bash git clone https://github.com/krwg/cultiva.git cd cultiva npm install npm run dev

Open http://localhost:3000 to plant your first habit.