# Bonfire

**Time to complete** : 

* Gated page with mint: 45-80 minutes (*est*)
* Full website: 2 hrs - a few days (*est*)

### Bonfire Basics

***tldr;*** Create a web3 enabled website. Steps to create an account, import your tokens, and create gates. The gates can then be applied to any of the modules. The guide shows reusable gates and single-use gates. These gates can be used for exclusive NFT drops (integrations from Sound or Decent), to embed Shopify, chats, and more.

#### What you will need

* Wallet or email to start account
* Token contract addresses
* Optional: An idea and assets for building your webpage

#### Why?

Utilize Bonfire pages to launch your latest [song](https://p00ls.gitbook.io/token-integrations-guide/nfts/sound#import-to-bonfire) or product, offering custom private fan experiences and the option to include gated chats. This web3-enabled platform lets you construct your unique world using modular design, akin to Wix, and supports ERC20 token integration for gating and wallet connectivity. Traditional fans are not left out as Bonfire supports Credit Cards for drops and wallet creation for newcomers. Additionally, Bonfire boasts robust integrations with Sound Protocol and Lens.

## Gate Requirement Recommendations:

Having a general requirement to view all or most channels can help with eliminating bot accounts and bad actors while creating exclusivity for your whole community. Setting a second requirement can create more exclusivity for your biggest holders and most engaged fans. We recommend determining exclusivity with 1 years worth of rewards, basing exclusivity on an annualized “reward size”. For example:

<table><thead><tr><th width="154">Ranking</th><th width="129">Percentile</th><th width="133">Reward Size</th><th>Reward Level</th></tr></thead><tbody><tr><td>Top 10%</td><td>90th</td><td>XL</td><td>Exclusive</td></tr><tr><td>Top 50%</td><td>75th</td><td>L</td><td>VIP</td></tr><tr><td>Top 75%</td><td>50th</td><td>M</td><td>Preferred</td></tr><tr><td>Top 85%</td><td>25th</td><td>S</td><td>Select</td></tr><tr><td>Top 95%</td><td>10th</td><td>XS</td><td>General Admission</td></tr></tbody></table>

### Create an Account to Get Started

1. Go to the [Dashboard sign in](https://www.getbonfire.xyz/signin) page
2. You can sign up using your email or wallet

<div align="left"><img src="https://193270293-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FsHkC8lMYflln9vUAnwZh%2Fuploads%2FVU76s7OcLvamQPch7Zz4%2FScreen%20Shot%202023-10-07%20at%2010.03.41%20AM.png?alt=media&#x26;token=577af481-4589-4ae3-8e22-699a3646c323" alt="Sign in" width="563"></div>

1. If using email, input the **email address** you’d like to associate with your Bonfire account and click **Sign In**
2. You should see a message notifying you to click the link in your **email** to continue signing in
3. If using a wallet, connect your wallet
4. Click **Sign In** or sign the transaction on your wallet
5. Follow the onboarding process
6. Connect a custom domain if you have one

#### Home page

<div align="left"><img src="https://193270293-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FsHkC8lMYflln9vUAnwZh%2Fuploads%2FQqLAj4QtSx6ZUzDsxbNE%2FScreen%20Shot%202023-10-07%20at%2011.58.40%20AM.png?alt=media&#x26;token=da2b53a1-1e11-42d0-8c6a-a51299a978aa" alt="Home page view" width="563"></div>

*Navigations found in the panel on the left*

### Import your tokens

*You can import ERC-20, POAP’s, and any ERC-1155, or ERC-721 contract on Ethereum or Polygon, and from Base and Optimism in just a few clicks!*

1. In your dashboard, click **Collections > Import Contract**
2. Fill out the details to import the token contract
   * Choose the Network your tokens are on
   * Copy-paste the contract address
     * *Token IDs (Optional) means the contract you’re importing includes several tokens that aren’t yours. This usually happens with “platform contracts”, e.g. Zora has a single contract and they’re minting every creator’s token under that one contract.*
   * Nickname (Optional) mean we will use the nickname you give your collection over it’s official name
   * Click **Import Contract**

<div align="left"><img src="https://193270293-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FsHkC8lMYflln9vUAnwZh%2Fuploads%2FjsbAKUXJsaox8C8MfPE8%2FYour%20ERC20%20Contract%20Address%20(1)%20(1).png?alt=media&#x26;token=8dd62d76-a6ef-44de-88fa-b293b9835396" alt="Your ERC20 Contract Address" width="563"></div>

### Set Reusable Gates

1. Go to **Gates**
2. Click **Create Gate**
3. Choose a Name
4. Add an Icon (optional)
5. Select the Gate Requirements
   1. You can gate by one or many assets, **All or Any**
6. Click **Add a Requirement**
7. Pick **your token’s** network and copy and paste the contract address
8. Enter an **amount** of tokens needed to pass the gate ([Recommendations](#gate-requirement-recommendations))

<div align="left"><img src="https://193270293-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FsHkC8lMYflln9vUAnwZh%2Fuploads%2FbbuwSHEvcKuCx2k1MZEW%2FScreen%20Shot%202023-10-07%20at%2011.49.32%20AM.png?alt=media&#x26;token=3813b8b5-12e4-44b2-a889-923561760314" alt="Create gate" width="563"></div>

\**Only use numbers **do not** use , commas*

9. Click **Save**

<div align="left"><img src="https://193270293-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FsHkC8lMYflln9vUAnwZh%2Fuploads%2FcOJ3SC10Kx6zGK8vrAtH%2FScreen%20Shot%202023-10-07%20at%2011.49.44%20AM.png?alt=media&#x26;token=c085c126-02ff-4835-8ec5-61a21359f4ec" alt="Save the gate" width="563"></div>

To create more complex requirements, click “Add Requirement” and stack tokens with NFTs.

10. If you already have pages built and want to apply this gate click “Add Rewards”
    * Associate rewards with your Gate by clicking **Add Rewards** - choose from Pages, Content, or Custom rewards
      * **Page** will give holders access to gated pages - just click on the pages you’d like to select
      * **Audio** will give holders access to gated audio - just click on the audio you’d like to select
      * **Video** will give holders access to gated videos - just click on the videos you’d like to select
      * **Custom** will give holders access to private links, text or promo codes - just type in the text or choose Promo Code

### Create A Gate For A Specific Page (not reusable)

1. Go to [Pages](https://www.getbonfire.xyz/studio)
2. Select **Token Gating**
3. Use the top menu to choose or create a Page
4. Select **Custom Audience -** you can gate by one or many assets, all or any
5. Pick your network and copy and paste the contract address
6. Click **Add Gate**

### **Gated Chats**

1. Go to **Threads**
2. Choose the page, drop or piece of content you’d like to enable threads for
3. Click on the settings icon
4. Toggle on **Enable thread** (this is also where you disable threads)
5. You’ll have the option to clear chat history or pause a thread making it read-only
6. Choose the layout between floating or fixed
7. You’ll be able to gate the thread by one or many collections. Learn here how to [🔐**Gates**](https://p00ls.gitbook.io/token-integrations-guide/content/bonfire)
8. Click **Save**

## Create Gated NFT Sale on Bonfire <a href="#create-gated-nft-sale-bonfire" id="create-gated-nft-sale-bonfire"></a>

1. From the Home screen go to Drops
2. Select Create New Drop
3. Select Create NFT Drop

<div align="left"><img src="https://193270293-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FsHkC8lMYflln9vUAnwZh%2Fuploads%2F8HtxzBzkLhJHG6RjnYzo%2FSelect%20NFT%20Drop.png?alt=media&#x26;token=4b4382f6-5445-481c-884d-34a4f3aea491" alt="Select NFT Drop" width="563"></div>

4. Enter in all of your song details
5. Finish the creation process
6. Use a Mint Block to put your NFT on sale
7. You can gate this page

## Exclusive Branded NFT Buying Experience

\**You will already need to have created the* [*NFT sale on Soundxyz*](https://p00ls.gitbook.io/token-integrations-guide/nfts/sound)

1. Navigate to Bonfire Dashboard > Drops > NFT Drops
2. Click Create NFT Drop
3. Select Import Drop
4. Select the chain the drop is created on

<div align="left"><img src="https://193270293-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FsHkC8lMYflln9vUAnwZh%2Fuploads%2FZMf0iKNhI2WXUa2oaXIw%2FScreen%20Shot%202023-10-11%20at%206.34.47%20PM.png?alt=media&#x26;token=70349b19-eaeb-4b22-a7ba-4cbe9c9d2ffd" alt="Select Chain and enter contract address" width="563"></div>

5. Input the smart contract address of the drop created on Sound
6. Click **Import Collection**
7. Fill out your collection details
   1. Description
   2. Secondary Marketplace link (you can come back to this after minting out, so that your fans can buy from this link)
   3. Upload media (choose from visual, audio or video)
   4. click **Submit**
8. *Optional -* Associate rewards with your Drop by clicking **Add Rewards** - choose from Pages, Content, or Custom rewards
   1. **Page** will give holders access to gated pages - just click on the pages you’d like to select
   2. **Audio** will give holders access to gated audio - just click on the audio you’d like to select
   3. **Video** will give holders access to gated videos - just click on the videos you’d like to select
   4. **Custom** will give holders access to private links, text or promo codes - just type in the text or choose Promo Code
9. *Optional* - **Enable Credit Card Checkout** by clicking **Verify** (follow the KYC process. This will require an ID) and toggle on **Enable Buy with Card.** For more information on Credit Card Checkout, [review this FAQ section](https://learn.bonfire.xyz/credit-card-checkout-faqs).
10. Use the Mint Block and select the drop
11. Brand the page with images and audio and video
12. Gate the page so the experience is exclusive