Better GitHub

A GitHub homepage that actually shows what you care about.

The default front page is a social network homepage. This one isn't. See your PRs, reviews, issues, checks, and alerts in a clean view.

Connect with GitHub View on GitHub

Better GitHub: a cleaner GitHub homepage with actionable widgets

Every action opens the right page on github.com.

Simple setup

Connect with Github

Ready in seconds

Privacy first

Read-only access

PRs, issues, reviews

Just works

Lightweight

Opens fast, stays out of the way

A homepage that gets out of the way

No social feed, chatbot and issues/PRs shoved on the side.

Your stuff, first

See your PRs, reviews, and assigned issues right away. No digging, no noise.

Checks & alerts at a glance

Quick view of failing checks, running workflows, and security alerts when they matter.

Calm notifications

Trim the chatter. Get the conversations you actually care about.

Clean layout

Easy to scan on any screen - phone, laptop, or ultrawide.

One-click jump

Every row links straight to the right place on github.com.

No lock-in

It's just a nicer homepage. Keep using GitHub the same way.

A cleaner start to your GitHub day.

From “meh” to “oh nice”

GitHub's front page is An Attempt. This one's just easier on the eyes, and faster to act from.

Direct deep links

Open the exact PR, issue, workflow run, or alert on GitHub.

Clear, compact view

Skimmable cards and lists without the clutter.

Read-only permissions

Demo

How it works

1. Connect with GitHub

2. Get your view

We fetch your GitHub data and lay it out clearly.

3. Click and go

Open anything on GitHub in a single click. Same workflow, nicer starting point.

Self-hosting

Run it yourself

Deploy with Docker using just two environment variables.

Prerequisites

GitHub OAuth App

Callback URL:

https://YOUR_DOMAIN/github/callback

Docker (recommended) or Bun/Node runtime (npm).

Required Environment Variables

.env

GITHUB_OAUTH_CLIENT_ID=Iv1.XXXXXXXX
GITHUB_OAUTH_SECRET=your_oauth_secret_here

Quick Start

docker-compose.yml

services:
  better-github:
    image: ghcr.io/dasporal/better-github:latest
    ports:
      - "1451:1451"
    environment:
      GITHUB_OAUTH_CLIENT_ID: {GITHUB_OAUTH_CLIENT_ID}
      GITHUB_OAUTH_SECRET: {GITHUB_OAUTH_SECRET}

Then run:

docker compose up -d

.env

GITHUB_OAUTH_CLIENT_ID=Iv1.XXXXXXXX
GITHUB_OAUTH_SECRET=your_oauth_secret_here

Dev

npm install
npm run dev

Build

npm run build
npm run preview

Routing & App URLs

App URL

https://YOUR_DOMAIN

OAuth Callback

https://YOUR_DOMAIN/github/callback

Proxy Configuration

When using a reverse proxy (Nginx/Caddy), ensure you forward X-Forwarded-Proto and X-Forwarded-Host headers if you terminate TLS upstream.

Try Locally Deploy to Vercel

FAQ

Quick answers