Skip to main content

​
Welcome to Bounty

This guide will walk you through creating an account and either posting your first bounty or browsing available opportunities.
1

Create Your Account

Navigate to bounty.new and sign up with GitHub OAuth.
GitHub authentication is required as it enables seamless integration with repositories and pull requests.
The platform uses Better Auth for secure authentication with support for:
  • GitHub OAuth
  • Email/password authentication
  • Passkey support for passwordless login
2

Complete Onboarding

After signing up, you’ll go through a brief onboarding process:
  1. Choose your role (Contributor or Project Owner)
  2. Set up your profile
  3. Optionally create your first organization
Organizations allow you to manage team bounties with multiple members. You can create one during onboarding or later from your dashboard.
3

Choose Your Path

​
Browse and Apply to Bounties

Navigate to the Bounties page to see all available opportunities.Filter Options:
  • By status: open, in_progress, completed
  • By price range
  • By tags/technology
  • By deadline
To Apply:
  1. Click on a bounty to view details
  2. Review the requirements and deadline
  3. Submit an application with your approach
  4. Wait for the bounty owner to accept your application
To Submit Your Work:
  1. Create a pull request on the linked GitHub repository
  2. The platform automatically detects PR submissions
  3. Or manually submit via the bounty page with:
    • Description of your solution
    • Deliverable URL (GitHub PR link)
    • Any additional context
4

Integrate with GitHub (Optional)

For automated bounty management, install the Bounty GitHub App:
  1. Go to your organization settings
  2. Navigate to Integrations
  3. Click “Install GitHub App”
  4. Select repositories to integrate
With GitHub Integration:
  • Create bounties directly from GitHub issues with @bountydotnew create $500
  • Automatic PR tracking for submissions
  • Status updates posted as issue comments
  • Automated notifications on PR merges
The platform tracks these GitHub-specific fields:
{
  githubIssueNumber: number;
  githubInstallationId: number;
  githubRepoOwner: string;
  githubRepoName: string;
  githubCommentId: number;  // For editing bot comments
}
5

Set Up Linear Integration (Optional)

Connect your Linear workspace to manage bounties from Linear issues:
  1. Navigate to Integrations in your settings
  2. Click “Connect Linear”
  3. Authorize the Bounty app
  4. Select which projects to sync
Linear Integration Features:
  • Create bounties from Linear issues
  • Sync status updates bidirectionally
  • Track submissions in Linear comments
  • Automatic linking of work to Linear tickets

​
Quick Actions

Once you’re set up, here are common actions you’ll perform:

​
Vote on Bounties

Show interest in bounties by voting. Votes help prioritize popular requests.
/app/(auth)/bounties/page.tsx
// Bounties are displayed with vote counts
// Users can vote/unvote with a single click

​
Bookmark Bounties

Save bounties to review later:
  1. Navigate to any bounty detail page
  2. Click the bookmark icon
  3. Access your bookmarks from /bookmarks

​
Comment and Collaborate

Discuss requirements and solutions:
  • Comment directly on bounty pages
  • Reply to other comments (threaded discussions)
  • Edit your comments (edit history tracked)
  • Like helpful comments

​
Manage Your Dashboard

Your dashboard shows:
  • Active bounties (created or assigned)
  • Pending submissions
  • Recent activity
  • Payment history
  • Organization invites

​
Next Steps

Installation Guide

Set up a local development environment

API Reference

Explore the tRPC API endpoints

GitHub Integration

Learn about GitHub integration

Payment Setup

Configure Stripe for receiving payments

Build docs developers (and LLMs) love

Get started for freeTalk to us