/TinyTriangle

A macOS menu bar app for those who spend too much time with Vercel

Primary LanguageTypeScriptMIT LicenseMIT

Tiny Triangle

For those of us who spend far too much time working with Vercel, or if you just really want a triangle in your top bar, this is the app for you.

image

Tiny triangle is a macOS menu bar app for Vercel, it's designed to give you quick access to your projects, settings, extensions, and notifications.

Using Tiny Triangle

Setting your token

Go to ~/.config/TinyTriangle/config.txt and add your Vercel token to the empty file like so:

VGKgqonb4BQed30f3KLcM9dQ

Features

Quick Links

Organizations; Base level, Settings, Integrations, & Usage.

Projects; Base level, Settings, Analytics, Logs, & Deployments.

User; Account Settings Shift S & Dashboard Shift + D.

Settings

Persistant Config; Save your preferences across reboots.

Organization & Project Quick Links; Configure which if any quick links are shown for projects and organizations.

Token; Set your Vercel API Token, currently UI for this is under development.

Other

Auto Sync; Automatically resync with Vercel every five minutes in the background.

Unread Comments; Icon changes to alert you to any unread comments on your projects and then shows the relevant team with a bell icon.

Restart & Quit; Simple utilities for restarting or quitting the application on CMD + R or Q.

Bug Reporting; Quick open to GitHub issues or support email to report issues.

Development

Step 1: Install Dependencies

First you need to install your node dependencies. From the root of TinyTriangle, run the following command:

bun install

Then to configure the pods dependencies for the native macOS code run:

bunx pod-install

Step 2: Start the Metro Server

First, you will need to start Metro, the JavaScript bundler that ships with React Native.

To start Metro, run the following command from the root of TinyTriangle:

bun start

Step 3: Start tiny Triangle

Let Metro Bundler run in its own terminal. Open a new terminal from the root of TinyTriangle and run the following command:

bun macos

If everything is set up correctly you should see a small triangle appear in your menu bar which will contain a list of your Vercel projects, your account, and more.

Troubleshooting

  • Confirm you have node 20 or later installed
  • Confirm you have Xcode installed
  • Make sure you have ruby 3.0.0 or later installed
  • Make sure you have bun installed

Current Issues

  • Quit does not seem to work reliably
  • jest test fails over MacOS only for MenuBar imports

Future Features

  • Notifications partially supported
  • Token set UI *
  • Multi account support
  • Better error handling
  • App Icon
  • Prebuilt binaries
  • Eslint Flat Config