feat: add help menu and improve project maintenance with fmt target and zip ignore

Author: programmersd21

Makefile

@@ -1,7 +1,10 @@
-.PHONY: build test lint clean run
+.PHONY: build test lint clean run fmt
 
 BINARY_NAME=kairo
 
+fmt:
+	go fmt ./...
+
 build:
 	go build -trimpath -ldflags "-s -w" -o $(BINARY_NAME) ./cmd/kairo
 
@@ -21,3 +24,4 @@ run: build
 
 install:
 	go install ./cmd/kairo
+	

internal/app/model.go

@@ -11,6 +11,7 @@ import (
 	"strings"
 	"time"
 
+	"github.com/charmbracelet/bubbles/key"
 	tea "github.com/charmbracelet/bubbletea"
 	"github.com/charmbracelet/lipgloss"
 
@@ -684,27 +685,49 @@ func (m *Model) renderHeader() string {
 		Render(header)
 }
 
+// firstKey returns the first configured key for a binding, or "?" if unset.
+func firstKey(b key.Binding) string {
+	keys := b.Keys()
+	if len(keys) == 0 {
+		return "?"
+	}
+	return keys[0]
+}
+
 func (m *Model) renderFooter() string {
+	fk := firstKey
 	left := ""
 	switch m.mode {
 	case ModeConfirmDelete:
 		left = m.s.BadgeBad.Render(" DELETE? ") + " " + m.s.Muted.Render("y/enter confirm • n/esc cancel")
 	case ModeDetail:
-		left = " " + m.s.Muted.Render("esc back • e edit • ctrl+p palette • ? help")
+		left = " " + m.s.Muted.Render(
+			fk(m.km.Back)+" back • "+
+				fk(m.km.EditTask)+" edit • "+
+				fk(m.km.Palette)+" palette • "+
+				fk(m.km.Help)+" help",
+		)
 	case ModeEditor:
 		left = " " + m.s.Muted.Render("ctrl+s save • esc cancel • tab next field")
 	case ModePalette:
 		left = " " + m.s.Muted.Render("enter select • esc close • ↑/↓ navigate")
 	case ModeHelp:
-		left = " " + m.s.Muted.Render("esc/q/? close")
+		left = " " + m.s.Muted.Render("esc/q/"+fk(m.km.Help)+" close")
 	case ModeThemeMenu:
-		left = " " + m.s.Muted.Render("enter select • esc/q/t close • ↑/↓ navigate")
+		left = " " + m.s.Muted.Render("enter select • esc/q/"+fk(m.km.CycleTheme)+" close • ↑/↓ navigate")
 	case ModePluginMenu:
-		left = " " + m.s.Muted.Render("x uninstall • esc/q/p close • ↑/↓ navigate")
+		left = " " + m.s.Muted.Render("x uninstall • esc/q/"+fk(m.km.ManagePlugins)+" close • ↑/↓ navigate")
 	case ModePluginUninstall:
 		left = m.s.BadgeBad.Render(" UNINSTALL? ") + " " + m.s.Muted.Render("y/enter confirm • n/esc cancel")
 	default:
-		left = " " + m.s.Muted.Render("ctrl+p palette • n new • g reload plugins • d delete • ? help • 1-5 views")
+		left = " " + m.s.Muted.Render(
+			fk(m.km.Palette)+" palette • "+
+				fk(m.km.NewTask)+" new • "+
+				"g reload plugins • "+
+				fk(m.km.DeleteTask)+" delete • "+
+				fk(m.km.Help)+" help • "+
+				fk(m.km.ViewInbox)+"-"+fk(m.km.ViewPriority)+" views",
+		)
 	}
 
 	right := ""

internal/internal.zip

@@ -3,7 +3,8 @@ package help
 import (
 	"strings"
 
-	tea "github.com/charmbracelet/bubbletea"
+	"github.com/charmbracelet/bubbles/key"
+	"github.com/charmbracelet/bubbletea"
 	"github.com/charmbracelet/lipgloss"
 
 	"github.com/programmersd21/kairo/internal/ui/keymap"
@@ -50,6 +51,11 @@ func (m Model) View() string {
 
 	header := m.styles.Title.Render(" Help & Keybindings ")
 
+	// Helper to extract keys from binding
+	getK := func(b key.Binding) string {
+		return strings.Join(b.Keys(), ", ")
+	}
+
 	sections := []struct {
 		title string
 		keys  []struct {
@@ -60,31 +66,29 @@ func (m Model) View() string {
 		{
 			"Navigation",
 			[]struct{ key, desc string }{
-				{"1-5, Tab", "Switch views (Inbox, Today, etc.)"},
-				{"j/k, ↑/↓", "Move selection"},
-				{"enter", "Open task details"},
-				{"esc", "Back / Close"},
+				{getK(m.km.ViewInbox) + ", " + getK(m.km.ViewToday) + ", " + getK(m.km.ViewUpcoming) + ", " + getK(m.km.ViewTag) + ", " + getK(m.km.ViewPriority), "Switch views"},
+				{getK(m.km.OpenTask), "Open task details"},
+				{getK(m.km.Back), "Back / Close"},
 			},
 		},
 		{
 			"Tasks",
 			[]struct{ key, desc string }{
-				{"n", "New task"},
-				{"e", "Edit task"},
-				{"d", "Delete task"},
-				{"g", "Reload plugins"},
+				{getK(m.km.NewTask), "New task"},
+				{getK(m.km.EditTask), "Edit task"},
+				{getK(m.km.DeleteTask), "Delete task"},
 			},
 		},
 		{
 			"App",
 			[]struct{ key, desc string }{
-				{"ctrl+p", "Command palette"},
-				{"/", "Search tasks"},
-				{"t", "Theme menu"},
-				{"ctrl+g", "Open plugins folder"},
-				{"p", "Manage plugins"},
-				{"?", "Show help"},
-				{"q", "Quit"},
+				{getK(m.km.Palette), "Command palette"},
+				{getK(m.km.TaskSearch), "Search tasks"},
+				{getK(m.km.CycleTheme), "Theme menu"},
+				{getK(m.km.OpenPluginDir), "Open plugins folder"},
+				{getK(m.km.ManagePlugins), "Manage plugins"},
+				{getK(m.km.Help), "Show help"},
+				{getK(m.km.Quit), "Quit"},
 			},
 		},
 	}
@@ -95,7 +99,7 @@ func (m Model) View() string {
 	for _, s := range sections {
 		content = append(content, lipgloss.NewStyle().Bold(true).Foreground(m.styles.Theme.Accent).Padding(0, 1).Render(s.title))
 		for _, k := range s.keys {
-			keyStr := lipgloss.NewStyle().Foreground(m.styles.Theme.Good).Width(10).Render(k.key)
+			keyStr := lipgloss.NewStyle().Foreground(m.styles.Theme.Good).Width(15).Render(k.key)
 			descStr := m.styles.Muted.Render(k.desc)
 			content = append(content, lipgloss.NewStyle().Padding(0, 2).Render(keyStr+" "+descStr))
 		}