Frequently Asked QuestionAs

If the Beaconly icon is missing from your menu bar:

1. Check if Beaconly is running - Look for it in Activity Monitor or your Applications folder
2. Menu bar overflow - If you have many menu bar apps, the icon might be hidden. Try clicking the arrow or removing some apps
3. Menu bar management apps - Apps like Bartender or Hidden Bar might be hiding Beaconly. Check their settings
4. Restart Beaconly - Quit and relaunch the app from Applications
5. Check Login Items - Ensure Beaconly is set to launch at login in System Settings > General > Login Items

If the issue persists, try reinstalling Beaconly from the Mac App Store.

You can install Beaconly directly from the Mac App Store:

1. Open the Mac App Store on your Mac
2. Search for “Beaconly”
3. Click Get or Download
4. Once installed, open Beaconly from your Applications folder

After launching, Beaconly will appear in your menu bar as a small icon. Click it to start adding extensions and customizing your workflow.

Extensions are mini-apps that live inside Beaconly and connect to your favorite services. Each extension:

• Fetches data from a specific service (like Jira, GitHub, or Asana)
• Displays updates directly in your menu bar
• Shows notifications for important events
• Provides quick access to relevant links and actions

Think of extensions as widgets that bring your most important work information right to your menu bar, without needing to switch between different apps and browser tabs.

Free Plan:

• Up to 3 extensions
• Basic notification support
• Standard refresh intervals
• Community support

Premium Plan:

• Unlimited extensions
• Priority notifications with custom sounds
• Faster refresh rates for real-time updates
• Custom extensions (API, RSS, Webhooks)
• Priority support
• Early access to new features

The free plan is great for trying Beaconly or if you only need a few key integrations. Premium unlocks the full power of Beaconly for power users and teams.

If an extension shows stale or outdated data:

1. Manual refresh - Click the extension and look for a refresh button
2. Check internet connection - Extensions need connectivity to fetch updates
3. Re-authenticate - Your session may have expired:
   • Right-click the extension
   • Select “Reconnect” or “Sign In Again”
4. Check refresh settings - Verify the extension’s refresh interval in settings
5. Service status - The third-party service might be experiencing issues
6. Restart Beaconly - A quick restart often resolves temporary glitches

For persistent issues, try removing and reinstalling the extension.

Installing an extension from the gallery is simple:

1. Click the Beaconly icon in your menu bar
2. Click the + button to open the extension gallery
3. Browse or search for the extension you want
4. Click Install on the extension card
5. Authenticate with the service when prompted (this securely connects your account)
6. Configure any optional settings for the extension

Your extension will start working immediately after installation and authentication.

Managing your subscription is easy through the Mac App Store:

To Upgrade:

1. Open Beaconly
2. Go to Preferences (or Settings)
3. Click “Upgrade to Premium”
4. Complete the purchase through the App Store

To Downgrade:

1. Open the App Store app
2. Go to your Account Settings
3. Find Subscriptions and select Beaconly
4. Choose to cancel or switch to a lower tier

When downgrading, your premium features remain active until the end of your current billing period.

Beaconly requires:

• macOS 14.0 (Sonoma) or later
• Apple Silicon (M1/M2/M3) or Intel based Mac
• Internet connection for fetching data from your integrated services

Beaconly is optimized for both Apple Silicon and Intel-based Macs, providing native performance on either platform.

Refunds for Beaconly are handled through the Mac App Store:

• Apple handles all billing and refunds for App Store purchases
• To request a refund, visit Apple’s refund request page
• Refunds are typically processed within 48-72 hours

We recommend trying the free version first to make sure Beaconly fits your workflow before upgrading to premium.

Adding your first extension is quick and easy:

1. Click the Beaconly icon in your menu bar
2. Click the + button (or “Add Extension”)
3. Browse the extension gallery to find the service you want
4. Click Install on your chosen extension
5. Follow the authentication prompts to connect your account

