MCPInstall
simple-kanban logo

simple-kanban

by mateo-velez mateo-velez/simple-kanban

A minimalist Kanban board for organizing tasks with a clean, modern interface. Built with FastAPI and Next.js, it focuses on simplicity while maintaining essential task management features.

View on GitHub
READMEmain

Simple Kanban

A modern, full-stack Kanban board application built to apply software engineering best practices.

Overview

Simple Kanban is a task management system built with FastAPI and Next.js, showcasing clean architecture and modern development practices. It implements core Kanban methodology features while maintaining simplicity and performance.

Key Features

  • Modern Authentication: JWT-based auth flow with secure session management
  • Real-Time Updates: Optimistic UI updates for seamless user experience
  • Clean Architecture: Clear separation of concerns with FastAPI and Next.js
  • Efficient Data Model: SQLAlchemy ORM with proper relationship modeling
  • AI Integration: Model Context Protocol (MCP) for LLM tool calling capabilities

Tech Stack

  • Frontend: Next.js, TypeScript, Tailwind CSS, shadcn/ui
  • Backend: FastAPI, SQLAlchemy, PostgreSQL
  • Infrastructure: Docker
  • Testing: Pytest for API testing
  • CI/CD: GitHub Actions

Project Structure

.
├── backend/         # FastAPI server with SQLAlchemy ORM
├── frontend/        # Next.js client application
├── mcp/             # Model Context Protocol for LLM integration
└── scripts/         # Development utilities

Screenshots

Kanban Board View Kanban Card View Kanban Board Details View A minimalist Kanban interface with four columns (Backlog, Todo, Doing, Done) to reduce decision effort. Cards feature titles, descriptions, and a curated set of label colors.

Getting Started

Quick Start with Docker

# Clone the repository
git clone https://github.com/mateo-velez/simple-kanban.git
cd simple-kanban

# Launch services
docker compose up -d

Access the application:

Development Setup

Prerequisites:

  • Python 3.10+
  • Next.js 18+
  • PostgreSQL 15

Technical Highlights

  • Backend:

    • RESTful API with FastAPI
    • SQLAlchemy ORM with proper relationship modeling
    • Comprehensive API testing with pytest
    • JWT authentication flow

  • Frontend:

    • Client-side rendering with Next.js
    • Type-safe development with TypeScript
    • Optimistic updates for better UX
    • Responsive design with Tailwind CSS

Planned Enhancements

  • Database migrations with Alembic
  • Enhanced logging system
  • Drag-and-drop card functionality
  • Frontend chat integration
  • Board sharing implementation
  • User analytics dashboard