Getting Started

Welcome to HighFly! This guide will help you get started with the platform.

Overview

HighFly is a project management and issue tracking platform designed to help teams collaborate effectively. With HighFly, you can:

• Organize your work with Organizations and Teams
• Track and manage Issues with status, priority, assignees, and labels
• Collaborate through Comments and Notifications
• Integrate with GitHub for seamless development workflows
• Use Editor Extensions (VS Code, Cursor, Windsurf) for a native development experience

Authentication

HighFly supports multiple authentication methods to get you started quickly, such as Google or email and password.

Editor Extensions Authentication

HighFly extensions are available for VS Code, Cursor, and Windsurf. To authenticate:

1. Install the HighFly extension from your editor's marketplace
2. Open the extension and click "Sign In"
3. You'll be redirected to your browser to authenticate with your HighFly account
4. Once authenticated, you'll be automatically redirected back to your editor
5. The extension will then establish your session

The authentication flow uses a secure token exchange system that ensures your credentials are never exposed to the extension.

GitHub Authentication

HighFly offers two types of GitHub authentication:

GitHub App for Organizations

Organizations can install the HighFly GitHub App to enable organization-wide Github integration:

1. Navigate to your organization settings
2. Go to the GitHub integration section
3. Click "Install GitHub App"
4. Select the GitHub organization you want to connect
5. Authorize the app with the required permissions
6. The app will be linked to your HighFly organization

Once installed, the GitHub App enables:

• Webhook events for PR status updates, comments, and reviews
• Organization-wide repository access

Personal GitHub Account Linking

Individual users can link their personal GitHub account to their HighFly profile:

1. Go to your Connected Accounts settings
2. Navigate to the GitHub integration section
3. Click "Connect"
4. Authorize HighFly to access your GitHub account
5. Your account will be linked and you can use GitHub features in HighFly

This allows you to:

• Auto link your pull requests to HighFly issues
• See your GitHub activity in HighFly

Next Steps

Now that you're authenticated, you can:

• Create or join an Organization
• Set up Teams
• Start tracking Issues
• Configure GitHub Integration
• Install Editor Extensions