lazysupabase

README

lazysupabase

A keyboard-driven terminal UI for the entire Supabase platform.

Inspired by lazygit and lazydocker — manage your Supabase projects from one beautiful TUI without ever opening the dashboard.

[!WARNING] lazysupabase is pre-alpha (v0.1). The TUI shell, project picker, and Settings tab call the real Supabase Management API. Database, Auth, Storage, Functions, Realtime, and Logs tabs currently render dummy data so the UX can be iterated visually before each tab is wired to its real backend. See the roadmap.

✨ Features

Tab	Status	Description
🗄️ Database	dummy data	Browse tables, run SQL, edit rows
🔐 Auth	dummy data	List users, manage providers, sessions
📦 Storage	dummy data	Browse buckets, files, preview images
⚡ Functions	dummy data	List, deploy, invoke, tail edge functions
📡 Realtime	dummy data	Inspect channels and presence
📜 Logs	dummy data	Live tail across every Supabase service
⚙️ Settings	real API	Project info, region, status, masked API keys

Other goodies:

• 🟢 Multi-project — switch between Supabase projects with one keystroke
• 🔑 Secure auth — your Supabase Personal Access Token is stored in the OS keychain
• ⌨️ Vim keys — j/k, / to filter, [/] to jump panes, ? for help
• 📋 OSC 52 clipboard — c to copy values from any pane (works over SSH/tmux)
• 🎨 Charm-native — Bubble Tea, Bubbles, Lip Gloss, Huh, Fang, Glamour

📦 Install

Go

go install github.com/Joselay/lazysupabase/cmd/lazysupabase@latest

Pre-built binaries

Grab the latest release for your platform from the releases page. Binaries are built for darwin/{amd64,arm64}, linux/{amd64,arm64}, and windows/amd64.

From source

git clone https://github.com/Joselay/lazysupabase.git
cd lazysupabase
make install   # builds + installs lazysupabase and lzs alias

Homebrew tap (brew install Joselay/tap/lazysupabase) is on the v0.2 roadmap.

🚀 Quick start

1. Create a Supabase Personal Access Token at supabase.com/dashboard/account/tokens
2. Save it: lazysupabase login (or set SUPABASE_ACCESS_TOKEN in your environment)
3. Launch the TUI: lazysupabase (or the short alias lzs)
4. Pick a project, then press 1–7 to explore the tabs

⌨️ Keybindings

Global

Key	Action
1–7	Switch to tab N
tab / shift+tab	Next / previous tab
?	Help
q / ctrl+c	Quit

Inside a tab

Key	Action
j / k	Move down / up
h / l	Page or move horizontally
g / G	Top / bottom
[ / ]	Previous / next pane
/	Filter
r	Reveal masked values (Settings tab)
c	Copy to clipboard (Settings tab)
R	Refresh

⚙️ Configuration

Item	Location
Config file	$XDG_CONFIG_HOME/lazysupabase/config.toml (typically ~/.config/lazysupabase/config.toml)
Access token	OS keychain (macOS Keychain, Linux Secret Service, Windows Credential Manager)
Token override	SUPABASE_ACCESS_TOKEN environment variable

Run lazysupabase config path to print the exact config file location.

🛣️ Roadmap

• v0.1 — TUI shell, project picker, real Settings tab, all 7 tabs visually complete (this release)
• v0.1.x — Wire Database, Auth, Storage, Logs tabs to their real APIs
• v0.2 — Edge Functions tab + Homebrew tap
• v0.3 — RLS policy editor, advisors, branches
• v0.4 — Image previews in the Storage tab (sixel / Kitty graphics)
• v0.5 — Realtime channel inspector with live event stream

See the releases page for what's already shipped.

🛠️ Development

make help        # list every target
make run         # go run ./cmd/lazysupabase
make build       # build into bin/
make test        # go test -race ./...
make lint        # golangci-lint run
make tidy        # go mod tidy
make clean       # remove bin/ and dist/

Requires Go 1.25+. The project uses no CGO; everything cross-compiles cleanly.

Project layout

cmd/lazysupabase/      # entry point (fang + cobra)
internal/
  cli/                 # subcommands: login, config, version
  config/              # XDG config TOML
  fake/                # seeded gofakeit wrapper for dummy data
  keyring/             # OS keychain + env-var fallback
  supabase/            # Supabase Management API client
  theme/               # lipgloss colors + named styles
  tui/                 # Bubble Tea root model
    header.go          # top header bar
    tabbar.go          # tab strip
    statusbar.go       # bottom status bar
    projects/          # project picker
    tabs/              # one package per tab
    uikit/             # shared rendering helpers

🤝 Contributing

PRs are warmly welcomed — see CONTRIBUTING.md for the development workflow, conventional-commit format, and the "wire one tab to a real backend" good-first-issue list.

If you find a security issue, please open a private advisory instead of a public issue.

🙏 Built with

• Charm — Bubble Tea, Bubbles, Lip Gloss, Huh, Fang, Glamour
• pgx — Go Postgres driver
• gofakeit — fake data generator
• Supabase Management API

📄 License

MIT © Joselay