Creating Bounties
Learn how to create effective bounties that attract quality contributors
Anatomy of a Good Bounty
A well-crafted bounty should include:
Clear Title
Make it descriptive and searchable. Example: "Add dark mode toggle to settings page"
Detailed Description
Explain what needs to be done, why it's important, and any context needed
Acceptance Criteria
List specific, measurable requirements that define "done"
Fair Compensation
Set an appropriate bounty amount based on complexity and time required
Choosing the Right Bounty Level
🟢 Beginner ($50-$200)
Perfect for first-time contributors and simple tasks:
- Documentation improvements
- Minor bug fixes
- Code formatting and style improvements
- Adding comments and explanations
- Simple UI/UX tweaks
- Test coverage improvements
🟡 Intermediate ($200-$500)
For developers with domain knowledge:
- New feature implementation
- API integrations
- Complex bug fixes
- Performance optimizations
- Database schema changes
- Testing infrastructure
🔴 Advanced ($500-$2,000+)
Expert-level work requiring deep expertise:
- Architecture and design work
- Security audits and fixes
- Protocol development
- Smart contract development
- System-wide refactoring
- Research and prototyping
Research similar bounties in your space. When in doubt, ask the community or start with a lower amount and adjust based on feedback.
Creating a Bounty
Step 1: Create an Issue
- Go to your repository's "Issues" tab
- Click "New issue"
- Select the "Bounty" template
Step 2: Fill Out the Template
---
name: Bounty
about: Create a bounty for contributors
title: '[BOUNTY] Add Dark Mode Toggle'
labels: 'bounty, beginner, frontend'
---
## 💰 Bounty Amount
$150 USDC
## 🎯 Description
We need to add a dark mode toggle to the settings page. Users should be able to switch between light and dark themes, and their preference should be saved.
## ✅ Acceptance Criteria
- [ ] Add toggle switch in settings page
- [ ] Implement dark mode color scheme
- [ ] Save preference to localStorage
- [ ] Apply theme on page load
- [ ] All components render correctly in both modes
- [ ] Smooth transition between modes
## 📋 Technical Requirements
- Use CSS variables for theming
- Follow existing design system
- Write tests for theme switching
- Update documentation
## 🔗 Resources
- Design mockups: [link]
- Color palette: [link]
- Related issues: #123
## ⏱️ Estimated Time
2-3 days
## 📝 Notes
This is a beginner-friendly bounty. Feel free to ask questions in comments!
Step 3: Add Labels
Use labels to help contributors find appropriate bounties:
bounty
- Required for all bountiesbeginner
,intermediate
, oradvanced
- Difficulty levelfrontend
,backend
,design
, etc. - Categorygood-first-issue
- For newcomers
Step 4: Publish and Promote
After creating the bounty:
- Share on social media (Twitter, Discord, Reddit)
- Post in relevant developer communities
- Add to bounty aggregator platforms
- Announce in your project's communication channels
Best Practices
Be Specific
Vague requirements lead to confusion and poor results. Instead of:
"Make the UI better"
Write something like:
"Update the navigation bar to use our new design system: change colors to match brand guidelines, add hover effects, and ensure mobile responsiveness below 768px"
Set Realistic Deadlines
Give contributors enough time to do quality work. Consider:
- Complexity of the task
- Need for research or learning
- Review and iteration time
- Contributors may work part-time
Provide Context
Help contributors understand the bigger picture:
- Why this work matters
- How it fits into the project roadmap
- Who will benefit from this work
- Related issues or PRs
Be Available for Questions
Commit to being responsive:
- Respond to questions within 24 hours
- Provide clarification when needed
- Give feedback on work-in-progress
- Be supportive and encouraging
Managing Bounties
When Someone Claims a Bounty
When a contributor comments "I'll take this bounty":
- Check their GitHub profile and past contributions
- Assign them to the issue if they seem qualified
- Set expectations for communication and timeline
- Offer to answer questions and provide guidance
During Development
- Check in periodically to see progress
- Provide feedback on draft PRs
- Be flexible if challenges arise
- Extend deadlines if reasonable
Reviewing Submissions
When a PR is submitted:
- Review within 2-3 business days
- Check against acceptance criteria
- Test the implementation
- Provide constructive feedback
- Approve and merge if criteria are met
Handling Issues
If work isn't meeting standards:
- Communicate clearly and kindly
- Offer specific suggestions for improvement
- Give reasonable time to address feedback
- Be willing to reassign if necessary
Great contributors often return for more bounties. Treat every interaction as an opportunity to build a long-term relationship.
Ready-to-Use Bounty Templates
Bug Fix Bounty
## 💰 Bounty: $100 USDC
## 🐛 Bug Description
[Describe the bug clearly]
## 🔄 Steps to Reproduce
1. Step one
2. Step two
3. Bug occurs
## ✅ Expected Behavior
[What should happen]
## ❌ Actual Behavior
[What actually happens]
## ✅ Acceptance Criteria
- [ ] Bug is fixed
- [ ] Tests added to prevent regression
- [ ] No new bugs introduced
- [ ] Code follows style guidelines
## 📱 Environment
- Browser: [e.g., Chrome 96]
- OS: [e.g., macOS 12]
- Version: [e.g., 1.2.3]
Feature Implementation Bounty
## 💰 Bounty: $300 USDC
## 🎯 Feature Request
[Describe the feature]
## 💡 Why This Matters
[Business value and user impact]
## ✅ Acceptance Criteria
- [ ] Feature works as described
- [ ] Error handling implemented
- [ ] User-friendly error messages
- [ ] Documentation updated
- [ ] Tests cover main scenarios
## 🎨 Design
[Link to designs or mockups]
## 💻 Technical Notes
[API endpoints, database changes, etc.]
## 📚 Resources
- Related issues: #123
- Documentation: [link]
Pro Tips
Start Small
Begin with smaller bounties to test the system and build your contributor pool before tackling major features.
Build a Community
Create a Discord or Slack channel where contributors can ask questions and collaborate.
Iterate on Process
Regularly review your bounty process and adjust based on what works and what doesn't.
Recognize Contributors
Publicly thank contributors, feature them on your website, and build a strong reputation system.