feat: Add pagination to the repository list view with page indicators… (#10)

* feat: Add pagination to the repository list view with page indicators and navigation controls.

* feat: document pagination feature and its corresponding keybindings in the README

Author: Bharath-code

README.md

@@ -83,6 +83,7 @@ git-scope -h           # Show help
   * **📁 Workspace Switch** — Switch root directories without quitting (`w`). Supports `~`, relative paths, and **symlinks**.
   * **🔍 Fuzzy Search** — Find any repo by name, path, or branch (`/`).
   * **🛡️ Dirty Filter** — Instantly show only repos with uncommitted changes (`f`).
+  * **📄 Pagination** — Navigate large repo lists with page-by-page browsing (`[` / `]`). Shows 15 repos per page with a dynamic page indicator.
   * **🚀 Editor Jump** — Open the selected repo in VSCode, Neovim, Vim, or Helix (`Enter`).
   * **⚡ Blazing Fast** — JSON caching ensures \~10ms launch time even with 50+ repos.
   * **📊 Dashboard Stats** — See branch name, staged/unstaged counts, and last commit time.
@@ -102,6 +103,7 @@ git-scope -h           # Show help
 | `f` | **Filter** (Cycle: All / Dirty / Clean) |
 | `s` | Cycle **Sort** Mode |
 | `1`–`4` | Sort by: Dirty / Name / Branch / Recent |
+| `[` / `]` | **Page Navigation** (Previous / Next) |
 | `Enter` | **Open** repo in Editor |
 | `c` | **Clear** search & filters |
 | `r` | **Rescan** directories |

internal/tui/model.go

@@ -74,6 +74,9 @@ type Model struct {
 	// Star nudge state
 	showStarNudge         bool
 	nudgeShownThisSession bool
+	// Pagination state
+	currentPage int
+	pageSize    int
 }
 
 // NewModel creates a new TUI model
@@ -143,6 +146,8 @@ func NewModel(cfg *config.Config) Model {
 		state:          StateLoading,
 		sortMode:       SortByDirty,
 		filterMode:     FilterAll,
+		currentPage:    0,
+		pageSize:       15,
 	}
 }
 
@@ -157,9 +162,13 @@ func (m Model) GetSelectedRepo() *model.Repo {
 		return nil
 	}
 
+	// Get the cursor position within the current page
 	cursor := m.table.Cursor()
-	if cursor >= 0 && cursor < len(m.sortedRepos) {
-		return &m.sortedRepos[cursor]
+	// Calculate the actual index in sortedRepos
+	actualIndex := m.currentPage*m.pageSize + cursor
+	
+	if actualIndex >= 0 && actualIndex < len(m.sortedRepos) {
+		return &m.sortedRepos[actualIndex]
 	}
 	return nil
 }
