GitHub

GitHub is where development happens. FeatureOS is where customer feedback lives. With the GitHub + FeatureOS integration, you can finally connect the two, ensuring that product managers and developers stay aligned at every step.

This integration lets you create GitHub issues from FeatureOS posts, link existing issues, and set up automatic push and two-way sync rules. The result: customer requests turn into tracked development tasks, and updates flow back into FeatureOS to keep your team and customers informed.

Getting Started with GitHub + FeatureOS

1. In FeatureOS: Go to Dashboard → Organization Settings → Integrations → GitHub → Connect.
2. Sign in to your GitHub account and authorize FeatureOS.
   • Choose whether to connect all repositories or select specific ones.
   • Make sure the admin who sets this up has access to all required repositories.
   • Avoid selecting forked repositories.
3. Once authorized, you’ll be redirected back to FeatureOS with the integration details (connected GitHub org and user profile).

Configuring Automatic Push to GitHub

• Enable Automatic Push to GitHub to send FeatureOS posts to GitHub issues based on status changes.
• Options:
  • Push posts immediately after submission.
  • Push after moderation approval.
• Choose one or more FeatureOS boards as triggers.

Setting Up Status Sync Rules

Create rules to sync statuses between FeatureOS posts and GitHub issues:

• When any linked issue changes status, update the FeatureOS post.
• When all linked issues change status, update the FeatureOS post.
• When a FeatureOS post changes status, update linked GitHub issues.

Save your rules, and updates will stay in sync both ways.

How the Integration Works

1. Create GitHub Issues
   • From a FeatureOS post, click Push to GitHub.
   • Edit Title/Description → select Repository → click Push.
   • A GitHub issue is created, with the FeatureOS post linked automatically.
2. Link Existing GitHub Issues
   • From a FeatureOS post, click Link Issue.
   • Search by title or ID → link the issue.
   • Links are two-way between FeatureOS and GitHub.
3. Unlink Issues
   • Click the unlink icon in FeatureOS to remove the association (issue remains in GitHub).
4. Manage Repository Access
   • Change repository access anytime in your GitHub Settings → Applications → Configure FeatureOS.
5. Disconnect
   • Go to FeatureOS → Organization Settings → Integrations → GitHub → Configure → Disconnect.

Why This Helps

• Product managers: Track feature development directly from FeatureOS.
• Developers: Work in GitHub while staying connected to customer context.
• Customers: Stay updated as their requests move through development.