diff --git a/docs.json b/docs.json
index 92e1d9b..c1bb7aa 100644
--- a/docs.json
+++ b/docs.json
@@ -14,10 +14,16 @@
],
"groups": [
{
- "group": "Guides",
+ "group": "For creators",
"pages": [
"guides/creating-bounties",
- "guides/payments"
+ "guides/funding-bounties"
+ ]
+ },
+ {
+ "group": "For developers",
+ "pages": [
+ "guides/solving-bounties"
]
},
{
diff --git a/guides/creating-bounties.mdx b/guides/creating-bounties.mdx
index d50254b..57cb2ba 100644
--- a/guides/creating-bounties.mdx
+++ b/guides/creating-bounties.mdx
@@ -225,10 +225,10 @@ For funded bounties, you must request cancellation:
## Next steps
-
+
Connect your favorite platforms.
-
- Configure payouts and billing.
+
+ Learn about payment methods and fees.
\ No newline at end of file
diff --git a/guides/funding-bounties.mdx b/guides/funding-bounties.mdx
new file mode 100644
index 0000000..9015f40
--- /dev/null
+++ b/guides/funding-bounties.mdx
@@ -0,0 +1,202 @@
+---
+title: "Funding bounties"
+description: "How to fund bounties and manage payments as a creator"
+---
+
+## Overview
+
+Fund your bounties with a credit card and let bounty.new handle the rest. When you approve a submission, the developer gets paid instantly—no manual transfers, no hassle.
+
+## How it works
+
+
+
+ Set up your bounty with a clear description and reward amount.
+
+
+ Pay upfront with a credit card. Funds are held securely until work is approved.
+
+
+ Developers submit solutions. You review and test their work.
+
+
+ When you approve a submission, the developer gets paid instantly.
+
+
+
+## Payment methods
+
+### Funding bounties
+
+- **Credit card**: Visa, Mastercard, American Express
+- **Instant processing**: Your bounty goes live immediately
+- **Secure**: All payments processed through Stripe
+
+
+ Bounties must be funded upfront. This ensures developers get paid immediately when their work is approved.
+
+
+## Fees and pricing
+
+### Platform fees
+
+| Fee type | Amount | When charged |
+| ----------------- | ----------- | ---------------------- |
+| Platform fee | 5% | When bounty is created |
+| Card processing | 2.9% + $0.30| When bounty is created |
+
+
+ Developers receive 100% of the bounty amount. You pay the platform fee and processing fees upfront.
+
+
+### Example calculation
+
+For a $500 bounty:
+
+```
+Bounty amount: $500.00
+Platform fee (5%): $ 25.00
+Card processing: $ 15.20
+─────────────────────────────
+Total charged: $540.20
+
+Developer receives: $500.00
+```
+
+## Managing funded bounties
+
+### Approving work
+
+When you approve a submission:
+
+1. Developer receives the full bounty amount instantly
+2. Bounty is marked as complete
+3. You receive a receipt for your records
+
+### Cancelling and refunds
+
+#### Unfunded bounties
+
+Delete them directly—no refund needed since they weren't funded.
+
+#### Funded bounties
+
+To cancel a funded bounty:
+
+
+
+ Click **Request cancellation** from the bounty menu.
+
+
+ Help us understand why you're cancelling.
+
+
+ Our team processes your refund manually.
+
+
+ You'll receive the bounty amount minus the 5% platform fee.
+
+
+
+
+ You cannot cancel a bounty that has an approved submission. Once work is approved, the developer must be paid. The 5% platform fee is non-refundable.
+
+
+### Refund calculation
+
+For a $500 bounty:
+
+```
+Original amount: $500.00
+Platform fee (5%): $ 25.00 (non-refundable)
+─────────────────────────────
+Refund amount: $475.00
+```
+
+### What happens during cancellation
+
+- All pending submitters receive a notification email
+- Bounty badge changes from "Funded" to "Cancelling"
+- Delete button becomes available while waiting for refund
+- Once refunded, bounty status changes to "Cancelled"
+
+## Payment security
+
+### How payment protection works
+
+1. **Funds secured**: When you fund a bounty, money is held securely in our platform account
+2. **Protected**: Neither party can access funds until work is approved
+3. **Released**: Funds transfer instantly to the developer upon approval
+4. **Refunded**: If cancelled, funds return to you (minus platform fee)
+
+### Dispute resolution
+
+If there's a disagreement with a developer:
+
+
+
+ Try to resolve the issue with the developer first.
+
+
+ Contact [grim@bounty.new](mailto:grim@bounty.new) for help.
+
+
+ Our team reviews the work and original requirements.
+
+
+ Funds are released based on a fair assessment.
+
+
+
+
+ Disputes are rare but taken seriously. Provide clear requirements upfront to avoid issues.
+
+
+## Best practices
+
+
+
+ Only share your bounty publicly after it's funded. Unfunded bounties can't accept submissions.
+
+
+ Pay market rates for the work required. Higher rewards attract better developers.
+
+
+ Approve or provide feedback quickly. Developers appreciate fast turnaround.
+
+
+ Detailed requirements reduce disputes and lead to better submissions.
+
+
+
+## Troubleshooting
+
+
+
+ - Verify card details are correct
+ - Check with your bank for blocks or limits
+ - Try an alternative payment method
+ - Contact [grim@bounty.new](mailto:grim@bounty.new) if issue persists
+
+
+ - Review the fee breakdown: bounty amount + 5% platform fee + card processing
+ - Check your transaction history for details
+ - Contact [grim@bounty.new](mailto:grim@bounty.new) if you believe there's an error
+
+
+ - Refunds are processed manually and may take 3-5 business days
+ - Check that your cancellation request was submitted
+ - Contact [grim@bounty.new](mailto:grim@bounty.new) for status updates
+
+
+ - Check if there's an approved submission (cannot cancel if approved)
+ - Make sure the bounty is funded (unfunded bounties can be deleted directly)
+ - Contact [grim@bounty.new](mailto:grim@bounty.new) for help
+
+
+
+## Need help?
+
+
+ Questions about payments? Our team is here to help.
+
diff --git a/guides/getting-paid.mdx b/guides/getting-paid.mdx
new file mode 100644
index 0000000..883c829
--- /dev/null
+++ b/guides/getting-paid.mdx
@@ -0,0 +1,160 @@
+---
+title: "Getting paid"
+description: "How payouts work for bounty solvers"
+---
+
+## Overview
+
+Get paid instantly when your work is approved. No waiting periods, no hassle. Connect your Stripe account and receive 100% of the bounty amount directly to your bank.
+
+## Setting up payouts
+
+
+
+ Go to [bounty.new/settings/payments](https://bounty.new/settings/payments) and click **Connect Stripe account**.
+
+
+ Stripe will ask for basic information to verify your identity. This is required by financial regulations.
+
+
+ Link your bank account to receive direct deposits.
+
+
+ Once connected, you can receive payments immediately upon approval.
+
+
+
+
+ You must connect your Stripe account before a creator can approve your submission. Set this up first.
+
+
+## How payouts work
+
+### Payment timeline
+
+
+
+ You submit your work for a bounty.
+
+
+ The bounty creator reviews and tests your submission.
+
+
+ Once approved, payment processes instantly.
+
+
+ Money hits your Stripe account immediately—no waiting period.
+
+
+
+### Payout methods
+
+- **Direct bank transfer**: Funds deposited directly to your bank account
+- **Instant processing**: Payment processes the moment your submission is approved
+- **No fees**: You keep 100% of the bounty amount
+
+
+ Developers pay zero fees. Creators cover the 5% platform fee, so you receive the full bounty amount.
+
+
+## Payment details
+
+### What you receive
+
+For a $500 bounty:
+
+```
+Bounty amount: $500.00
+Platform fee: $ 0.00 (paid by creator)
+Processing fee: $ 0.00 (paid by creator)
+─────────────────────────────
+You receive: $500.00
+```
+
+### Bank transfer timing
+
+- **Instant to Stripe**: Funds available in your Stripe balance immediately
+- **Bank transfer**: 1-2 business days to reach your bank account
+- **No holds**: No waiting periods or payment holds
+
+## Troubleshooting
+
+
+
+ - Make sure you're in a supported country
+ - Verify your identity information is correct
+ - Check that you're using a valid bank account
+ - Contact [grim@bounty.new](mailto:grim@bounty.new) if issues persist
+
+
+ - Check that your Stripe account is fully verified
+ - Bank transfers take 1-2 business days
+ - Verify your bank account details are correct
+ - Check your Stripe dashboard for pending transfers
+ - Contact [grim@bounty.new](mailto:grim@bounty.new) for help
+
+
+ - Double-check all information is accurate
+ - Ensure your documents are clear and valid
+ - Contact Stripe support for verification issues
+ - Reach out to [grim@bounty.new](mailto:grim@bounty.new) if stuck
+
+
+ - Check the original bounty amount
+ - Verify there were no partial payments
+ - Review your Stripe transaction history
+ - Contact [grim@bounty.new](mailto:grim@bounty.new) if there's a discrepancy
+
+
+
+## Payment security
+
+### How we protect your money
+
+- **Escrow system**: Funds are held securely until work is approved
+- **Instant release**: Payment processes immediately upon approval
+- **Stripe powered**: All payments processed through Stripe's secure infrastructure
+- **No chargebacks**: Once approved, payment is final
+
+### Your protection
+
+- **Work first, then payment**: Only submit when you're confident in your solution
+- **Clear requirements**: Make sure you understand what's expected before starting
+- **Communication**: Keep the creator updated to avoid surprises
+- **Dispute resolution**: Contact [grim@bounty.new](mailto:grim@bounty.new) if there's an issue
+
+## Tax information
+
+
+ Bounty.new does not withhold taxes. You're responsible for reporting your earnings according to your local tax laws.
+
+
+### What you need to know
+
+- **Independent contractor**: You're paid as an independent contractor
+- **Tax forms**: Stripe may require tax information depending on your country
+- **Record keeping**: Keep track of your earnings for tax purposes
+- **Consult a professional**: Talk to a tax advisor about your specific situation
+
+## Maximizing your earnings
+
+
+
+ The more quality work you deliver, the more you earn.
+
+
+ Consistent quality work leads to private bounty invitations.
+
+
+ First quality submission often wins. Speed + quality = more earnings.
+
+
+ Good communication leads to faster approvals and repeat work.
+
+
+
+## Need help?
+
+
+ Questions about payouts? We're here to help.
+
diff --git a/guides/payments.mdx b/guides/payments.mdx
deleted file mode 100644
index 0c7cf6f..0000000
--- a/guides/payments.mdx
+++ /dev/null
@@ -1,171 +0,0 @@
----
-title: "Payments and payouts"
-description: "How payments work on bounty.new"
----
-
-## Overview
-
-Bounty.new handles all payment processing so you can focus on getting work done. Instant payouts, transparent fees, and multiple payment methods.
-
-## How it works
-
-### For creators
-
-
-
- Funds are held in our platform account when you publish a bounty.
-
-
- When you approve a submission, the payout processes instantly, and the winning submission gets paid immediately.
-
-
-
-### For developers
-
-
-
- Submit your solution for a bounty.
-
-
- Creator reviews and approves your submission.
-
-
- Funds hit your account immediately—no waiting period.
-
-
-
-## Payment methods
-
-### Adding funds (creators)
-
-- **Credit card**: Visa, Mastercard, American Express
-- Instant processing
-- 2.9% + \$0.30 processing fee
-
-### Receiving payouts (developers)
-
-Connect your Stripe account at [bounty.new/settings/payments](https://bounty.new/settings/payments) to receive payouts.
-
-- **Stripe Connected Account**: Direct deposit to your bank
-- Instant payout upon approval
-- No fees
-
-
- You must connect your Stripe account before a bounty creator can approve your submission.
-
-
-## Fees
-
-### Platform fees
-
-| Role | Fee | When charged |
-| --------- | --- | ---------------------- |
-| Creator | 5% | When bounty is created |
-| Developer | 0% | No fees on payouts |
-
-
- Developers keep 100% of the bounty amount. Creators pay a 5% platform fee.
-
-
-### Payment processing fees
-
-Additional fees from payment providers:
-
-- **Credit card**: 2.9% + \$0.30
-
-### Example calculation
-
-For a \$500 bounty:
-
-```
-Bounty amount: $500.00
-Platform fee (5%): $ 25.00
-Card processing: $ 15.20
-─────────────────────────────
-Total charged: $540.20
-
-Developer receives: $500.00
-```
-
-## Payment security
-
-### How payment protection works
-
-1. **Funds secured**: When you create a bounty, funds are held securely in escrow
-2. **Protected**: Neither party can access funds until work is approved
-3. **Released**: Funds transfer instantly upon approval
-4. **Refunded**: If bounty is cancelled, funds return to creator minus the 5% platform fee
-
-## Refunds and cancellations
-
-### Requesting a refund
-
-To cancel a funded bounty and request a refund:
-
-1. Click **Request cancellation** from the bounty menu
-2. Optionally provide a reason
-3. Support team processes your refund manually
-4. You'll receive the bounty amount minus the 5% platform fee
-
-
- You cannot cancel a bounty that has an approved submission. The solver must be paid. The 5% platform fee is non-refundable.
-
-
-### What happens during cancellation
-
-- All pending submitters receive a notification email
-- Bounty badge changes from "Funded" to "Cancelling"
-- Delete button becomes available while waiting for refund
-- Once refunded, bounty status changes to "Cancelled"
-
-### Refund calculation
-
-For a $500 bounty:
-
-```
-Original amount: $500.00
-Platform fee (5%): $ 25.00 (non-refundable)
-─────────────────────────────
-Refund amount: $475.00
-```
-
-### Dispute resolution
-
-If there's a disagreement:
-
-1. **Communicate**: Try to resolve directly with the other party
-2. **Request mediation**: Contact [grim@bounty.new](mailto:grim@bounty.new)
-3. **Review process**: Our team reviews the work and requirements
-4. **Decision**: Funds released based on fair assessment
-
-
- Disputes are rare but taken seriously. Provide clear requirements upfront to avoid issues.
-
-
-## Troubleshooting
-
-
-
- - Verify card details are correct
- - Check with your bank for blocks
- - Try an alternative payment method
- - Contact support if issue persists
-
-
- - Check your payout method is verified
- - ACH bank transfers take 1-2 business days
- - Verify bank account details are correct
- - Contact [grim@bounty.new](mailto:grim@bounty.new) for help
-
-
- - Review the fee breakdown in your transaction history
- - Platform fee (5%) and payment processing fees apply
- - Contact support if you believe there's an error
-
-
-
-## Need help?
-
-
- Questions about payments? Our team is here to help.
-
\ No newline at end of file
diff --git a/guides/solving-bounties.mdx b/guides/solving-bounties.mdx
new file mode 100644
index 0000000..35d26e3
--- /dev/null
+++ b/guides/solving-bounties.mdx
@@ -0,0 +1,134 @@
+---
+title: "Solving bounties"
+description: "Find bounties, deliver solutions, and get paid instantly."
+---
+
+# Solving bounties
+
+Get paid for solving real problems. Here's how to find bounties, deliver quality solutions, and maximize your earnings.
+
+## Quick start
+
+
+
+ Browse available bounties on bounty.new or get notified through Discord, Slack, or GitHub integrations.
+
+
+
+ Click **Claim bounty** to let the creator know you're working on it. This prevents duplicate work.
+
+
+
+ Submit your work through the platform. Include clear documentation and testing evidence.
+
+
+
+ Once approved, funds hit your account immediately. No waiting periods.
+
+
+
+## Tips for success
+
+
+
+ Understand exactly what's needed before claiming. Ask questions early if anything is unclear.
+
+
+
+ Keep the creator updated. Quick status updates build trust and prevent miscommunication.
+
+
+
+ Verify your solution works as expected. Include screenshots, videos, or test results with your submission.
+
+
+
+ Clear documentation makes approval faster. Explain what you built and how to use it.
+
+
+
+## Finding the right bounties
+
+### Match your skills
+
+Focus on bounties that align with your expertise. You'll deliver faster and produce better work.
+
+### Check the requirements
+
+Look for:
+- **Clear scope**: Well-defined requirements are easier to fulfill
+- **Fair compensation**: Make sure the payout matches the effort required
+- **Reasonable timeline**: Can you realistically deliver within the deadline?
+
+### Start small
+
+Build reputation with smaller bounties before tackling complex ones. Creators are more likely to approve work from developers with a track record.
+
+## Delivering quality work
+
+### Before you submit
+
+- [ ] Solution meets all stated requirements
+- [ ] Code is clean and well-commented
+- [ ] Tests pass (if applicable)
+- [ ] Documentation is clear
+- [ ] You've tested edge cases
+
+### Submission best practices
+
+1. **Show your work**: Include screenshots, videos, or live demos
+2. **Explain your approach**: Brief overview of how you solved the problem
+3. **Highlight key features**: Point out important aspects of your solution
+4. **Provide next steps**: If relevant, suggest improvements or future enhancements
+
+## Getting paid
+
+### Payout methods
+
+Set up your payout method in your account settings:
+- **Bank account (ACH)**: 1-2 business day transfers
+- **Debit card**: Instant payouts
+
+### After approval
+
+Funds are released immediately when the creator approves your work. No holds, no delays.
+
+### If there's an issue
+
+If a creator requests changes:
+1. Review their feedback carefully
+2. Make the requested updates
+3. Resubmit with notes on what you changed
+
+
+ **Pro tip**: Most disputes come from unclear requirements. When in doubt, over-communicate before you start coding.
+
+
+## Common questions
+
+
+
+ Yes! Claim as many as you can handle, but be realistic about your capacity. It's better to deliver one great solution than multiple rushed ones.
+
+
+
+ Unclaim it as soon as possible so other developers can take it. Your reputation stays intact if you communicate early.
+
+
+
+ - Deliver quality work on time
+ - Communicate clearly and promptly
+ - Be responsive to feedback
+ - Start with smaller bounties and work your way up
+
+
+
+ Ask questions before claiming. Use comments or direct messages to clarify scope, expectations, and acceptance criteria.
+
+
+
+## Need help?
+
+
+ Questions about solving bounties? We're here to help.
+
diff --git a/index.mdx b/index.mdx
index a89c65a..dbdf96c 100644
--- a/index.mdx
+++ b/index.mdx
@@ -7,6 +7,44 @@ description: "Bounty.new is the bounty platform where creators post challenges a
Bounty.new is the bounty platform where creators post challenges and developers deliver solutions. Instant payouts, seamless integration, zero friction.
+## For creators
+
+Post bounties, fund them upfront, and get solutions fast.
+
+
+
+ Learn how to post bounties from GitHub, Discord, Linear, or the dashboard.
+
+
+ Pay upfront with a credit card. Approve work and developers get paid instantly.
+
+
+ Create bounties from issues and PRs with a simple comment.
+
+
+ Manage bounties directly from your Discord server.
+
+
+
+## For developers
+
+Find bounties, solve them, and get paid instantly.
+
+
+
+ Find bounties, submit solutions, and receive instant payouts.
+
+
+ Check out all open bounties on bounty.new.
+
+
+ Connect your bank account to receive payments immediately.
+
+
+ Learn how to build your reputation and maximize earnings.
+
+
+
## Why use bounty.new?
@@ -27,18 +65,6 @@ Bounty.new is the bounty platform where creators post challenges and developers
-## Who is it for?
-
-* **Creators and project owners** who need specific features built or bugs fixed without hiring full-time.
-* **Developers** who want to earn money solving interesting problems on their own schedule.
-* **Open source maintainers** who want to incentivize contributions and reward community members.
-
**Ship fast. Get paid faster.** We're building the simplest way to connect work with rewards.
-
-## Ready to get started?
-
-
- Follow our guide to post your first bounty and start getting solutions in minutes.
-