# kaneo | kaneo.app | Knowledge Base | Instagit

🎯 All you need. Nothing you don't. Open source project management that works for you, not against you.

GitHub Stars: 5.7k

Repository: https://github.com/usekaneo/kaneo

---

## Articles

### [How Kaneo Handles Environment Variables for Configuration: A Complete Guide to dotenv-mono](/usekaneo/kaneo/how-does-kaneo-handle-environment-variables-for-configuration)

Learn how Kaneo centralizes configuration using dotenv-mono to load environment variables and expose strongly-typed settings. Master runtime configuration for your applications.

- Tags: how-to-guide
- Published: 2026-08-30

### [How AI Tools Can Interact with Kaneo Programmatically: Complete TypeScript Client Guide](/usekaneo/kaneo/how-can-ai-tools-interact-with-kaneo-programmatically)

Learn how AI tools can interact with Kaneo programmatically using the type-safe TypeScript client from @kaneo/libs. Automate Kaneo operations seamlessly with Hono's RPC generator.

- Tags: how-to-guide
- Published: 2026-08-30

### [What Is the Purpose of the MCP Server in Kaneo?](/usekaneo/kaneo/what-is-the-purpose-of-mcp-server-in-kaneo)

Discover the MCP server's purpose in Kaneo. It securely bridges AI clients with Kaneo's API, translating natural language into authenticated API calls and respecting workspace permissions.

- Tags: internals
- Published: 2026-08-30

### [How the Typed API Client Library Is Generated for Kaneo: OpenAPI to TypeScript Pipeline](/usekaneo/kaneo/how-is-typed-api-client-library-generated-for-kaneo)

Discover how Kaneo automatically generates its typed API client library from OpenAPI specs using openapi-typescript and Hono for compile-time type safety.

- Tags: internals
- Published: 2026-08-30

### [What Types of Background Jobs Does Kaneo Run? Complete Scheduler Architecture Guide](/usekaneo/kaneo/what-types-of-background-jobs-does-kaneo-run)

Discover Kaneo background jobs like trial reminders and health checks. Explore its scheduler architecture with croner and PostgreSQL leader-lock for reliable execution.

- Tags: architecture
- Published: 2026-08-30

### [How Kaneo Handles Scheduled Jobs: Distributed Cron Architecture Explained](/usekaneo/kaneo/how-are-scheduled-jobs-handled-in-kaneo)

Discover how Kaneo manages scheduled jobs with a distributed cron architecture. Learn about its PostgreSQL-based distributed locks and Sentry cron monitoring for reliable, exactly-once execution.

- Tags: internals
- Published: 2026-08-30

### [How to Configure Kaneo Integrations for GitHub and Slack](/usekaneo/kaneo/how-to-configure-kaneo-integrations-like-github-or-slack)

Learn how to configure Kaneo integrations with GitHub and Slack. Discover Kaneo's layered architecture for seamless external service connections and data management.

- Tags: how-to-guide
- Published: 2026-08-30

### [External Services Kaneo Can Integrate With: Complete Plugin Architecture Guide](/usekaneo/kaneo/which-external-services-can-kaneo-integrate-with)

Explore Kaneo's external service integrations including Slack Discord Telegram GitHub Gitea and webhooks. Learn about its modular plugin architecture and RESTful endpoints for seamless connection.

- Tags: architecture
- Published: 2026-08-30

### [How the Kaneo Plugin Architecture Works: A Technical Deep Dive](/usekaneo/kaneo/how-does-kaneo-plugin-architecture-work)

Explore Kaneo's plugin architecture. Learn how its registry system discovers, stores, and dispatches integration plugins using type-safe event handlers and webhooks.

- Tags: deep-dive
- Published: 2026-08-30

### [Kaneo WebSocket Broadcasting Adapters: In-Memory and Redis Implementation Guide](/usekaneo/kaneo/what-are-the-different-kaneo-websocket-broadcasting-adapters)

Explore Kaneo WebSocket broadcasting adapters. Learn about the InMemoryBroadcastAdapter for single instances and the RedisBroadcastAdapter for distributed systems. Enhance real-time event distribution.

- Tags: how-to-guide
- Published: 2026-08-30

### [How to Scale Kaneo's WebSocket Broadcasting Horizontally](/usekaneo/kaneo/how-to-scale-kaneo-websocket-broadcasting-horizontally)

Scale Kaneo's WebSocket broadcasting horizontally by configuring RedisBroadcastAdapter with Redis URL. Synchronize real-time events across multiple API instances using Redis Pub/Sub for enhanced performance.

- Tags: performance
- Published: 2026-08-30

### [How Kaneo Uses WebSockets for Real-Time Task Updates and Notifications](/usekaneo/kaneo/how-are-websockets-used-in-kaneo-for-real-time-features)

Discover how Kaneo leverages WebSockets for instant task updates and notifications. Learn about its pluggable BroadcastAdapter for scalable real-time features.

- Tags: how-to-guide
- Published: 2026-08-30

### [How Kaneo Implements Real-Time Updates: Event-Driven WebSocket Architecture](/usekaneo/kaneo/how-does-kaneo-implement-real-time-updates)

Discover how Kaneo implements real-time updates with its event-driven WebSocket architecture. Learn about pluggable broadcast adapters for in-memory and Redis messaging.

- Tags: internals
- Published: 2026-08-30

### [Built-in Roles in Kaneo’s Permission System: Viewer, Member, and Admin Explained](/usekaneo/kaneo/what-are-built-in-roles-in-kaneo-permission-system)

Understand Kaneo's built-in roles viewer member and admin Explore how these core permissions function within the Kaneo permission system and manage access effectively

- Tags: deep-dive
- Published: 2026-08-30

### [How to Configure Custom Workspace Roles in Kaneo: A Complete RBAC Guide](/usekaneo/kaneo/how-to-configure-custom-workspace-roles-in-kaneo)

Master Kaneo's RBAC system to configure custom workspace roles. Learn how to define granular access controls using its three-layer permission system for enhanced security.

- Tags: how-to-guide
- Published: 2026-08-30

### [How Kaneo Manages User Roles and Permissions: A Technical Deep Dive into the RBAC System](/usekaneo/kaneo/how-does-kaneo-manage-user-roles-and-permissions)

Explore Kaneo's RBAC system: understand how it manages user roles and permissions with built-in and custom roles enforced via API middleware. Dive into the technical details of better-auth.

- Tags: deep-dive
- Published: 2026-08-30

### [Kaneo Database Schema: Complete Guide to Core Tables and Relationships](/usekaneo/kaneo/what-are-the-main-tables-in-kaneo-database-schema)

Explore the Kaneo database schema with its 16 core PostgreSQL tables focused on workspaces, projects, and tasks. Understand key relationships and data structure.

- Tags: api-reference
- Published: 2026-08-30

### [How the Kaneo Database Schema Is Defined: A Complete Guide to the Drizzle ORM Implementation](/usekaneo/kaneo/how-is-kaneo-database-schema-defined)

Discover how the Kaneo database schema is defined using Drizzle ORM. Learn about pgTable declarations, CUID-2 primary keys, and relationship mappings in this complete guide.

- Tags: internals
- Published: 2026-08-30

### [How Kaneo Handles Authentication and Authorization: A Complete Technical Guide](/usekaneo/kaneo/how-does-kaneo-handle-authentication-and-authorization)

Discover how Kaneo handles authentication and authorization with its multi-method system and workspace-scoped RBAC for secure, granular access control. Explore the technical guide.

- Tags: deep-dive
- Published: 2026-08-30

### [What Framework Powers the Kaneo API Backend? Hono and OpenAPI Integration Explained](/usekaneo/kaneo/what-framework-is-used-for-kaneo-api-backend)

Discover the Hono framework powering the Kaneo API backend. Learn how Hono and OpenAPI integration ensure type-safe routing and validation for robust API development.

- Tags: deep-dive
- Published: 2026-08-30

### [How to Access the Kaneo API OpenAPI Documentation](/usekaneo/kaneo/how-to-access-kaneo-api-openapi-documentation)

Access Kaneo API OpenAPI documentation easily. Learn how to find the live OpenAPI 3.1 specification endpoint for your integration needs.

- Tags: api-reference
- Published: 2026-08-30

### [What Is the Default Port for the Kaneo API?](/usekaneo/kaneo/what-is-the-default-port-for-kaneo-api)

Discover the default Kaneo API port. Kaneo API uses port 1337 when no custom URL is set. Learn more about Kaneo configuration.

- Tags: api-reference
- Published: 2026-08-30

### [How to Set Up the Kaneo API Locally: Complete Development Guide](/usekaneo/kaneo/how-to-set-up-kaneo-api-locally)

Easily set up the Kaneo API locally with Node.js, pnpm, and PostgreSQL. Follow our complete guide to configure your environment and run the Hono-based API in minutes.

- Tags: how-to-guide
- Published: 2026-08-30