@@ -230,7 +239,50 @@ func (m *Model) sortRepos() {
 func (m *Model) updateTable() {
 	m.applyFilter()
 	m.sortRepos()
-	m.table.SetRows(reposToRows(m.sortedRepos))
+	m.table.SetRows(reposToRows(m.getCurrentPageRepos()))
+}
+
+// getTotalPages returns the total number of pages
+func (m Model) getTotalPages() int {
+	if len(m.sortedRepos) == 0 {
+		return 1
+	}
+	return (len(m.sortedRepos) + m.pageSize - 1) / m.pageSize
+}
+
+// getCurrentPageRepos returns repos for the current page
+func (m Model) getCurrentPageRepos() []model.Repo {
+	if len(m.sortedRepos) == 0 {
+		return []model.Repo{}
+	}
+	
+	start := m.currentPage * m.pageSize
+	end := start + m.pageSize
+	
+	if start >= len(m.sortedRepos) {
+		start = 0
+		end = m.pageSize
+	}
+	if end > len(m.sortedRepos) {
+		end = len(m.sortedRepos)
+	}
+	
+	return m.sortedRepos[start:end]
+}
+
+// canGoPrev returns true if there's a previous page
+func (m Model) canGoPrev() bool {
+	return m.currentPage > 0
+}
+
+// canGoNext returns true if there's a next page
+func (m Model) canGoNext() bool {
+	return m.currentPage < m.getTotalPages()-1
+}
+
+// resetPage resets pagination to first page
+func (m *Model) resetPage() {
+	m.currentPage = 0
 }
 
 // GetSortModeName returns the display name of current sort mode

internal/tui/update.go

@@ -37,6 +37,7 @@ func (m Model) Update(msg tea.Msg) (tea.Model, tea.Cmd) {
 	case scanCompleteMsg:
 		m.repos = msg.repos
 		m.state = StateReady
+		m.resetPage()
 		m.updateTable()
 
 		// Show helpful message if no repos found
@@ -57,6 +58,7 @@ func (m Model) Update(msg tea.Msg) (tea.Model, tea.Cmd) {
 	case workspaceScanCompleteMsg:
 		m.repos = msg.repos
 		m.state = StateReady
+		m.resetPage()
 		m.updateTable()
 
 		// Show helpful message about switched workspace
@@ -186,6 +188,7 @@ func (m Model) Update(msg tea.Msg) (tea.Model, tea.Cmd) {
 			// Cycle through filter modes
 			if m.state == StateReady {
 				m.filterMode = (m.filterMode + 1) % 3
+				m.resetPage()
 				m.updateTable()
 				m.statusMsg = "Filter: " + m.GetFilterModeName()
 				return m, nil
@@ -194,6 +197,7 @@ func (m Model) Update(msg tea.Msg) (tea.Model, tea.Cmd) {
 		case "s":
 			if m.state == StateReady {
 				m.sortMode = (m.sortMode + 1) % 4
+				m.resetPage()
 				m.updateTable()
 				m.statusMsg = "Sorted by: " + m.GetSortModeName()
 				return m, nil
@@ -202,6 +206,7 @@ func (m Model) Update(msg tea.Msg) (tea.Model, tea.Cmd) {
 		case "1":
 			if m.state == StateReady {
 				m.sortMode = SortByDirty
+				m.resetPage()
 				m.updateTable()
 				m.statusMsg = "Sorted by: Dirty First"
 				return m, nil
@@ -210,6 +215,7 @@ func (m Model) Update(msg tea.Msg) (tea.Model, tea.Cmd) {
 		case "2":
 			if m.state == StateReady {
 				m.sortMode = SortByName
+				m.resetPage()
 				m.updateTable()
 				m.statusMsg = "Sorted by: Name"
 				return m, nil
@@ -218,6 +224,7 @@ func (m Model) Update(msg tea.Msg) (tea.Model, tea.Cmd) {
 		case "3":
 			if m.state == StateReady {
 				m.sortMode = SortByBranch
+				m.resetPage()
 				m.updateTable()
 				m.statusMsg = "Sorted by: Branch"
 				return m, nil
@@ -226,6 +233,7 @@ func (m Model) Update(msg tea.Msg) (tea.Model, tea.Cmd) {
 		case "4":
 			if m.state == StateReady {
 				m.sortMode = SortByLastCommit
+				m.resetPage()
 				m.updateTable()
 				m.statusMsg = "Sorted by: Recent"
 				return m, nil
@@ -237,6 +245,7 @@ func (m Model) Update(msg tea.Msg) (tea.Model, tea.Cmd) {
 				m.searchQuery = ""
 				m.textInput.SetValue("") // Also reset the text input
 				m.filterMode = FilterAll
+				m.resetPage()
 				m.resizeTable()
 				m.updateTable()
 				m.statusMsg = "Filters cleared"
@@ -316,6 +325,24 @@ func (m Model) Update(msg tea.Msg) (tea.Model, tea.Cmd) {
 				m.workspaceError = ""
 				return m, textinput.Blink
 			}
+
+		case "[":
+			// Previous page
+			if m.state == StateReady && m.canGoPrev() {
+				m.currentPage--
+				m.updateTable()
+				m.statusMsg = fmt.Sprintf("Page %d of %d", m.currentPage+1, m.getTotalPages())
+				return m, nil
+			}
+
+		case "]":
+			// Next page
+			if m.state == StateReady && m.canGoNext() {
+				m.currentPage++
+				m.updateTable()
+				m.statusMsg = fmt.Sprintf("Page %d of %d", m.currentPage+1, m.getTotalPages())
+				return m, nil
+			}
 	}
 	}
 
@@ -347,6 +374,7 @@ func (m Model) handleSearchMode(msg tea.KeyMsg) (tea.Model, tea.Cmd) {
 		m.state = StateReady
 		m.resizeTable()
 		m.textInput.Blur()
+		m.resetPage()
 		m.updateTable()
 		if m.searchQuery != "" {
 			m.statusMsg = "Searching: " + m.searchQuery

internal/tui/view.go

@@ -253,6 +253,18 @@ func (m Model) renderStats() string {
 	sortHint := hintStyle.Render(" (s)")
 	stats = append(stats, sortBadge+sortHint)
 
+	// Pagination indicator (only show if more than one page)
+	totalPages := m.getTotalPages()
+	if totalPages > 1 {
+		pageBadge := lipgloss.NewStyle().
+			Foreground(lipgloss.Color("#FFFFFF")).
+			Background(lipgloss.Color("#10B981")).
+			Padding(0, 1).
+			Render(fmt.Sprintf("📄 %d/%d", m.currentPage+1, totalPages))
+		pageHint := hintStyle.Render(" ([])") 
+		stats = append(stats, pageBadge+pageHint)
+	}
+
 	return lipgloss.JoinHorizontal(lipgloss.Center, stats...)
 }
 
@@ -299,6 +311,7 @@ func (m Model) renderHelp() string {
 		// Normal mode help - Tuimorphic style
 		items = []string{
 			keyBinding("↑↓", "nav"),
+			keyBinding("[]", "page"),
 			keyBinding("enter", "open"),
 			keyBinding("/", "search"),
 			keyBinding("w", "workspace"),