How to Contribute
Contributions to Eklesia are welcome! Whether you want to fix a bug, add a feature, improve documentation, or report an issue, here's how to get started.
Reporting Issues
If you find a bug or have a feature request, open an issue on GitHub. Include:
- A clear description of the problem or suggestion
- Steps to reproduce (for bugs)
- Your environment details (OS, Bun version, etc.)
Setting Up for Development
- Fork and clone the repository:
bash
git clone https://github.com/<your-username>/Eklesia.git
cd Eklesia- Install dependencies using Bun:
bash
bun install- Run the development server:
bash
bun run dev- Run tests:
bash
bun testMaking Changes
- Create a new branch for your work:
bash
git checkout -b feature/my-feature- Make your changes and ensure tests pass:
bash
bun test- Commit your changes with a clear message:
bash
git commit -m "Add my feature"- Push to your fork and open a pull request:
bash
git push origin feature/my-featureContributing to Documentation
The documentation site lives in a separate repository. To contribute to the docs:
- Clone the docs repo:
bash
git clone https://github.com/Leopc1977/Eklesia-docs.git
cd Eklesia-docs
npm install- Start the local dev server:
bash
npm run docs:dev- Edit Markdown files and preview changes in your browser.
Guidelines
- Write clear, descriptive commit messages
- Follow the existing code style
- Add tests for new features when applicable
- Keep pull requests focused on a single change
Questions?
Feel free to open an issue or reach out to Leopc1977 on GitHub.