### [What Is the Purpose of the MCP Server Package in Kaneo?](/usekaneo/kaneo/what-is-the-purpose-of-the-mcp-server-package-in-kaneo)

Discover the purpose of the MCP server package in Kaneo. Learn how it exposes Kaneo's functionality as reusable tools accessible via HTTP for external clients.

- Tags: internals
- Published: 2026-08-29

### [How External Services Can Integrate with Kaneo Using Generic Webhooks](/usekaneo/kaneo/how-can-external-services-integrate-with-kaneo-using-generic-webhooks)

Integrate external services with Kaneo using generic webhooks. Send real-time task event data to your endpoint via HTTP POST payloads for seamless integration.

- Tags: how-to-guide
- Published: 2026-08-29

### [What Is the Webhook Endpoint for GitHub Integration in Kaneo?](/usekaneo/kaneo/what-is-the-webhook-endpoint-for-github-integration)

Discover the Kaneo webhook endpoint for GitHub integration: POST /github/webhook. Learn how it handles GitHub App events efficiently for seamless development workflows.

- Tags: how-to-guide
- Published: 2026-08-29

### [How the GitHub Integration Works in Kaneo: A Complete Technical Breakdown](/usekaneo/kaneo/how-does-the-github-integration-work-in-kaneo)

Explore the technical details of Kaneo's GitHub integration. Learn how Octokit clients, JSON metadata, and type-safe endpoints ensure seamless repository connection and permission validation.

- Tags: deep-dive
- Published: 2026-08-29

### [How Redis Enables Horizontal Scaling in Kaneo's Real-Time Architecture](/usekaneo/kaneo/what-is-the-role-of-redis-in-kaneos-real-time-architecture)

Discover how Redis powers horizontal scaling in Kaneo's real-time architecture by acting as the Pub/Sub message bus for WebSocket event synchronization across API instances.

- Tags: architecture
- Published: 2026-08-29

### [How Kaneo Handles Real-Time Event Broadcasting: Architecture and Implementation](/usekaneo/kaneo/how-does-kaneo-handle-real-time-event-broadcasting)

Explore Kaneo's real-time event broadcasting architecture. Discover how its lightweight event-bus and pluggable adapters enable efficient WebSocket communication for single or multi-instance deployments.

- Tags: architecture
- Published: 2026-08-29

### [WebSocket Endpoints for Real-Time Updates in Kaneo](/usekaneo/kaneo/what-are-the-websocket-endpoints-for-real-time-updates-in-kaneo)

Discover Kaneo's WebSocket endpoints for real-time updates: /ws/user for user events and /ws/:projectId for project updates. Enhance your application with instant data.

- Tags: api-reference
- Published: 2026-08-29

### [How Permissions Are Defined and Managed in Kaneo: A Complete Technical Guide](/usekaneo/kaneo/how-are-permissions-defined-and-managed-in-kaneo)

Discover how Kaneo defines and manages permissions using a declarative access control system and a centralized permission map. Explore role definitions and middleware enforcement.

- Tags: deep-dive
- Published: 2026-08-29

### [Built-in Roles in Kaneo: Viewer, Member, Admin, and Owner Permissions Explained](/usekaneo/kaneo/what-are-the-built-in-roles-in-kaneo-and-their-capabilities)

Understand Kaneo's built-in roles Viewer Member Admin and Owner Explore their distinct permissions from read-only access to full workspace control and deletion capabilities.

- Tags: deep-dive
- Published: 2026-08-29

### [How Kaneo Uses Database Indexes for High-Performance PostgreSQL Operations](/usekaneo/kaneo/how-are-indexes-used-for-performance-in-the-kaneo-database)

Discover how Kaneo employs B-tree indexes on foreign keys and composite columns for sub-millisecond PostgreSQL query performance, even with thousands of records.

- Tags: performance
- Published: 2026-08-29

### [What Are the Main Tables for Project and Task Management in Kaneo?](/usekaneo/kaneo/what-are-the-main-tables-for-project-and-task-management-in-kaneo)

Explore the eight core PostgreSQL tables Kaneo uses for project and task management, including project, column, task, and activity tables. Understand your data structure.

- Tags: internals
- Published: 2026-08-29

### [How Does Kaneo Manage User and Workspace Relationships? A Technical Deep Dive into Roles and Permissions](/usekaneo/kaneo/how-does-kaneo-manage-user-and-workspace-relationships)

Discover how Kaneo manages user and workspace relationships with its Drizzle-ORM schema. Learn about role-based permissions and invitation flows in this technical deep dive.

- Tags: deep-dive
- Published: 2026-08-29

### [Kaneo Database Schema: A Complete Guide to Key Entities and Relationships](/usekaneo/kaneo/what-are-the-key-entities-in-the-kaneo-database-schema)

Explore the Kaneo database schema, detailing 25+ PostgreSQL tables for Workspaces, Projects, Tasks, Members, and Billing. Understand key entities and relationships for efficient data management.

- Tags: deep-dive
- Published: 2026-08-29

### [Kaneo API Request Lifecycle: From HTTP Request to Real-Time Broadcast](/usekaneo/kaneo/what-is-the-request-lifecycle-for-an-api-call-in-kaneo)

Explore the Kaneo API request lifecycle. See how it handles HTTP requests through Hono, OpenAPI, Zod, Drizzle, and WebSockets for a typed JSON response.

- Tags: internals
- Published: 2026-08-29

### [How Kaneo’s Authentication Middleware Works: A Deep Dive into API Security](/usekaneo/kaneo/how-does-the-authentication-middleware-work-in-kaneo)

Discover how Kaneo's authentication middleware secures your API. Learn its approach to handling API keys, Bearer tokens, and cookies for a unified security layer. Explore the code.

- Tags: deep-dive
- Published: 2026-08-29

### [Kaneo API Authentication Methods: 5 Ways to Secure API Requests](/usekaneo/kaneo/what-are-the-different-api-authentication-methods-supported-by-kaneo)

Discover Kaneo API authentication methods. Explore session-cookie, Bearer token, API key, device authorization, and OAuth 2.0 for secure API requests.

- Tags: api-reference
- Published: 2026-08-29

### [How API Routes Are Organized in Kaneo: A Modular Hono Architecture](/usekaneo/kaneo/how-are-api-routes-organized-in-kaneo)

Discover how Kaneo organizes its API routes using a modular Hono architecture. Learn about feature-based modules, automatic OpenAPI docs, and a flat URL hierarchy for efficient development.

- Tags: architecture
- Published: 2026-08-29

### [What Is the Purpose of `packages/permissions` in Kaneo? A Deep Dive into the Authorization Layer](/usekaneo/kaneo/what-is-the-purpose-of-the-packages-permissions-in-kaneo)

Explore the purpose of packages/permissions in Kaneo. Understand how this module defines the permission vocabulary and role hierarchy for Kaneo's authorization layer.

- Tags: deep-dive
- Published: 2026-08-29

### [Kaneo Monorepo Structure Explained: Apps, Packages, and Shared Libraries](/usekaneo/kaneo/explain-the-monorepo-structure-of-kaneo)

Explore the Kaneo monorepo structure. Learn how apps, packages, and shared libraries are organized in TypeScript for clean separation and efficient development.

- Tags: internals
- Published: 2026-08-29

### [How the Kaneo Frontend Is Built: Complete Tech Stack and Build Pipeline Explained](/usekaneo/kaneo/how-is-the-kaneo-frontend-built-and-what-libraries-does-it-use)

Explore the Kaneo frontend tech stack React Vite TanStack Router Tailwind CSS Radix UI and Base UI Discover the complete build pipeline for this modern web application.

- Tags: internals
- Published: 2026-08-29

### [What Database Does Kaneo Use and How Is It Accessed?](/usekaneo/kaneo/what-database-is-used-by-kaneo-and-how-is-it-accessed)

Discover Kaneo's PostgreSQL database and learn how its connection string is dynamically accessed using environment variables. Get the details here.

- Tags: internals
- Published: 2026-08-29

### [How Kaneo Handles API Authentication: Better Auth Implementation Explained](/usekaneo/kaneo/how-does-kaneo-handle-api-authentication)

Discover how Kaneo handles API authentication using Better Auth. Learn about global middleware for Bearer tokens and API keys with the x-api-key header.

- Tags: deep-dive
- Published: 2026-08-29

### [Kaneo Backend Technology Stack: Node.js, TypeScript, Hono, and Drizzle ORM Explained](/usekaneo/kaneo/what-is-the-core-technology-stack-for-kaneo-backend)

Discover the Kaneo backend technology stack: Node.js, TypeScript, Hono, and Drizzle ORM. Learn how these tools power efficient and scalable applications. Get the details now!

- Tags: internals
- Published: 2026-08-29

### [How to Set Up Kaneo Locally for Development: Complete Setup Guide](/usekaneo/kaneo/how-to-set-up-kaneo-locally-for-development)

