Skip to content

feat: add bidirectional Vikunja task synchronization #1468

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Jump to bottom
Open
carlos-otero wants to merge 8 commits into
base: main
Choose a base branch
from
Open

feat: add bidirectional Vikunja task synchronization #1468

carlos-otero wants to merge 8 commits into from

Conversation

@carlos-otero
Copy link

@carlos-otero carlos-otero commented Jan 11, 2026

Summary

Adds bidirectional task synchronization with Vikunja, allowing tasks to sync between TaskNotes and a self-hosted or cloud Vikunja instance.

Features

  • Bidirectional sync: Push tasks to Vikunja on create/update/complete, pull changes from Vikunja on a configurable interval
  • Full field mapping: title, status, due date, scheduled date, priority, tags/labels, recurrence, reminders, description (HTML ↔ Markdown), and subtasks (via Vikunja relations API)
  • Unified settings UI: Single card in Integrations tab with master toggle that reveals sync options when enabled
  • Two-pass pull sync: Resolves race conditions where child tasks are processed before parent tasks exist locally

Field Mapping

TaskNotes Vikunja
title title
status done
due due_date
scheduled start_date
priority priority
tags labels
recurrence repeat_after
reminders reminders
projects parent task (relations API)
body description (HTML)

Changes

  • src/services/VikunjaService.ts - API client for Vikunja endpoints
  • src/services/VikunjaSyncService.ts - Sync logic with two-pass pull, field mapping, HTML/Markdown conversion
  • src/settings/tabs/integrationsTab.ts - Unified card UI for Vikunja settings
  • src/types/settings.ts - VikunjaSettings interface
  • src/settings/defaults.ts - Default settings values
  • src/main.ts - Service registration and sync interval scheduling
  • README.md - Documentation for Vikunja sync setup

Testing

  1. Configure API URL, Token, and List ID in Settings → Integrations → Vikunja Task Sync
  2. Enable sync and verify connection with "Test Connection"
  3. Create/update tasks in TaskNotes and verify they appear in Vikunja
  4. Create/update tasks in Vikunja and trigger "Sync Now" to verify they appear in TaskNotes

@carlos-otero
feat: Implement Vikunja bidirectional synchronization
b6ee4e1
@carlos-otero
feat: Implement full bidirectional Vikunja sync
c70b546 
- Add 2-way sync for Due Date, Scheduled Date, and Priority.
- Add Recurrence synchronization (Vikunja seconds <-> RFC 5545).
- Add full Reminder sync (Absolute & Relative) with ID mapping.
- Fix date parsing issues (handle 0001-01-01).
- Implement self-healing for corrupted date fields.
- Add 'Vikunja: Sync Now' command with completion notifications.
- Update settings UI with sync options.
@carlos-otero
Enabled tag sync
477456f
@carlos-otero
feat(vikunja): Implement bidirectional sync with HTML/Markdown conver…
9ef36ec 
…sion

- Added VikunjaService and VikunjaSyncService.
- Implemented bidirectional sync for Tasks (Status, Title, Description, Dates).
- Implemented Tag/Label two-way sync.
- Added Turndown/Showdown for HTML <-> Markdown conversion.
- Fixed Push logic to detect manual file edits.
- Added Vikunja settings tab and configuration.
@carlos-otero
feat: complete bidirectional vikunja subtask synchronization
50ae391 
- Implement two-pass pull sync to resolve subtask race conditions.
- Implement bidirectional mapping between Tasknotes projects and Vikunja parenttask relations.
- Add syncParentRelation method to handle Vikunja relations API.
- Switch from subtask to parenttask relation kind for correct hierarchy.
- Remove deprecated parent_task_id usage.
- Implement HTML<->Markdown description syncing.
- Implement bidirectional Tag/Label syncing.
@carlos-otero
refactor(settings): consolidate vikunja settings into unified card UI
cecad8d 
- Remove duplicate 'Vikunja Integration' settings section
- Create single card-based UI with master 'Enable Vikunja Sync' toggle
- Show connection settings (API URL, Token, List ID) always visible
- Show sync options (interval, triggers) only when sync is enabled
- Add dynamic status badge (Connected/Connection Error/Disabled)
- Add 'Sync Now' button only when enabled
- Follow same card design pattern as calendar integrations
@carlos-otero
docs: add vikunja sync documentation to README
1df9b24 
- Add Vikunja Sync section with setup instructions
- Document sync options (create/update/complete, two-way sync)
- Add field mapping table between TaskNotes and Vikunja
@carlos-otero carlos-otero changed the title Feature/vikunja sync: add bidirectional Vikunja task synchronization feat: add bidirectional Vikunja task synchronization Jan 11, 2026
@carlos-otero
Tasks created without a specified priority were being assigned priori…
ce24ac5 
…ty 2 (Medium)

in Vikunja. Now they correctly use priority 0 (Unset). Also added medium as an
alias for normal and improved handling of unset priorities when syncing from Vikunja.
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Reviewers

No reviews

Assignees

No one assigned

Labels

None yet

Projects

None yet

Milestone

No milestone

Development

Successfully merging this pull request may close these issues.

1 participant

@carlos-otero