Issue Tracker v1.0.0 - First Stable Release

🎉 Issue Tracker v1.0.0 - First Stable Release

We're excited to announce the first stable release of Issue Tracker - a modern, full-stack task management application with powerful Kanban boards and advanced search capabilities.

🌟 Key Features

Multi-Board Organization

• Create unlimited boards for projects, teams, or categories
• Fast sidebar navigation with client-side search
• Board-specific views and task organization
• Shareable URLs with board state persistence

Three-View Workflow System

• Board View (Kanban): 4-column workflow (To Do → In Progress → Ready for Deployment → Done)
• Backlog View: Organize tasks with custom categories, drag & drop category reordering
• Archive View: Automatic filtering of completed tasks (>7 days in Done)

Advanced Task Search

• Structured query syntax with visual chips (`Board:[Name]`, `Tag:[Tag]`, `Status:[Status]`)
• Smart autocomplete for fields and values
• Board-scoped or global search
• Keyboard shortcuts (Cmd+K, arrow navigation, ESC)
• Debounced search (300ms) for optimal performance

Drag & Drop Interface

• Accessible drag & drop powered by @dnd-kit
• Move tasks between columns, categories, and positions
• Keyboard navigation support
• Touch-friendly for mobile devices
• Smooth animations and visual feedback

Task Management

• Rich task properties (title, description, status, tags, categories)
• Inline editing with auto-save
• Tag system with autocomplete
• Position tracking within columns/categories
• Timestamps and history tracking

🛠️ Tech Stack

Backend:

• Kotlin + Spring Boot 3.x with WebFlux (reactive)
• PostgreSQL with R2DBC (non-blocking)
• Flyway database migrations
• RESTful API with reactive streams

Frontend:

• Next.js 16 (App Router) + React 19
• TypeScript 5.9 (strict mode)
• Tailwind CSS for styling
• Static export served from backend

🚀 Deployment Options

Docker (Recommended)

Pull and run the latest image from GitHub Container Registry:

# Pull the image
docker pull ghcr.io/freefair/issue-tracker:1.0.0
# or
docker pull ghcr.io/freefair/issue-tracker:latest

# Run with PostgreSQL
docker run -d \\
  -p 8080:8080 \\
  -e SPRING_R2DBC_URL=r2dbc:postgresql://host:5432/issuetracker \\
  -e SPRING_R2DBC_USERNAME=youruser \\
  -e SPRING_R2DBC_PASSWORD=yourpass \\
  -e SPRING_FLYWAY_URL=jdbc:postgresql://host:5432/issuetracker \\
  -e CORS_ALLOWED_ORIGINS=https://yourdomain.com \\
  ghcr.io/freefair/issue-tracker:1.0.0

JAR File

Download the JAR artifact from this release and run locally:

# Download issue-tracker-1.0.0.jar from release assets

# Run with Java 21+
java -jar issue-tracker-1.0.0.jar \\
  --spring.r2dbc.url=r2dbc:postgresql://localhost:5432/issuetracker \\
  --spring.r2dbc.username=youruser \\
  --spring.r2dbc.password=yourpass

📋 Requirements

• Database: PostgreSQL 12+ (required)
• Runtime: Java 21+ (for JAR) or Docker
• Browser: Modern browser with JavaScript enabled

📚 Documentation

• FEATURES.md - Complete feature documentation
• RELEASE.md - Release process and versioning guide
• CLAUDE.md - Architecture and development guide

🎯 What's New in 1.0.0

This is the first stable release, featuring:

✅ Complete task management CRUD operations
✅ Multi-board support with URL state persistence
✅ Three-view workflow system (Board, Backlog, Archive)
✅ Advanced search with structured queries and autocomplete
✅ Accessible drag & drop with keyboard support
✅ PostgreSQL support with R2DBC reactive access
✅ Feature-based frontend architecture
✅ Structured logging with environment awareness
✅ Production-ready Docker images
✅ Automated release workflow with semantic versioning

🔄 Upgrade Notes

This is the first release - no upgrade path needed.

🐛 Known Issues

• Archive view uses simple >7 days filter (no manual archive action yet)
• No authentication/authorization system (planned for future release)
• Single-user mode (multi-user support planned)

📞 Support

• Issues: Report bugs or request features via GitHub Issues
• Discussions: Ask questions in GitHub Discussions

---

Full Changelog: https://github.com/freefair/issue-tracker/commits/v1.0.0

🙏 Thank you for using Issue Tracker!