Learn how to set up Kaneo locally for development. Clone the repo, install dependencies, configure .env, and start the API and web app with hot-reload.

- Tags: how-to-guide
- Published: 2026-08-29

### [How Kaneo's Time Tracking Feature Records and Calculates Entries](/usekaneo/kaneo/how-does-the-time-tracking-feature-record-and-calculate-entries)

Discover how Kaneo's time tracking feature records work intervals using startTime endTime and duration. Learn how it calculates total time by summing cached duration values on the client for precise tracking.

- Tags: how-to-guide
- Published: 2026-08-11

### [How Kaneo's Authentication System Works with Better Auth and API Keys](/usekaneo/kaneo/how-does-kaneos-authentication-system-work-with-better-auth-and-api-keys)

Discover how Kaneo's authentication system leverages Better Auth for robust security. Explore support for email, OAuth, magic links, bearer tokens, and API keys.

- Tags: deep-dive
- Published: 2026-08-11

### [How External Libraries Are Managed in Kaneo: A Complete Guide to PNPM Workspaces and Monorepo Dependency Control](/usekaneo/kaneo/how-are-external-libraries-managed-in-kaneo)

Discover how Kaneo manages external libraries with PNPM workspaces in its monorepo. Learn about tiered dependency control for root tooling, app runtime needs, and shared internal packages.

- Tags: how-to-guide
- Published: 2026-08-10

### [Kaneo CI/CD Pipelines Explained: GitHub Actions, Docker & Helm Workflows](/usekaneo/kaneo/what-are-the-ci-cd-pipelines-for-kaneo)

Discover Kaneo CI/CD pipelines powered by GitHub Actions. Automate linting, testing, Docker builds, and Helm deployments with three core workflow files.

- Tags: how-to-guide
- Published: 2026-08-10

### [What Dockerfiles Are Included in Kaneo: Complete Container Setup Guide](/usekaneo/kaneo/are-there-any-dockerfiles-included-for-kaneo)

Discover the Dockerfiles in the Kaneo monorepo for full containerization. Learn about setup for backend, frontend, and infrastructure.

- Tags: how-to-guide
- Published: 2026-08-10

### [How to Deploy Kaneo to Production: A Complete Docker-Based Guide](/usekaneo/kaneo/how-to-deploy-kaneo-to-production)

Deploy Kaneo to production using Docker and compose.yml. This guide covers building the multi-stage Docker image for Hono API, React frontend, and Nginx for a production-ready container.

- Tags: how-to-guide
- Published: 2026-08-10

### [How State Is Managed in the Kaneo Application: Zustand and React Query Architecture](/usekaneo/kaneo/how-is-state-managed-in-the-kaneo-application)

Discover how Kaneo manages state using Zustand for UI and React Query for server data. Learn about this efficient architecture for seamless application development.

- Tags: architecture
- Published: 2026-08-10

### [How to Debug Issues in Kaneo: Complete Troubleshooting Guide for the Self-Hosted Platform](/usekaneo/kaneo/how-to-debug-issues-in-kaneo)

Debug Kaneo issues effectively. Troubleshoot .env configuration, browser CORS errors, Hono backend exceptions, and WebSocket adapter logs with this comprehensive guide.

- Tags: how-to-guide
- Published: 2026-08-10

### [How Kaneo Handles Configuration: Environment Variables and Type-Safe Settings](/usekaneo/kaneo/how-does-kaneo-handle-configuration)

Discover how Kaneo centralizes runtime configuration with type-safe getSettings(). Load environment variables, validate security, and get defaults for local dev.

- Tags: how-to-guide
- Published: 2026-08-10

### [Purpose of the src Directory in Kaneo: Monorepo Source Code Architecture Explained](/usekaneo/kaneo/what-is-the-purpose-of-the-src-directory-in-kaneo)

Discover the purpose of the src directory in Kaneo's monorepo. Learn how it centralizes all backend API, React frontend, and shared package source code before production compilation.

- Tags: internals
- Published: 2026-08-10

### [How to Run Tests in the Kaneo Repository: A Complete Guide](/usekaneo/kaneo/how-to-run-tests-in-the-kaneo-repository)

Learn how to run tests in the Kaneo repository easily. This guide covers unit and integration tests using pnpm and TurboRepo, ensuring a smooth development workflow. Get started now!

- Tags: how-to-guide
- Published: 2026-08-10

### [How to Build the Kaneo Project from Source: A Complete Developer Guide](/usekaneo/kaneo/how-to-build-the-kaneo-project-from-source)

Learn to build the Kaneo project from source with this developer guide. Clone the repo, install dependencies, configure .env, and run pnpm dev to start the API and web client.

- Tags: how-to-guide
- Published: 2026-08-10

### [Kaneo Coding Standards: Formatting, TypeScript, and Git Conventions Explained](/usekaneo/kaneo/what-are-the-coding-standards-for-kaneo)

Discover Kaneo coding standards: Biome formatting, TypeScript import ordering, Conventional Commits, and pre-commit hooks for seamless development. Learn how we maintain code quality.

- Tags: best-practices
- Published: 2026-08-10

### [How to Contribute to the Kaneo Project: A Complete Developer Guide](/usekaneo/kaneo/how-to-contribute-to-the-kaneo-project)

Learn how to contribute to the Kaneo project. Fork the repo, install dependencies, set up env vars, branch, and submit a PR. Your guide to open source development.

- Tags: how-to-guide
- Published: 2026-08-10

### [Where Is the Main Entry Point for the Kaneo Application? A Complete Guide to the Monorepo Structure](/usekaneo/kaneo/where-can-i-find-the-main-entry-point-for-the-kaneo-application)

Discover the main entry points for the Kaneo application within its monorepo structure. Find the API server at apps/api/src/index.ts and the web client at apps/web/src/main.tsx.

- Tags: how-to-guide
- Published: 2026-08-10

### [Kaneo Project Structure Explained: A Deep Dive into the Monorepo Architecture](/usekaneo/kaneo/how-is-the-kaneo-project-structured)

Explore the Kaneo project structure, a pnpm monorepo with TurboRepo. Learn how apps, packages, and charts organize the usekaneo/kaneo repository for efficient development.

- Tags: deep-dive
- Published: 2026-08-10

### [How to Run Kaneo Locally for Testing: Complete Setup Guide](/usekaneo/kaneo/how-to-run-kaneo-locally-for-testing)

Learn how to run Kaneo locally for testing with this complete setup guide. Follow simple steps to configure environment variables and launch the application using Docker Compose or pnpm.

- Tags: how-to-guide
- Published: 2026-08-10

### [Core Dependencies for the Kaneo Project: Monorepo Stack Breakdown](/usekaneo/kaneo/what-are-the-core-dependencies-for-kaneo-project)

Explore the core dependencies of the Kaneo project a TypeScript monorepo stack featuring Hono Drizzle ORM React TanStack and internal shared packages. Discover the technologies powering Kaneo.

- Tags: architecture
- Published: 2026-08-10

### [Where to Find Documentation for Kaneo: Complete Repository Guide](/usekaneo/kaneo/where-to-find-kaneo-documentation)

Find complete documentation for Kaneo in the usekaneo/kaneo repository within the apps/docs directory. Explore Core Guides, API Reference, and deployment instructions at kaneo.app/docs/core.

- Tags: getting-started
- Published: 2026-08-09

### [How to Add a New Feature to the Kaneo Monorepo: A Complete Development Guide](/usekaneo/kaneo/how-to-add-new-feature-kaneo-monorepo)

Learn how to add a new feature to the Kaneo monorepo. This guide covers database schema updates, controller creation, Hono route exposure, and TanStack Query hook implementation for seamless integration.

- Tags: how-to-guide
- Published: 2026-08-09

### [Development Workflow for Kaneo: A Complete Guide to Contributing](/usekaneo/kaneo/kaneo-development-workflow)

Understand the Kaneo development workflow in this guide. Learn to set up dependencies, configure .env, and run pnpm dev to start the API and web client with hot reloading.

- Tags: how-to-guide
- Published: 2026-08-09

### [How to Configure Environment Variables for Kaneo: Complete Setup Guide](/usekaneo/kaneo/how-to-configure-environment-variables-kaneo)

Learn how to configure environment variables for Kaneo. This guide details setup using the .env file for API server and web frontend in the usekaneo/kaneo repository.

- Tags: how-to-guide
- Published: 2026-08-09

### [Kaneo API Database Schema: Complete Drizzle ORM Reference for PostgreSQL](/usekaneo/kaneo/kaneo-api-database-schema)

Explore the Kaneo API database schema using Drizzle ORM and PostgreSQL. Discover over 30 tables for authentication, projects, time tracking, and integrations. See the full reference.

- Tags: api-reference
- Published: 2026-08-09

### [Contribution Guide for Kaneo Developers: From Setup to Pull Request](/usekaneo/kaneo/kaneo-developer-contribution-guide)

