Kepler – Kubernetes Enhancement Proposal Explorer

A web application for exploring Kubernetes Enhancement Proposals (KEPs) and Gateway API Enhancement Proposals (GEPs).

Features

Browsing & Navigation

• 📋 Browse KEPs and GEPs fetched live from their respective GitHub repositories
• 🔀 Grid and table views — toggle between card grid and sortable table layout
• 📄 Detail view showing full metadata: authors, reviewers, approvers, milestones, rendered README, related PRs with CI/review status, and links to GitHub
• ⌨️ Keyboard navigation — use arrow keys to move between proposals and B to bookmark
• 🗓️ Release timeline — see which KEPs were introduced or graduated per Kubernetes release

Search & Filtering

• 🔍 Search by title, KEP/GEP number, or author
• 🎛️ Filter by SIG, status (provisional, implementable, implemented, etc.), and stage (alpha, beta, stable)
• 🏷️ Stale indicator for proposals not updated in over a year

Analytics

• 📊 Statistics dashboard with charts for:
  • SIG distribution and creation timeline
  • Status breakdown and stage funnel
  • Time-to-stable histogram and milestone heatmap
  • Top contributors

Personalization

• 🔖 Bookmarks saved to localStorage for KEPs and GEPs
• 🌙 Dark/light theme toggle persisted to localStorage
• ⚡ Client-side caching in localStorage (6-hour TTL) to avoid re-fetching on subsequent visits
• 🕐 "What's New" sidebar showing recently changed proposals from Git history

General

• 📱 Responsive layout that works on mobile and desktop

Development

npm install
npm run dev

Build

npm run build
npm run start

Tech Stack

• Next.js with App Router
• React + TypeScript
• js-yaml for parsing KEP/GEP YAML metadata
• react-markdown + remark-gfm for rendering proposal READMEs
• Recharts for analytics charts
• GitHub REST API + raw.githubusercontent.com for data fetching