Feedback - Roadmap - Open an issue - Style guide
Koi represents a paradigm shift in assessing the potential impact of solutions, with an emphasis on transparency and speed.
Compared to traditional climate tools, Koi is intuitive, forward-looking, and the first impact forecasting platform that blends the latest generative AI with decades of hands-on forecasting experience. We exist to help scale the best climate solutions, faster.
First, thank you for your interest in contributing to the Koi Documentation!
The fastest way to provide feedback is to visit our Feedback Board. You can use your existing Koi account to log in and submit feedback, feature requests, and bug reports.
If you'd like to submit feedback via a pull request directly in GitHub, you can do so by following these steps:
- Navigate to the docs.koi.eco repository.
- Click the
Fork
button to create your own copy of the repository. - You can use the GitHub UI to then modify files in your forked repository.
- Once you're ready to submit your changes, navigate to your forked repository and click the
Create Pull Request
button. - Fill out the PR template and submit your request.
If you plan on contributing to the docs in more of a programmatic fashion, here are some additional details.
- Clone the repository
git clone https://github.com/RhoImpact/docs.koi.eco.git
- Install the dependencies
npm install
- Run the development server
npm run dev
- Open http://localhost:3000 in your browser to view the website.
Koi Docs are built on top of a Tailwind UI site template built using Tailwind CSS and Next.js.
You can start editing this template by modifying the files in the /src
folder. The site will auto-update as you edit these files.
This template includes a global search that's powered by the FlexSearch library. It's available by clicking the search input or by using the ⌘K
shortcut.
This feature requires no configuration, and works out of the box by automatically scanning your documentation pages to build its index. You can adjust the search parameters by editing the /src/mdx/search.mjs
file.
We often use Mermaid to render diagrams in the docs.
To add a diagram to a page, you can use the following syntax:
import Mermaid from '@/components/Mermaid'
export const networkDiagram = `graph LR
Start[Start] --> DecisionA{Decision A}
DecisionA --> Outcome1[Outcome 1]
DecisionA --> Outcome2([Outcome 2])
`
<Mermaid chart={networkDiagram} />
This site is built using a commercially licensed template under the Tailwind UI License. All original code in this repository is licensed under the MIT License. However, Tailwind UI components remain under their original license, and you must purchase a Tailwind UI license if you intend to use them. Please respect that!
To learn more about the technologies used in this site template, see the following resources:
- Tailwind UI - the official Tailwind UI documentation
- Tailwind CSS - the official Tailwind CSS documentation
- Next.js - the official Next.js documentation
- Headless UI - the official Headless UI documentation
- Framer Motion - the official Framer Motion documentation
- MDX - the official MDX documentation
- Algolia Autocomplete - the official Algolia Autocomplete documentation
- FlexSearch - the official FlexSearch documentation
- Zustand - the official Zustand documentation
- Koi - the official Koi