Kaneo contribution guide: setup Node 18+, pnpm, Git. Fork, install dependencies, configure env, and submit pull requests following Biome linting and Conventional Commits.

- Tags: how-to-guide
- Published: 2026-08-09

### [How to Build the Kaneo Project from Source: Complete Guide](/usekaneo/kaneo/how-to-build-kaneo-project-source)

Learn to build the Kaneo project from source. Follow our step by step guide to clone the repository, install dependencies, set up environment variables, and run the development servers for Kaneo.

- Tags: how-to-guide
- Published: 2026-08-09

### [Dependencies for the Kaneo Project: Complete Monorepo Breakdown](/usekaneo/kaneo/kaneo-project-dependencies)

Explore the complete dependencies for the Kaneo project a pnpm monorepo. Discover how to install all necessary packages with a single command. Learn about the root workspace API server React frontend and shared packages.

- Tags: deep-dive
- Published: 2026-08-09

### [How the Kaneo Web App Interacts with the Kaneo API: Architecture Deep Dive](/usekaneo/kaneo/kaneo-web-app-api-interaction)

Explore the Kaneo web app's architecture. Learn how it interacts with the Kaneo API using a type-safe Hono client, OpenAPI, WebSocket, and TanStack Query for efficient data management and real-time updates.

- Tags: architecture
- Published: 2026-08-09

### [Main Features of the Kaneo Web Application: A Complete Feature Guide](/usekaneo/kaneo/kaneo-web-app-main-features)

Discover the main features of the Kaneo web application. Explore multi-workspace collaboration, Kanban boards, Gantt charts, real-time updates, and AI integrations in this comprehensive guide.

- Tags: getting-started
- Published: 2026-08-09

### [How to Run Kaneo Web App Tests: Complete Vitest and jsdom Guide](/usekaneo/kaneo/how-to-run-kaneo-web-app-tests)

Learn how to run Kaneo web app tests easily. This guide covers Vitest and jsdom, providing clear commands for efficient testing within the usekaneo/kaneo repository.

- Tags: how-to-guide
- Published: 2026-08-09

### [How to Set Up the Kaneo Web Application Locally: Complete Development Guide](/usekaneo/kaneo/how-to-setup-kaneo-web-app-locally)

Set up the Kaneo web application locally with this guide. Clone the usekaneo kaneo repo, install pnpm dependencies, configure env variables, and run pnpm dev to start.

- Tags: how-to-guide
- Published: 2026-08-09

### [What Frontend Framework Does Kaneo Use? React 19 Architecture Explained](/usekaneo/kaneo/kaneo-web-app-frontend-framework)

Discover the frontend framework powering the Kaneo web app. Learn how Kaneo leverages React 19 architecture with modern APIs for a robust and efficient user experience.

- Tags: deep-dive
- Published: 2026-08-09

### [Kaneo Web Application Monorepo Structure: A Complete Architecture Guide](/usekaneo/kaneo/kaneo-web-app-structure-monorepo)

Explore the Kaneo web application monorepo structure at usekaneo/kaneo. Learn its feature-oriented architecture, file-based routing with TanStack Router, Zustand state management, and layered components with Tailwind CSS.

- Tags: architecture
- Published: 2026-08-09

### [Complete Guide to API Endpoints in Kaneo: REST, WebSockets, and Integrations](/usekaneo/kaneo/kaneo-api-endpoints)

Explore Kaneo API endpoints, including REST APIs under /api for projects, tasks, and integrations, plus real-time WebSockets. Seamlessly integrate your tools.

- Tags: api-reference
- Published: 2026-08-09

### [How to Run Kaneo API Tests: Unit and Integration Guide](/usekaneo/kaneo/how-to-run-kaneo-api-tests)

Learn to run Kaneo API tests efficiently. Execute Vitest unit tests with pnpm test or integration tests with pnpm test:integration for comprehensive API validation.

- Tags: how-to-guide
- Published: 2026-08-09

### [How to Set Up the Kaneo API Locally: Complete Development Guide](/usekaneo/kaneo/how-to-setup-kaneo-api-locally)

Learn how to set up the Kaneo API locally with this developer guide. Clone the repository, configure environment variables, and run pnpm dev to launch the Hono API on port 1337.

- Tags: how-to-guide
- Published: 2026-08-09

### [Kaneo API Technology Stack: Core Backend Technologies Explained](/usekaneo/kaneo/kaneo-api-technologies)

Explore the Kaneo API technology stack, featuring Hono, PostgreSQL with Drizzle ORM, Better-Auth, and Valibot for efficient and type-safe backend development. Learn about our core technologies.

- Tags: internals
- Published: 2026-08-09

### [How the Kaneo API Is Structured Within the Monorepo: A Layered Hono Architecture](/usekaneo/kaneo/kaneo-api-structure-monorepo)

Discover the layered Hono architecture of the Kaneo API within its monorepo. Explore modular design, hierarchical routing, and Drizzle ORM integration for efficient development.

- Tags: architecture
- Published: 2026-08-09

### [What Are the Main Packages Within the Kaneo Monorepo?](/usekaneo/kaneo/kaneo-monorepo-main-packages)

Explore the main packages within the usekaneo kaneo monorepo: @kaneo/libs, @kaneo/email, @kaneo/mcp, @kaneo/permissions, and @kaneo/typescript-config. Discover shared utilities and configurations.

- Tags: internals
- Published: 2026-08-09

### [How to Navigate the Kaneo Monorepo Structure: A Complete Guide](/usekaneo/kaneo/how-to-navigate-kaneo-monorepo)

Master the kaneo monorepo structure with this guide. Learn to navigate apps, packages, and charts for efficient development and deployment in the usekaneo/kaneo repository.

- Tags: how-to-guide
- Published: 2026-08-09

### [What Is a Monorepo and How Is It Structured in Kaneo?](/usekaneo/kaneo/what-is-monorepo-kaneo-structure)

Learn what a monorepo is and how Kaneo structures it. Discover its pnpm workspace with TurboRepo, organizing code into apps packages and charts directories.

- Tags: deep-dive
- Published: 2026-08-09

### [What Is the Roadmap for Kaneo? A Developer's Guide to the Live Feature Timeline](/usekaneo/kaneo/roadmap-for-kaneo)

Explore the live Kaneo roadmap for developers. Discover upcoming features and enhancements on the official Kaneo roadmap page, keeping you updated with the latest project progress.

- Tags: roadmap
- Published: 2026-08-08

### [How to Manage Kaneo's Configuration Files: Complete Environment Setup Guide](/usekaneo/kaneo/how-to-manage-kaneo-configuration-files)

Master Kaneo's configuration files with this guide. Learn how Kaneo centralizes settings in .env files for seamless environment setup and Docker integration.

- Tags: how-to-guide
- Published: 2026-08-08

### [Performance Considerations for Kaneo: Optimizing Your Self-Hosted Project Management Platform](/usekaneo/kaneo/performance-considerations-for-kaneo)

Optimize your self-hosted Kaneo project management platform with performance insights. Learn how lightweight architecture, Drizzle ORM, Redis, and S3 enhance speed.

- Tags: performance
- Published: 2026-08-08

### [How to Handle Errors in Kaneo: Backend and Frontend Error Management Patterns](/usekaneo/kaneo/how-to-handle-errors-in-kaneo)

Master error handling in Kaneo with our guide to backend HTTPExceptions and frontend ApiError types. Learn effective error management patterns for robust applications.

- Tags: best-practices
- Published: 2026-08-08

### [CI/CD Pipeline for Kaneo: GitHub Actions, pnpm, and Monorepo Testing Explained](/usekaneo/kaneo/kaneo-ci-cd-pipeline)

Discover the CI/CD pipeline for Kaneo, detailing GitHub Actions, pnpm, and monorepo testing. Learn how Kaneo automates linting, type checking, unit, build, and integration tests with Docker and Helm chart releases.

- Tags: how-to-guide
- Published: 2026-08-08

### [How to Use the Kaneo Command-Line Interface (CLI): Commands, Options, and Examples](/usekaneo/kaneo/how-to-use-kaneo-command-line-interface)

Master the Kaneo CLI with our guide. Learn essential commands, options, and real-world examples for efficient MCP server management. Install, serve, and get help with ease.

- Tags: how-to-guide
- Published: 2026-08-08

### [Key Architectural Patterns Used in Kaneo: A Deep Dive into the Codebase](/usekaneo/kaneo/key-architectural-patterns-used-in-kaneo)

Explore Kaneo's feature-based modular architecture, TanStack Query for state, and event-driven system. Understand its codebase's key architectural patterns.

- Tags: architecture
- Published: 2026-08-08

### [Kaneo Repository License: MIT Terms and Usage Guidelines](/usekaneo/kaneo/licensing-for-kaneo-repository)

Understand the Kaneo Repository License. Explore MIT license terms and usage guidelines for this permissive open-source project, allowing free use, modification, and redistribution.

