Kepler – Kubernetes Enhancement Proposal Explorer

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

Features

Browsing & Navigation

• 📋 Browse KEPs, GEPs and CAEPs 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, GEPs and CAEPs
• 🌙 Dark/light theme toggle persisted to localStorage
• 🔑 Optional GitHub token — paste a fine-grained token (public repositories, read-only) to raise the GitHub API limit from 60 to 5,000 requests per hour; it's stored only in your browser and sent only to api.github.com
• ⚡ Prebuilt data, refreshed every 3 hours, with client-side caching in localStorage and a live fallback
• 🕐 "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

Prebuilt data

The deployed site serves proposal data prebuilt during deployment (public/data/*.json), refreshed every 3 hours by a scheduled workflow, so visitors don't have to fetch it from GitHub. To use the same data locally, run:

GITHUB_TOKEN=$(gh auth token) npm run fetch-data   # token optional, raises the rate limit

Without it, the app fetches everything live from GitHub, as it does when a snapshot is missing or more than a day old.

Build

npm run build
npm run start

Tech Stack

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