Worklog : Local-first Desktop Project Manager

---

Worklog is a local-first desktop project manager for small development teams. It is designed for fast, keyboard-driven planning with a Kanban workflow, transparent local data, and no cloud dependency for core usage.

---

🎉 Latest Release — v1.3.0

Download v1.3.0 for your platform →

v1.3.0 is a stability-focused release that brings robust Linux rendering fixes and a refined update workflow. We've hardcoded environment overrides to prevent crashes on modern Wayland systems and streamlined how you receive new versions.

What shipped in v1.3.0

🐧 Native Linux Rendering Fixes Hardcoded WEBKIT_DISABLE_DMABUF_RENDERER=1 and GDK_BACKEND=x11 internally to solve the EGL_BAD_PARAMETER crashes and "grey screen" issues on modern rolling-release distributions like Arch Linux.

🛠️ Simplified Update Workflow Transitioned to a "Discovery & Manual Update" model. The app will still notify you of new versions, but will direct you to the releases page to ensure a clean, stable installation every time.

📦 New Linux Installer A native shell installer that extracts the AppImage and merges high-resolution icons directly into your desktop environment.

⚡ Database Lazy Loading Implemented infinite scroll and deferred rendering for the Kanban board. The application now uses paginated SQL queries and only renders tickets as you scroll, dramatically improving performance and memory usage for workspaces with hundreds of tickets.

Full changelog: https://github.com/regisx001/Worklog/compare/app-v1.2.0...app-v1.3.0

---

What Worklog Is

Worklog is built around a simple hierarchy:

Workspace -> Board -> Ticket

That structure keeps the app focused on one job: help a small team organize work without turning the product into a heavyweight project suite. The app is meant to feel instant, predictable, and easy to operate from the keyboard.

The concept is intentionally local-first:

• data stays on the machine that owns the workspace
• the app works offline
• the storage model remains transparent and portable
• every meaningful action is explicit

Product Direction

Worklog is not trying to be a cloud PM platform. The long-term idea is a desktop tool that stays small, fast, and honest about where data lives, while still covering the everyday planning flow a team actually needs.

The product direction centers on:

• board-based planning that stays easy to scan
• quick navigation and command-driven workflows
• lightweight collaboration through transparent local or project data
• Git-friendly, portable project state instead of vendor lock-in
• a clean path from personal planning to small-team coordination

Current Shape

The app already supports:

• workspace, board, and ticket management
• a Kanban board with Backlog, Todo, In Progress, and Done columns
• ticket details with inline editing and comments
• board and ticket context actions via right-click menus
• command palette and keyboard shortcuts
• workspace persistence with restore on startup
• background Git auto-sync with configurable intervals and pull-before-push strategy
• global application zoom (50 % – 200 %) with keyboard shortcuts and persistence
• Edit Board action from the sidebar context menu
• Hardcoded Linux rendering overrides for maximum stability
• Database lazy loading and infinite scroll for large datasets
• SQLite schema migration infrastructure for safe, lossless upgrades

Future Plans

The roadmap is intentionally gradual. The goal is to make Worklog more useful without breaking the core principles above.

Planned areas of growth include:

• stronger board organization tools, such as filters, saved views, and better prioritization
• richer ticket metadata, including more flexible fields for planning and handoff
• better search and navigation across workspaces, boards, and tickets
• more explicit project history and portable workspace snapshots
• improved backup, export, and restore workflows
• deeper Git-native workflows for teams that want work state to stay visible and auditable
• more keyboard shortcuts and faster bulk actions for power users
• continued UI polish, accessibility work, and responsiveness improvements

How It Works

Worklog uses a layered local architecture:

UI -> hooks -> repository layer -> SQLite

That keeps the app predictable and makes the persistence layer the source of truth for local data. Route and layout boundaries own workspace and board scope, while hooks handle the async work and repository calls.

Stack

• Desktop shell: Tauri v2
• Frontend: SvelteKit + TypeScript
• Runtime and package manager: Bun
• Persistence: SQLite via the Tauri SQL plugin
• Styling: semantic HTML, app shell styles, and compact desktop-oriented UI patterns