- Tags: license
- Published: 2026-08-08

### [How to Debug Issues in the Kaneo Project: A Complete Troubleshooting Guide](/usekaneo/kaneo/how-to-debug-issues-in-kaneo-project)

Debug Kaneo project issues by verifying .env config, tracing HTTP exceptions in API source, and checking WebSocket logs. Your complete troubleshooting guide for the usekaneo/kaneo repo.

- Tags: how-to-guide
- Published: 2026-08-08

### [Security Considerations for Kaneo: Authentication Architecture and Access Controls](/usekaneo/kaneo/security-considerations-for-kaneo)

Discover Kaneo's robust security. Learn about its defense-in-depth model featuring strong authentication, adaptive cookies, rate limiting, and PostgreSQL locks to protect your system.

- Tags: security
- Published: 2026-08-08

### [How to Integrate Kaneo with Other Services: MCP SDK, GitHub Plugin, and API Guide](/usekaneo/kaneo/how-to-integrate-kaneo-with-other-services)

Integrate Kaneo seamlessly with other services using the MCP SDK, GitHub plugin, and API. Automate workflows, sync data, and trigger actions via TypeScript clients, webhooks, or CLI tools. Learn how.

- Tags: how-to-guide
- Published: 2026-08-08

### [Best Practices for Developing with Kaneo: A Complete Guide to the Monorepo Architecture](/usekaneo/kaneo/best-practices-for-developing-with-kaneo)

Master Kaneo development with these best practices. Learn to leverage its monorepo, TurboRepo, Hono routes, Valibot validation, and controller pattern for efficient, maintainable code.

- Tags: best-practices
- Published: 2026-08-08

### [Kaneo API Endpoints: Complete REST API Reference for Project Management](/usekaneo/kaneo/api-endpoints-available-in-kaneo)

Explore Kaneo API endpoints for seamless project management. Access a complete REST API reference for projects, tasks, labels, workspaces, and more. Integrate easily.

- Tags: api-reference
- Published: 2026-08-08

### [How to Contribute to the Kaneo Project: Complete Contributor Guide](/usekaneo/kaneo/how-to-contribute-to-kaneo-project)

Want to contribute to the Kaneo project? Follow this guide to fork the repo, set up your local environment, and submit your first pull request. Learn how to get involved with usekaneo/kaneo today.

- Tags: how-to-guide
- Published: 2026-08-08

### [What Is the Purpose of the `src` Directory in Kaneo?](/usekaneo/kaneo/purpose-of-src-directory-in-kaneo)

Discover the purpose of the src directory in the usekaneo/kaneo monorepo. Learn how it houses the typed TypeScript source code for the Hono backend API, React frontend, and shared libraries.

- Tags: internals
- Published: 2026-08-08

### [How to Configure Kaneo Environment Variables: Production Setup Guide](/usekaneo/kaneo/how-to-configure-kaneo-project-environment-variables)

Master Kaneo environment variables for production. Learn to configure essential variables like KANEO_CLIENT_URL, AUTH_SECRET, and DATABASE_URL in your .env file for seamless API and web frontend operation.

- Tags: how-to-guide
- Published: 2026-08-08

### [Database Schema for the Kaneo Application: Complete Drizzle ORM Reference](/usekaneo/kaneo/kaneo-application-database-schema)

Explore the complete database schema for the Kaneo application, featuring over 30 tables managed by Drizzle ORM and PostgreSQL. Discover CUID2 keys, cascading constraints, and timestamps.

- Tags: api-reference
- Published: 2026-08-08

### [How to Run Tests in the Kaneo Repository: Complete Setup Guide](/usekaneo/kaneo/how-to-run-tests-in-kaneo-repository)

Learn how to run tests in the Kaneo repository with this setup guide. Execute unit or integration tests using pnpm and TurboRepo for efficient development.

- Tags: how-to-guide
- Published: 2026-08-08

### [What Programming Languages Are Used in the Kaneo Project?](/usekaneo/kaneo/programming-languages-used-in-kaneo-project)

Discover the programming languages powering the usekaneo/kaneo project. Learn how TypeScript dominates the backend and frontend, with supporting JavaScript and documentation.

- Tags: internals
- Published: 2026-08-08

### [How to Build the Kaneo Project from Source: Complete Development Guide](/usekaneo/kaneo/how-to-build-kaneo-project-from-source)

Learn to build the Kaneo project from source. This guide covers cloning the repo, installing dependencies, configuring .env, and running dev servers for API and web client. Start your Kaneo development today.

- Tags: how-to-guide
- Published: 2026-08-08

### [Main Dependencies for the Kaneo Repository: Complete Tech Stack Guide](/usekaneo/kaneo/kaneo-repository-main-dependencies)

Explore the main dependencies of the usekaneo kaneo repository. Discover the tech stack including Hono, React 19, Drizzle ORM, Turbo, Better Auth, and Tailwind CSS.

- Tags: tech-stack-guide
- Published: 2026-08-08

### [How to Set Up Kaneo Locally: Complete Development Environment Guide](/usekaneo/kaneo/how-to-set-up-kaneo-project-locally)

Set up Kaneo locally with this complete guide. Learn how to install Node.js, configure your .env file, and run the development environment using pnpm dev for API and web app.

- Tags: how-to-guide
- Published: 2026-08-08

### [How to Extend the TipTap Editor with Custom Extensions in Kaneo](/usekaneo/kaneo/extend-tiptap-editor-custom-extensions-kaneo)

Learn to extend the TipTap editor in Kaneo by creating custom extensions. Follow our guide to add new features and enhance your editor's functionality.

- Tags: how-to-guide
- Published: 2026-08-06

### [How to Configure Environment Variables for Kaneo Production Deployment: Complete Variable Reference](/usekaneo/kaneo/configure-environment-variables-kaneo-production-deployment)

Configure Kaneo production deployment environment variables by creating a .env file with KANEO_CLIENT_URL, KANEO_API_URL, AUTH_SECRET, and DATABASE_URL.

- Tags: how-to-guide
- Published: 2026-08-06

### [How to Write Unit and Integration Tests for Kaneo](/usekaneo/kaneo/write-unit-integration-tests-kaneo)

Learn how to write unit and integration tests for Kaneo using Vitest. Discover best practices for testing API logic and full-stack validation against PostgreSQL.

- Tags: how-to-guide
- Published: 2026-08-06

### [How to Customize the Kaneo Frontend Using TanStack Router and React Query](/usekaneo/kaneo/customize-kaneo-frontend-tanstack-router-react-query)

Customize Kaneo frontend with TanStack Router and React Query. Learn to create file-based routes and implement typed React Query hooks for dynamic UIs.

- Tags: how-to-guide
- Published: 2026-08-06

### [How the Gitea Integration Syncs Issues and Labels in Kaneo](/usekaneo/kaneo/kaneo-gitea-integration-sync-issues-labels)

Learn how the Kaneo Gitea integration syncs issues and labels bidirectionally using webhooks and label utilities for seamless project management.

- Tags: how-to-guide
- Published: 2026-08-06

### [How to Add a Custom Plugin to the Kaneo Project: A Complete Developer's Guide](/usekaneo/kaneo/add-custom-plugin-kaneo-project)

Learn how to add a custom plugin to the Kaneo project. This guide covers implementing the IntegrationPlugin interface, defining event handlers, and registering your plugin. Enhance Kaneo with your own integrations today.

- Tags: how-to-guide
- Published: 2026-08-06

### [How to Configure Sentry for Error Tracking and Performance Monitoring in Kaneo](/usekaneo/kaneo/configure-sentry-error-tracking-performance-monitoring-kaneo)

Learn how to configure Sentry for error tracking and performance monitoring in Kaneo. Enable automatic error capture and distributed tracing with simple environment variables.

- Tags: how-to-guide
- Published: 2026-08-06

### [How Kaneo Integrates Its Billing System with Creem: Architecture, Code, and Best Practices](/usekaneo/kaneo/kaneo-billing-system-integration-creem)

Discover how Kaneo integrates its billing system with Creem using a three-layer architecture. Learn about database storage, webhooks, and API synchronization for seamless subscription management.

- Tags: architecture
- Published: 2026-08-06

### [How to Set Up the Telegram Plugin for Notifications in Kaneo: A Complete Guide](/usekaneo/kaneo/setup-telegram-plugin-notifications-kaneo)

Easily set up Telegram notifications in Kaneo. Follow our complete guide to integrate your bot, get your token and chat ID, and configure alerts for seamless project updates.

- Tags: how-to-guide
- Published: 2026-08-06

### [How to Perform Bulk Task Operations and Imports in Kaneo](/usekaneo/kaneo/perform-bulk-task-operations-imports-kaneo)

Streamline your workflow with Kaneo's bulk task API. Effortlessly update statuses, assignments, labels, and delete multiple tasks simultaneously using a single PATCH request to /api/task/bulk.

