Add Your Project to the Ecosystem

The information on this page assumes that you are familiar with Git. If you are not, please familiarize yourself with Git first.

Kodiak Finance aims to showcase the vibrant ecosystem of projects building on Berachain. If you've developed a project that contributes to the Berachain ecosystem, we welcome you to submit it for inclusion in our ecosystem directory.

Project Eligibility

For your project to be included in the Kodiak ecosystem, it should meet the following criteria:

• Live and operational on Berachain mainnet or testnet

• Provides clear value to the Berachain ecosystem

• Has a functional product, service, or platform (not just a concept)

• Maintains active development and community engagement

Projects in various stages of development may be accepted, but priority is given to launched projects with verifiable activity.

Step 1. Fork repository

Fork the Kodiak static-public repository to create your own copy of the repository.

the kodiak static-public repository

Step 2. Create a new branch and make the changes

Create a new branch with a descriptive name related to your project:

git checkout -b add-your-project-name

You'll need to make the following additions:

1. Add your project logo to the ecosystem/logo directory

   • File must be in .png format with transparent background

   • Recommended dimensions: 256×256 pixels

   • Use lowercase for the filename (e.g., yourproject.png)

2. Add your project details to the ecosystem/projects.json file:

{
  "name": "Your Project Name",
  "category": "Lending",
  "description": "A concise description of what your project does and its value proposition",
  "logoURI": "https://static.kodiak.finance/ecosystem/logo/yourproject.png",
  "link": "https://yourproject.com"
}

Available Categories

Choose the category that best represents your project:

• Derivatives: Projects focused on derivatives trading, synthetic assets, or options

• Gamblefi: Gaming, gambling, or prediction market platforms

• Infrastructure: Tools, APIs, indexers, oracles, or core infrastructure services

• Launchpad: Project incubators, IDO platforms, or fundraising solutions

• Lending: Lending and borrowing protocols or services

• LST / LSD: Liquid staking tokens or liquid staking derivatives

• Structured Products: Yield vaults, auto-compounders, or structured investment products

• Do not modify the logoURI domain - only change the filename portion • Keep your description informative but concise (maximum 100 characters) • Choose only one category that best represents your project's primary function

Step 3. Update Version Number

Update the version number in ecosystem/projects.json following semantic versioning principles:

• Increment major version when projects are removed (e.g., 1.0.0 → 2.0.0)

• Increment minor version when projects are added (e.g., 1.0.0 → 1.1.0)

• Increment patch version when existing projects are updated (e.g., 1.0.0 → 1.0.1)

Since you're adding a new project, you'll typically increment the minor version.

Step 4. Commit and Push Your Changes

Commit your changes with a descriptive message:

git add ecosystem/logo/yourproject.png
git add ecosystem/projects.json

git commit -m "Add [Your Project Name] to ecosystem"
git push origin add-your-project-name

Step 5. Create a Pull Request

Go to the original Kodiak static-public repository and create a new Pull Request from your branch.

• Title your PR: "Add [Your Project Name] to ecosystem"

• In the description, briefly explain what your project does and why it would be valuable to the Kodiak ecosystem

• Link to your project's website, documentation, and social media (if applicable)

Review Process

The Kodiak team will review your submission based on:

• Relevance to the Berachain ecosystem

• Project quality and usability

• Accuracy of information provided

• Compliance with the submission guidelines

This process typically takes 2-5 business days. You may be asked to provide additional information or make changes to your submission.

Example Submission

Here's an example of a well-formatted project submission:

{
  "name": "HoneySwap",
  "category": "Infrastructure",
  "description": "Decentralized exchange optimized for Berachain with concentrated liquidity and low fees",
  "logoURI": "https://static.kodiak.finance/ecosystem/logo/honeyswap.png",
  "link": "https://honeyswap.xyz"
}

For any questions or assistance with the submission process, please reach out to the Kodiak team via Discord