Project Structure

• src: SvelteKit frontend app
• src/lib/components/app: App feature components
• src/lib/hooks: Runes-based state and domain hooks
• src/lib/db: Repository and local database layer
• src-tauri: Rust and Tauri desktop runtime
• docs: Architecture and dataflow notes
• .github/workflows: CI and release pipelines

Local Data

Worklog stores app data inside the selected workspace path:

• .worklog/worklog.db

No cloud backend is required for normal operation.

Installation

Debian / Ubuntu

Worklog can be installed through the APT repository using a dedicated keyring file and the signed-by option, which is the recommended modern APT setup.[1][2]

sudo apt update
sudo apt install -y ca-certificates curl gnupg
sudo mkdir -p /usr/share/keyrings
curl -fsSL https://regisx001.github.io/worklog-apt/pubkey.asc \
  | sudo gpg --dearmor -o /usr/share/keyrings/worklog-archive-keyring.gpg

echo "deb [signed-by=/usr/share/keyrings/worklog-archive-keyring.gpg] https://regisx001.github.io/worklog-apt any main" \
  | sudo tee /etc/apt/sources.list.d/worklog.list

sudo apt update
sudo apt install worklog

If the repository is already configured, future updates can be installed with the normal system update flow using sudo apt update && sudo apt upgrade.[2][3]

Arch Linux / AUR

Worklog is also available from the Arch User Repository, where AUR packages are typically installed through helpers such as yay.[4][5]

yay -S worklog-bin

If yay is not installed yet, install it first and then use the command above to install worklog-bin from the AUR.[6][5]

AppImage (Wayland / Rolling Release Distros)

If you download the .AppImage release and experience an immediate crash with the error Could not create default EGL display: EGL_BAD_PARAMETER, this is a known issue caused by the bundled Ubuntu Wayland library conflicting with modern Wayland compositors (like on Arch Linux).

You can bypass this by forcing the AppImage to use your system's native Wayland library instead of the bundled one:

LD_PRELOAD=/usr/lib/libwayland-client.so ./worklog_x.x.x_amd64.AppImage

Alternatively, we strongly recommend using the .deb, .rpm, or AUR package for better system integration on Linux.

Getting Started

Install dependencies:

bun install --frozen-lockfile

Run the frontend during development:

bun run dev

Run the desktop app during development:

bun run tauri dev

Development Commands

Type and Svelte checks:

bun run check

Frontend build:

bun run build

Desktop build:

bun run tauri:build

Keyboard Shortcuts

• Ctrl/Cmd + K: open command palette
• Ctrl/Cmd + N: create ticket
• Ctrl/Cmd + B: open create board dialog
• Ctrl/Cmd + S: manual sync action
• Ctrl/Cmd + +: zoom in
• Ctrl/Cmd + -: zoom out
• Ctrl/Cmd + 0: reset zoom to 100 %
• M on a focused ticket: move it to the next status
• Escape: close the ticket detail panel

Prerequisites

• Bun
• Rust stable toolchain
• Tauri system dependencies for your OS

Linux dependencies used in CI:

sudo apt-get update
sudo apt-get install -y \
    build-essential \
    pkg-config \
    libgtk-3-dev \
    libwebkit2gtk-4.1-dev \
    libappindicator3-dev \
    librsvg2-dev \
    patchelf

CI And Releases

The CI workflow lives in ci.yml. It runs on pushes and pull requests when core source or build files change.

The publish workflow lives in release.yml. Releases are tag-driven and trigger when a tag matching app-v* is pushed.

Release Steps

1. Update version in package.json, src-tauri/Cargo.toml, and src-tauri/tauri.conf.json.
2. Commit and push the changes.
3. Create and push a release tag:

git tag -a app-v0.1.0 -m "Release app-v0.1.0"
git push origin app-v0.1.0

4. GitHub Actions builds and uploads artifacts for macOS, Linux, and Windows.
5. The workflow also produces AUR-ready artifacts.

Recommended IDE Setup

• VS Code
• Svelte extension
• Tauri extension
• rust-analyzer extension

License

MIT