- Tags: how-to-guide
- Published: 2026-08-06

### [How to Configure S3 for File Storage and Attachments in Kaneo](/usekaneo/kaneo/configure-s3-file-storage-attachments-kaneo)

Configure S3 for Kaneo file storage and attachments easily. Learn how to set up environment variables for secure uploads and private object retrieval in your Kaneo application.

- Tags: how-to-guide
- Published: 2026-08-06

### [How to Deploy Kaneo on Kubernetes Using Helm Charts: Complete Production Guide](/usekaneo/kaneo/deploy-kaneo-kubernetes-helm-charts)

Deploy Kaneo on Kubernetes with official Helm charts. Install with embedded PostgreSQL or customize for external databases, ingress, and autoscaling.

- Tags: how-to-guide
- Published: 2026-08-06

### [How to Configure Custom OAuth Providers (GitHub, Google, and Discord) in Kaneo](/usekaneo/kaneo/configure-custom-oauth-providers-kaneo)

Configure custom OAuth providers like GitHub Google and Discord in Kaneo using environment variables. Enable secure authentication in minutes with this quick guide.

- Tags: how-to-guide
- Published: 2026-08-06

### [How to Implement Time Tracking Using the Kaneo Time Entries API](/usekaneo/kaneo/implement-time-tracking-kaneo-time-entries-api)

Learn to implement time tracking with the Kaneo Time Entries API. This guide details its RESTful interface, built with Hono and Drizzle, for seamless time entry management.

- Tags: how-to-guide
- Published: 2026-08-06

### [Kaneo Database Schema Structure for Tasks, Projects, and Workspaces: A Complete Guide](/usekaneo/kaneo/kaneo-database-schema-structure-tasks-projects-workspaces)

Explore the Kaneo database schema structure for tasks, projects, and workspaces. Learn how PostgreSQL and Drizzle ORM efficiently manage your data with optimized indexes and foreign keys.

- Tags: deep-dive
- Published: 2026-08-06

### [How to Configure Redis for WebSocket Pub/Sub Broadcasting in Kaneo](/usekaneo/kaneo/configure-redis-websocket-pubsub-broadcasting-kaneo)

Configure Redis for WebSocket pub/sub broadcasting in Kaneo with simple environment variables. Enable reliable real-time communication effortlessly.

- Tags: how-to-guide
- Published: 2026-08-06

### [How Kaneo API Handles Authentication with Better Auth: A Deep Dive into the Source Code](/usekaneo/kaneo/kaneo-api-authentication-better-auth)

Explore how Kaneo API leverages Better Auth for robust authentication. Discover OAuth, magic links, API keys, and device-code flows by diving into the source code.

- Tags: deep-dive
- Published: 2026-08-06

### [How to Configure Workflow Rules for Task Status Transitions in Kaneo](/usekaneo/kaneo/configure-workflow-rules-task-status-transitions-kaneo)

Learn how to configure workflow rules for task status transitions in Kaneo. Understand how Kaneo enforces allowed transitions using the workflow_rules table and the canTransition service.

- Tags: how-to-guide
- Published: 2026-08-06

### [What Is the MCP Server in Kaneo and Which Tools Does It Provide?](/usekaneo/kaneo/kaneo-mcp-server-tools)

Explore the Kaneo MCP server, offering 20+ AI-powered tools to manage workspaces, projects, tasks, labels, and comments with assistants like Claude and Cursor.

- Tags: deep-dive
- Published: 2026-08-06

### [How to Set Up GitHub Integration for Bidirectional Task Sync in Kaneo](/usekaneo/kaneo/setup-github-integration-bidirectional-task-sync-kaneo)

Effortlessly sync GitHub issues, PRs, and comments with Kaneo. Set up bidirectional task sync by configuring a GitHub App and webhook. Streamline your workflow today.

- Tags: how-to-guide
- Published: 2026-08-06

### [How Kaneo's Permission System Handles Workspaces and Teams: A Complete Technical Guide](/usekaneo/kaneo/kaneo-permission-system-workspaces-teams)

Explore Kaneo's robust permission system. Learn how workspaces and teams are managed with a hierarchical RBAC model, workspace-scoped roles, and four built-in permission levels. Get the technical details.

- Tags: deep-dive
- Published: 2026-08-06

### [Performance Considerations for Kaneo: 6 Optimization Strategies for Self-Hosted Deployments](/usekaneo/kaneo/kaneo-performance-considerations)

Discover 6 optimization strategies for self-hosted Kaneo deployments. Improve database queries, WebSocket scaling, caching, and asset handling for peak performance.

- Tags: performance
- Published: 2026-08-05

### [How to Handle Errors in Kaneo: Backend, Frontend and UI Best Practices](/usekaneo/kaneo/kaneo-error-handling)

Learn to handle errors in Kaneo with a layered architecture. Discover backend, frontend, and UI best practices for robust error management and user guidance.

- Tags: best-practices
- Published: 2026-08-05

### [How to Customize Kaneo Themes and UI: Complete Tailwind and Zustand Guide](/usekaneo/kaneo/kaneo-ui-customization)

Easily customize Kaneo themes and UI. Learn to modify the Zustand store and extend Tailwind CSS v4 tokens for a personalized look. Get started now!

- Tags: how-to-guide
- Published: 2026-08-05

### [Kaneo vs Other Project Management Frameworks: A Technical Comparison for Self-Hosted Teams](/usekaneo/kaneo/kaneo-vs-other-framework)

Compare Kaneo, a self-hosted open-source project management tool, against other frameworks. Discover Kaneo's lightweight Hono API, React 19, and AI automation for your team.

- Tags: comparison
- Published: 2026-08-05

### [How to Get Support for Kaneo: 7 Official Channels and Community Resources](/usekaneo/kaneo/kaneo-support-options)

Need support for Kaneo? Discover 7 official channels and community resources including Discord, GitHub, and documentation to get help fast.

- Tags: how-to-guide
- Published: 2026-08-05

### [Kaneo MIT License: Terms, Permissions, and Compliance Requirements](/usekaneo/kaneo/kaneo-licensing-information)

Understand the Kaneo MIT License terms, permissions, and compliance requirements. Use, modify, and distribute Kaneo freely with minimal restrictions.

- Tags: api-reference
- Published: 2026-08-05

### [How to Contribute to Kaneo: A Complete Monorepo Guide](/usekaneo/kaneo/how-to-contribute-to-kaneo)

Learn how to contribute to Kaneo a powerful monorepo. Follow our guide to fork the repo install dependencies and set up your local environment to start developing.

- Tags: how-to-guide
- Published: 2026-08-05

### [Kaneo Project Structure: A Complete Guide to the Monorepo Architecture](/usekaneo/kaneo/kaneo-project-structure)

Explore the Kaneo project structure, a pnpm monorepo with TurboRepo. Discover apps, packages, and Kubernetes charts for efficient development and deployment.

- Tags: architecture
- Published: 2026-08-05

### [Kaneo Development Best Practices: A Complete Guide to Contributing to the Self-Hosted Project Management Platform](/usekaneo/kaneo/kaneo-development-best-practices)

Learn Kaneo development best practices for contributing to the self-hosted project management platform. Master monorepo structure, controller pattern, Valibot, TanStack Query, Biome, and Conventional Commits.

- Tags: best-practices
- Published: 2026-08-05

### [How to Manage Kaneo Configurations: A Complete Guide to Environment Variables and API-First Settings](/usekaneo/kaneo/kaneo-configuration-management)

Master Kaneo configurations with this guide. Learn to manage environment variables and API-first settings for your usekaneo/kaneo repository. Optimize your application's runtime behavior today.

- Tags: how-to-guide
- Published: 2026-08-05

### [How to Integrate Kaneo with External APIs: A Complete Guide to Webhooks and Custom Plugins](/usekaneo/kaneo/kaneo-external-api-integration)

Integrate Kaneo with external APIs using ready-made webhook plugins or build a custom plugin. Implement event handlers and validation logic in TypeScript for seamless integration.

- Tags: how-to-guide
- Published: 2026-08-05

### [Kaneo Database Options: PostgreSQL Configuration Guide for Production and Development](/usekaneo/kaneo/kaneo-database-options)

Explore Kaneo's PostgreSQL database options for production and development. Learn about DATABASE_URL, POSTGRES variables, and SQLite fallback.

- Tags: how-to-guide
- Published: 2026-08-05

### [How Kaneo Handles Authentication: A Complete Technical Guide](/usekaneo/kaneo/kaneo-authentication-mechanism)

Discover how Kaneo handles authentication using JWT tokens, session cookies, API keys, and OAuth. Secure your API and web interface with this comprehensive technical guide.

- Tags: deep-dive
- Published: 2026-08-05

### [What Are Kaneo's Core Features? A Technical Deep Dive into the Open-Source Kanban Platform](/usekaneo/kaneo/kaneo-core-features)