Once connected, your extension will start displaying data immediately. You can add as many extensions as you need to build your perfect dashboard.

Authentication errors usually mean your connection to a service needs refreshing:

1. Reconnect the extension:

   • Right-click the extension showing the error
   • Select “Reconnect” or “Sign In Again”
   • Complete the authentication flow

2. Check for password changes - If you changed your password on the service (e.g., GitHub), you’ll need to re-authenticate

3. Revoke and re-authorize:

   • Go to the service’s settings (e.g., GitHub Settings > Applications)
   • Revoke Beaconly’s access
   • Reconnect through Beaconly

4. Check for organization restrictions - Some workplace accounts may restrict third-party app access. Contact your IT admin if needed.

Connecting your work services is straightforward:

1. Install the extension for your service from the gallery
2. When prompted, click “Connect” or “Sign In”
3. You’ll be redirected to the service’s login page
4. Sign in with your account credentials
5. Authorize Beaconly to access your data
6. You’ll be redirected back to Beaconly automatically

The connection uses OAuth 2.0 for most services, which means your credentials are never stored by Beaconly. Each service only grants the minimum permissions needed to display your data.

We’re here to help! You can reach support through:

• Email: Send detailed questions to our support team
• In-App Feedback: Use the “Send Feedback” option in Beaconly’s Help menu
• Website: Visit beaconly.app/contact for our contact form

For faster support, please include:

• Your macOS version
• Beaconly version (found in Beaconly > About Beaconly)
• A description of the issue
• Steps you’ve already tried
• Any error messages you’ve seen

Premium users receive priority support with faster response times.

Yes! Choosing annual billing saves you money:

• Monthly subscription: Pay month-to-month at the standard rate
• Annual subscription: Save up to 20% compared to monthly billing

Annual subscriptions are billed once per year and automatically renew unless cancelled. You can switch between billing periods at any time through your App Store subscription settings.

Beaconly lives in your menu bar at the top of your screen. After installation:

• Look for the Beaconly icon (a small beacon/lightning symbol) on the right side of your menu bar
• Click the icon to open the Beaconly panel
• The panel shows all your installed extensions and their data

If you don’t see the icon, make sure Beaconly is running. You can also check your menu bar settings if you use any menu bar management apps that might hide icons.

Yes! You can connect multiple accounts for the same service:

1. Install the extension for the service (if not already installed)
2. Click the + button and select the same extension again
3. Authenticate with your second account
4. Each account will appear as a separate extension instance

This is useful if you have:

• Personal and work GitHub accounts
• Multiple Jira workspaces
• Different Asana teams

Each instance maintains its own settings and displays its own data independently.

To remove an extension:

1. Click the Beaconly icon to open the panel
2. Right-click (or Control-click) on the extension you want to remove
3. Select “Remove Extension”
4. Confirm the removal

To reorder extensions:

1. Click and drag any extension card
2. Drop it in your preferred position
3. The order is saved automatically

Your extension order persists across app restarts, so you can organize your dashboard exactly how you like it.

If an extension isn’t showing data, try these steps:

1. Check your internet connection - Extensions need connectivity to fetch data
2. Re-authenticate - Your access token may have expired:
   • Right-click the extension
   • Select “Reconnect” or “Sign In Again”
3. Check the service status - The third-party service might be experiencing downtime
4. Review extension settings - Make sure filters and queries are configured correctly
5. Restart Beaconly - Sometimes a fresh start resolves temporary issues

If problems persist, check our troubleshooting section or contact support.

Yes, security is a top priority for Beaconly:

• OAuth 2.0 Authentication - We never see or store your passwords
• Encrypted Storage - All tokens and credentials are stored in your Mac’s secure Keychain
• Local Processing - Data is fetched and displayed locally on your Mac
• No Server Storage - Your data is never transmitted to Beaconly servers
• Minimal Permissions - We only request the minimum access needed

Beaconly acts as a secure bridge between your Mac and your services. Your sensitive information stays on your device and is protected by macOS security features.