dumbwareio/dumbkan repository overview

⁠DumbKan - Simple Kanban Board

A lightweight, mobile-friendly Kanban board application for managing tasks and projects. Built with vanilla JavaScript and Node.js.

⁠Features

⁠🎯 Task Management

• Create, edit, and delete tasks easily
• Double-click (desktop) or double-tap (mobile) to edit tasks
• Drag and drop tasks between columns
• Smooth animations and visual feedback during interactions

⁠📱 Mobile-Optimized

• Responsive design that works on all devices
• Touch-friendly interface
• Double-tap to edit tasks on mobile
• Easy task movement with touch gestures

⁠📋 Board Management

• Multiple boards support (Work, Personal, etc.)
• Create and delete boards
• Switch between boards instantly
• Persistent board state

⁠📊 Column Management

• Add new columns for custom workflows
• Edit column names inline
• Remove columns with confirmation
• Drag tasks between columns

⁠🎨 Theme Support

• Light and dark mode
• System theme detection
• Smooth theme transitions
• Theme persistence across sessions

⁠💾 Data Persistence

• Automatic saving of changes
• Persistent across page refreshes
• JSON-based storage
• No database required

⁠Environment Variables

⁠PIN Protection

When DUMBKAN_PIN is set, the app requires PIN verification before accessing or modifying boards. The PIN must be 4-10 digits long.

⁠Data Persistence

Task data is stored in /app/data/tasks.json. When using Docker, mount this directory as a volume to persist data between container restarts.

⁠Getting Started

⁠Option 1: Docker (Recommended)

1. Pull the image:

   docker pull dumbwareio/dumbkan:latest
   

   Copy

2. Run the container:

   docker run -d -p 3000:3000 -v $(pwd)/data:/app/data --env-file .env dumbwareio/dumbkan:latest
   

   Copy

3. Open your browser and navigate to:

   http://localhost:3000
   

   Copy

⁠Option 2: Local Installation

1. Clone the repository:

   git clone https://github.com/dumbwareio/dumbkan.git
   cd dumbkan
   

   Copy

2. Install dependencies:

   npm install
   

   Copy

3. Start the server:

   npm start
   

   Copy

4. Open your browser and navigate to:

   http://localhost:3000
   

   Copy

⁠Usage Guide

⁠Managing Tasks

• Click "Add Task" to create a new task
• Double-click (or double-tap on mobile) to edit a task
• Drag and drop tasks between columns
• Delete tasks using the delete button in the edit modal

⁠Working with Boards

• Click the board name to open the board selector
• Use "Manage Boards" to add or remove boards
• Each board maintains its own columns and tasks

⁠Customizing Columns

• Click "Add Column" to create a new column
• Click a column name to edit it
• Use the remove icon (×) to delete a column

⁠Theme Switching

• Click the sun/moon icon to toggle between light and dark modes
• Theme automatically syncs with system preferences
• Theme choice persists across sessions

⁠Technical Details

• Built with vanilla JavaScript - no frameworks
• Node.js backend with Express
• File-based JSON storage
• Responsive CSS with modern features
• Mobile-first design approach

⁠Contributing

Feel free to submit issues and enhancement requests!