Explore Kaneo's core features including project management, real-time collaboration, SSO, and integrations. This technical deep dive covers the open-source Kanban platform's robust functionality.

- Tags: deep-dive
- Published: 2026-08-05

### [How to Use Kaneo with Docker: Complete Setup Guide](/usekaneo/kaneo/kaneo-docker-integration)

Learn how to use Kaneo with Docker in this complete setup guide. Easily deploy Kaneo using Docker Compose for production or local development. Get started today!

- Tags: how-to-guide
- Published: 2026-08-05

### [How to Deploy a Kaneo Application: 5 Methods for Production and Development](/usekaneo/kaneo/how-to-deploy-kaneo-application)

Learn to deploy your Kaneo application easily with 5 production ready methods including drim CLI Docker Compose and Helm charts Secure your deployments with external PostgreSQL and Kubernetes Secrets

- Tags: how-to-guide
- Published: 2026-08-05

### [How to Run Tests in the Kaneo Monorepo: Unit and Integration Testing Guide](/usekaneo/kaneo/how-to-run-tests-in-kaneo)

Learn to run unit and integration tests in the Kaneo monorepo with simple pnpm commands. Set up PostgreSQL and DATABASE_URL to get started.

- Tags: how-to-guide
- Published: 2026-08-05

### [How to Build a Kaneo Project: A Step-by-Step Monorepo Guide](/usekaneo/kaneo/how-to-build-kaneo-project)

Learn how to build a Kaneo project with this step by step guide. Clone the repo, install dependencies, build with TurboRepo, and run using pnpm dev or Docker.

- Tags: how-to-guide
- Published: 2026-08-05

### [How to Create a New Kaneo Project: Complete API and Web Client Guide](/usekaneo/kaneo/how-to-create-new-kaneo-project)

Create a new Kaneo project using the API. Learn how to send a POST request to /api/project with your project name and workspace ID. Get started with Kaneo today.

- Tags: how-to-guide
- Published: 2026-08-05

### [Kaneo Commands for Development: Essential CLI Scripts Explained](/usekaneo/kaneo/kaneo-basic-commands)

Master essential Kaneo commands like pnpm dev, build, lint, test, and typecheck. Streamline your development workflow with these powerful CLI scripts from the usekaneo/kaneo repo.

- Tags: how-to-guide
- Published: 2026-08-05

### [How to Configure Kaneo: Complete Environment Variable Guide for Self-Hosted Deployment](/usekaneo/kaneo/how-to-configure-kaneo)

Configure Kaneo for self-hosted deployment using environment variables in the root .env file. Master API, web, and WebSocket settings for a seamless setup.

- Tags: how-to-guide
- Published: 2026-08-05

### [How to Install Kaneo on macOS: A Complete Self-Hosted Setup Guide](/usekaneo/kaneo/how-to-install-kaneo)

Learn how to install Kaneo on macOS with this complete self-hosted setup guide. Follow three simple steps to get Kaneo running quickly and efficiently.

- Tags: how-to-guide
- Published: 2026-08-05

### [CI/CD Pipeline Configuration for usekaneo/kaneo: Full GitHub Actions Breakdown](/usekaneo/kaneo/what-ci-cd-pipeline-configuration-usekaneo-kaneo)

Explore the CI/CD pipeline configuration for usekaneo/kaneo. This GitHub Actions breakdown details linting, testing, building, and Docker image validation in five coordinated jobs.

- Tags: how-to-guide
- Published: 2026-08-04

### [Where Can I Find the Kaneo Issue Tracker? GitHub Issues Location & API Access](/usekaneo/kaneo/where-can-i-find-projects-issue-tracker)

Find the Kaneo issue tracker on GitHub at usekaneo/kaneo/issues. Access bug reports, feature requests, and questions with structured templates and API options.

- Tags: api-reference
- Published: 2026-08-04

### [usekaneo/kaneo Licensing Terms: Complete MIT License Guide](/usekaneo/kaneo/what-licensing-terms-usekaneo-kaneo)

Understand the usekaneo/kaneo licensing terms. Explore the MIT License guide for free use, modification, and distribution of the kaneo project.

- Tags: licensing-terms
- Published: 2026-08-04

### [Kaneo README for Developers: Complete Guide to Setup, Deployment, and Contribution](/usekaneo/kaneo/is-there-readme-file-essential-information-developers)

Explore the Kaneo README for developers. Get essential setup, deployment, and contribution info for the usekaneo kaneo repository. Start building today!

- Tags: getting-started
- Published: 2026-08-04

### [What Tests Are Implemented in usekaneo/kaneo? Unit, Integration, and E2E Coverage Explained](/usekaneo/kaneo/what-kind-tests-implemented-usekaneo-kaneo-unit-integration-e2e)

Discover the test coverage in usekaneo/kaneo. Learn about their fast unit tests and full-stack integration tests implemented with Vitest. Understand the current testing strategy.

- Tags: testing
- Published: 2026-08-04

### [How to Set Up a Development Environment for the Kaneo Project: A Complete Guide](/usekaneo/kaneo/how-can-i-set-up-development-environment-usekaneo-kaneo)

Set up your usekaneo/kaneo development environment quickly. Clone the repo, install dependencies, configure .env, and run pnpm dev to launch the API and web UI.

- Tags: getting-started
- Published: 2026-08-04

### [Kaneo Example Usage Scenarios: 4 Deployment Methods Explained](/usekaneo/kaneo/are-there-example-usage-scenarios-provided-usekaneo-kaneo)

Explore Kaneo example usage scenarios with four deployment methods: one-click local install, Docker Compose, Helm charts, and MCP client. Deploy Kaneo easily for any environment.

- Tags: example-usage
- Published: 2026-08-04

### [What Is the Role of the `docs` Directory in usekaneo/kaneo?](/usekaneo/kaneo/what-role-docs-directory-usekaneo-kaneo)

Explore the role of the `docs` directory in usekaneo/kaneo. Mintlify powers this hub, generating a full-featured docs site from Markdown MDX content and an OpenAPI specification.

- Tags: how-to-guide
- Published: 2026-08-04

### [Kaneo Application Architecture: Main Modules and Components Explained](/usekaneo/kaneo/what-main-modules-components-kaneo-application)

Explore the Kaneo application architecture. Discover its six core modules: API Hono backend, React 19 SPA, Nextjs marketing site, MDX docs, shared packages, and Helm charts.

- Tags: architecture
- Published: 2026-08-04

### [Kaneo API Documentation: How to Access the OpenAPI 3.0 Spec](/usekaneo/kaneo/is-there-api-documentation-available-usekaneo-kaneo)

Access Kaneo API documentation via OpenAPI 3.0 spec. Get runtime endpoint and static file for usekaneo/kaneo for seamless integration.

- Tags: api-reference
- Published: 2026-08-04

### [What Database Does usekaneo/kaneo Use? PostgreSQL with Drizzle ORM Explained](/usekaneo/kaneo/what-kind-database-usekaneo-kaneo-interact-with)

Discover the PostgreSQL database and Drizzle ORM powering the usekaneo/kaneo project. Learn how type-safe SQL operations enhance development.

- Tags: deep-dive
- Published: 2026-08-04

### [How to Contribute to the Usekaneo/Kaneo Project: A Complete Guide](/usekaneo/kaneo/how-can-i-contribute-usekaneo-kaneo-project)

Learn how to contribute to the usekaneo/kaneo project. Understand its pnpm monorepo, backend/frontend patterns, and coding standards to make your first contribution.

- Tags: how-to-guide
- Published: 2026-08-04

### [File and Directory Naming Conventions in Kaneo: A Complete Guide](/usekaneo/kaneo/are-there-specific-conventions-naming-files-directories-usekaneo-kaneo)

Discover Kaneo naming conventions for files and directories in usekaneo/kaneo. Learn PascalCase, kebab-case, and test file naming best practices for cleaner code.

- Tags: best-practices
- Published: 2026-08-04

### [What Is the Purpose of the `src` Directory in usekaneo/kaneo?](/usekaneo/kaneo/what-purpose-src-directory-usekaneo-kaneo)

Discover the purpose of the src directory in usekaneo/kaneo. It houses all typed TypeScript source files for the API server, React frontend, and shared packages.

- Tags: how-to-guide
- Published: 2026-08-04

### [How Tests Are Organized in the usekaneo/kaneo Repository](/usekaneo/kaneo/how-are-tests-organized-usekaneo-kaneo-repository)

Discover how tests are organized in the usekaneo/kaneo repository. Learn about fast unit tests and full-stack integration tests structured under tests/api and tests/api-integration.

- Tags: how-to-guide
- Published: 2026-08-04

### [Configuration Directory in usekaneo/kaneo: How Environment Configuration Works](/usekaneo/kaneo/is-there-configuration-directory-usekaneo-kaneo)

