Release Notes: Koge Kanban v3.0.1 (Stable)

Koge Kanban v3.0.1 is a major stability and optimization update. This version introduces critical database repairs, smarter AI connectivity via Ollama, and a modernized deployment workflow. Whether you're running locally or in a hybrid cloud environment, this update ensures a faster and more secure experience.

What's New in v3.0.1

Database & Reliability

• Dashboard Card Fix: Resolved the "looping card" bug by repairing the kv_store and trash_store schemas and primary keys.
• Data Deduplication: Implemented an automated database repair script to remove over 300+ redundant records, improving query speeds.
• Improved Isolation: Hardened the row-level data isolation logic to ensure user data remains private in multi-user environments.

AI Engine (Ollama)

• New Default Model: Switched to Qwen 2.5 3B for superior speed and accuracy in task generation.
• Smart Connectivity: Rewritten host resolution to support custom remote HTTPS endpoints and UI-side overrides.
• Safe Port Injection: Fixed a bug where default ports were incorrectly appended to external URLs; injection is now restricted to local network addresses.
• Optimization Tip: Recommended the use of models under 8B parameters for peak performance on consumer hardware.

Design & UI

• Solid Aesthetics: Replaced all legacy gradient backgrounds with a clean, professional Solid Blue brand palette.
• Refined UX: Improved transitions in the Task Modal and Summary Modal for a snappier feel.

Infrastructure & Docker

• Node.js 20 Upgrade: Modernized the environment by upgrading the base Docker image to node:20-alpine.
• Build Hardening: Added essential build tools (python3, make, g++) to the Dockerfile to ensure native modules like better-sqlite3 compile perfectly on all systems.
• Optimized Workspace: Updated .gitignore to better manage development dependencies and lock files.

Installation Guide

Follow these steps to set up Koge Kanban on your local machine:

1. Clone the Repository

git clone https://github.com/dezuhan/Koge-Kanban.git
cd Koge-Kanban

2. Install Dependencies

npm install

3. Configure Environment

Create your .env file and set a secure JWT_SECRET:

cp .env.example .env

4. Run the Application

npm run dev

The app will be available at http://localhost:5173.

Docker Deployment (Recommended)

For the easiest way to deploy and update:

Build and Run

# Build the production image
docker build -t koge-kanban .

# Start via Docker Compose
docker compose up -d

Hybrid Setup (No Code Download)

If you want to use the public frontend while keeping your data private on your own local server:

npm install express@4 better-sqlite3 cors dotenv helmet bcryptjs jsonwebtoken

1. Install Server Packages:
2. Download `server.js`: Grab only the latest server file from the repository.
3. Run Locally: Start your backend with node server.js.
4. Connect: Open [demo-koge-kanban.dezuhan.my.id](https://demo-koge-kanban.dezuhan.my.id), go to Settings > Database Configuration, and enter your local IP.

Version: 3.0.1

Developer: Dezuhan

License: MIT