🍺 A modern web application to search, explore and manage Homebrew packages.
- 🔍 Smart Search - Fuzzy search by name and description with relevance ranking
- 📦 Package Categories - Browse Formulae and Casks separately
- 📋 One-click Copy - Quickly copy install commands
- 🔗 Dependency Graph - View and navigate package dependencies with breadcrumb trail
- 💾 Offline Support - Local IndexedDB caching with 48-hour auto-refresh
- ⭐ Favorites & Tags - Organize packages with favorites and custom tags
- ⌨️ Full Keyboard Support - Navigate entirely with keyboard shortcuts
- 🌓 Dark Mode - Light, dark, and system theme support
- 📱 Responsive Design - Works on desktop and mobile devices
- 📲 PWA Support - Install as a native app on desktop and mobile
| Syntax | Description | Example |
|---|---|---|
text |
Search by name and description | react |
#tag |
Filter by tag | #frontend |
* |
Show only favorites | * |
| Combined | Combine multiple filters | react #tool |
| Combined | Search favorites with text | * node |
| Key | Action |
|---|---|
⌘K or / |
Open search |
Esc |
Close dialog / Go home |
| Key | Action |
|---|---|
Shift+H |
Go to Home |
Shift+F |
Go to Favorites |
Shift+T |
Go to Tags |
| Key | Action |
|---|---|
d |
Toggle theme |
w |
Toggle page width |
x |
Toggle hide deprecated |
r |
Refresh data |
? |
Show help |
| Key | Action |
|---|---|
1 2 3 |
Filter type |
[ / ] |
Previous / Next page |
Shift+[ |
First page |
↑↓←→ or hjkl |
Navigate cards |
Enter |
Open package |
f |
Toggle favorite |
t |
Add tag |
| Key | Action |
|---|---|
⌫ |
Go back |
f |
Toggle favorite |
t |
Add tag |
o |
Open homepage |
c |
Copy install command |
- Node.js 18+
- pnpm
# Clone the repository
git clone https://github.com/dofy/brew-graph.git
cd brew-graph
# Install dependencies
pnpm install
# Start development server
pnpm devpnpm buildpnpm previewBrew Graph is a Progressive Web App (PWA) that can be installed on your device:
- Desktop (Chrome/Edge): Click the install icon in the address bar
- iOS Safari: Tap Share → "Add to Home Screen"
- Android Chrome: Tap menu → "Install app"
Once installed, the app works offline with cached data.
- Framework: React 19 + TypeScript
- Build Tool: Vite 7
- Styling: Tailwind CSS 4 + shadcn/ui
- State Management: Zustand
- Local Database: Dexie.js (IndexedDB)
- Routing: React Router 7
- Icons: Lucide React
- PWA: vite-plugin-pwa + Workbox
Package data is fetched from the official Homebrew Formulae API.
This project is configured for deployment on Vercel. Simply connect your GitHub repository to Vercel for automatic deployments.
MIT License © 2026 Seven Yu
Powered by yahaha.net | phpz.xyz