Discover how usekaneo/kaneo manages environment configuration. Learn about its decentralized approach using .env.sample and config.ts modules instead of a central directory.

- Tags: how-to-guide
- Published: 2026-08-04

### [Kaneo Build Tools and Scripts: Complete Guide to the TurboRepo Monorepo Workflow](/usekaneo/kaneo/what-build-tools-scripts-available-usekaneo-kaneo)

Explore the Kaneo build tools and scripts for managing your TurboRepo monorepo. This guide covers pnpm, npm-style scripts, and task orchestration in turbo.json.

- Tags: how-to-guide
- Published: 2026-08-04

### [How Dependencies Are Managed in the usekaneo/kaneo Project: A Deep Dive](/usekaneo/kaneo/how-are-dependencies-managed-usekaneo-kaneo-project)

Discover how usekaneo/kaneo manages dependencies in its pnpm monorepo with Turborepo. Learn about workspace protocols and version overrides for efficient development.

- Tags: deep-dive
- Published: 2026-08-04

### [What Frameworks and Libraries Power usekaneo/kaneo's Core Functionality?](/usekaneo/kaneo/does-usekaneo-kaneo-use-specific-framework-library-core-functionality)

Discover the core frameworks and libraries powering usekaneo/kaneo. Learn about Hono, React 19, TanStack, Drizzle ORM, and Better Auth in this pnpm monorepo.

- Tags: internals
- Published: 2026-08-04

### [Key Directories in the usekaneo/kaneo Repository: A Complete Structural Guide](/usekaneo/kaneo/what-key-directories-usekaneo-kaneo-repository)

Explore the key directories in the usekaneo/kaneo repository. Understand the monorepo structure, application folders, shared packages, and deployment assets for efficient development.

- Tags: how-to-guide
- Published: 2026-08-04

### [Where Is the Main Entry Point for the Kaneo Application?](/usekaneo/kaneo/where-find-main-entry-point-kaneo-application)

Discover the main entry points for the Kaneo application. Find the API server entry at apps api src index ts and the web client entry at apps web src main ts within the TurboRepo structure.

- Tags: internals
- Published: 2026-08-04

### [Kaneo Project Structure Explained: A Deep Dive into the usekaneo/kaneo Monorepo](/usekaneo/kaneo/how-is-usekaneo-kaneo-project-structured-top-level)

Explore the usekaneo/kaneo monorepo structure. Discover how apps, packages, and charts organize the backend API, frontend SPA, docs, shared libraries, and Kubernetes config.

- Tags: deep-dive
- Published: 2026-08-04

### [What Is the Primary Programming Language of the usekaneo/kaneo Repository?](/usekaneo/kaneo/what-is-primary-programming-language-usekaneo-kaneo)

Discover the primary programming language for the usekaneo/kaneo repository. Learn how TypeScript powers its backend and frontend components, compiled to JavaScript for universal compatibility.

- Tags: getting-started
- Published: 2026-08-04

### [Kaneo Supported Platforms: 3 Ways to Deploy the Open-Source Project Management Tool](/usekaneo/kaneo/kaneo-supported-platforms)

Discover Kaneo supported platforms: deploy this open-source project management tool easily with drim, Docker Compose, or Kubernetes. Get started quickly.

- Tags: supported-platforms
- Published: 2026-08-02

### [How to Secure a Kaneo Installation: A Complete Hardening Guide](/usekaneo/kaneo/how-to-secure-kaneo-installation)

Learn how to secure your Kaneo installation with this comprehensive hardening guide. Discover essential steps like generating strong secrets, configuring CORS, and running non-root containers.

- Tags: how-to-guide
- Published: 2026-08-02

### [Kaneo Performance Tuning: A Complete Guide to Database, Real-Time, and API Optimization](/usekaneo/kaneo/kaneo-performance-tuning)

Optimize your Kaneo application with this complete guide to database, real-time, and API tuning. Learn effective strategies for maximum performance.

- Tags: performance
- Published: 2026-08-02

### [How to Uninstall Kaneo: Complete Removal Guide for Helm, Drim, and Docker Compose](/usekaneo/kaneo/how-to-uninstall-kaneo)

Uninstall Kaneo completely using Helm, Drim, or Docker Compose. Our guide provides step-by-step instructions for full removal and cleanup.

- Tags: how-to-guide
- Published: 2026-08-02

### [How to Update Kaneo to the Latest Version](/usekaneo/kaneo/how-to-update-kaneo-to-the-latest-version)

Easily update Kaneo to the latest version by pulling the new Docker image or using the drim CLI tool. Get the most recent features and security updates today.

- Tags: how-to-guide
- Published: 2026-08-02

### [Where to Find Kaneo Pre‑Compiled Binaries: Docker Images and CLI Download Guide](/usekaneo/kaneo/where-to-find-kaneo-pre-compiled-binaries)

Find Kaneo pre-compiled binaries easily. Download the Docker image from ghcr.io/usekaneo/kaneo or grab the standalone CLI installer drim from the releases page.

- Tags: how-to-guide
- Published: 2026-08-02

### [Kaneo License Information: MIT License Terms and Usage Rights](/usekaneo/kaneo/kaneo-license-information)

Understand Kaneo license information. The MIT License allows free use modification and distribution of Kaneo with minimal requirements. Explore the terms and rights.

- Tags: licensing
- Published: 2026-08-02

### [How to Suggest a New Feature for Kaneo: A Complete Guide to GitHub Issues and Community Discussions](/usekaneo/kaneo/how-to-suggest-a-new-feature-for-kaneo)

Learn how to suggest a new feature for Kaneo by discussing your idea on Discord and opening a GitHub issue. Follow our complete guide for a smooth process.

- Tags: how-to-guide
- Published: 2026-08-02

### [How to Report a Bug in Kaneo: Complete Guide to GitHub Issues and Templates](/usekaneo/kaneo/how-to-report-a-bug-in-kaneo)

Learn how to report a bug in Kaneo efficiently using GitHub Issues and templates. Follow our guide for clear bug reporting and faster resolution.

- Tags: how-to-guide
- Published: 2026-08-02

### [How to Integrate Kaneo with Other Tools: A Complete Technical Guide](/usekaneo/kaneo/how-to-integrate-kaneo-with-other-tools)

Discover how to integrate Kaneo with Slack, GitHub, Discord and more using REST API, WebSockets, and React hooks. Streamline your workflow with this technical guide.

- Tags: how-to-guide
- Published: 2026-08-02

### [How to Troubleshoot Kaneo Startup Errors: Complete Debugging Guide](/usekaneo/kaneo/how-to-troubleshoot-kaneo-startup-errors)

Troubleshoot Kaneo startup errors by inspecting logs and validating your .env file. Learn to identify environment misconfiguration, database issues, and port conflicts with this debugging guide.

- Tags: how-to-guide
- Published: 2026-08-02

### [How to Run Kaneo as a Service: Docker Compose Deployment Guide](/usekaneo/kaneo/how-to-run-kaneo-as-a-service)

Deploy Kaneo as a service using Docker Compose. Orchestrate PostgreSQL, Hono API, and React frontend in a unified container network with auto-restart for seamless operation.

- Tags: how-to-guide
- Published: 2026-08-02

### [Kaneo Command-Line Interface (CLI) Options: Complete Guide to kaneo-mcp](/usekaneo/kaneo/kaneo-command-line-interface-cli-options)

Master Kaneo CLI options with this complete guide. Learn to use kaneo-mcp for interactive installs, serving MCP servers, and accessing help commands for the usekaneo repository.

- Tags: how-to-guide
- Published: 2026-08-02

### [How to Change Kaneo Settings: Environment Variables and UI Configuration](/usekaneo/kaneo/how-to-change-kaneo-settings)

Learn how to change Kaneo settings using environment variables for server-side configuration or the UI for account preferences. Easily manage your Kaneo environment.

- Tags: how-to-guide
- Published: 2026-08-02

### [How to Build Kaneo from Source: A Step-by-Step Development Guide](/usekaneo/kaneo/how-to-build-kaneo-from-source)

Learn how to build Kaneo from source with this step-by-step guide. Clone the repo, install dependencies, configure secrets, and run the build command for development or production.

- Tags: how-to-guide
- Published: 2026-08-02

### [How to Install Kaneo on macOS: Complete Docker Setup Guide](/usekaneo/kaneo/how-to-install-kaneo-on-macos)

Install Kaneo on macOS quickly with this Docker setup guide. Clone the repo, configure .env, and run docker compose up -d for a seamless experience.

- Tags: how-to-guide
- Published: 2026-08-02

### [How to Install Kaneo on Windows: Complete Setup Guide with WSL 2 and Docker](/usekaneo/kaneo/how-to-install-kaneo-on-windows)

Install Kaneo on Windows using WSL 2 and Docker. Follow our complete guide to set up the full stack with drim CLI or Docker Compose for seamless deployment.

- Tags: how-to-guide
- Published: 2026-08-02