> For the complete documentation index, see [llms.txt](https://documentation.kodiak.finance/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://documentation.kodiak.finance/user-guide/add-your-project-to-the-ecosystem.md).

# Add Your Project to the Ecosystem

{% hint style="warning" %}
The information on this page assumes that you are familiar with Git. If you are not, please familiarize yourself with Git first.
{% endhint %}

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

{% hint style="info" %}
Projects in various stages of development may be accepted, but priority is given to launched projects with verifiable activity.
{% endhint %}

### Step 1. Fork repository

Fork the [Kodiak static-public repository](https://github.com/kodiak-finance/static-public) to create your own copy of the repository.

<figure><img src="/files/dy3ijUlgc6v624dbPNmB" alt=""><figcaption><p>the kodiak static-public repository</p></figcaption></figure>

### Step 2. Create a new branch and make the changes

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

```bash
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:

```json
{
  "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

{% hint style="danger" %}
• 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&#x20;
{% endhint %}

### 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:

```bash
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](https://github.com/kodiak-finance/static-public) 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:

```json
{
  "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](https://discord.gg/vhZmNFNbCZ)