> ## Documentation Index
> Fetch the complete documentation index at: https://laraowl.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Contributing

> Help improve LaraOwl.

LaraOwl is open-source software licensed under the [Apache License 2.0](https://github.com/laraowl/laraowl/blob/main/LICENSE), and contributions are welcome — whether that's code, documentation, or a well-written bug report.

## Report a bug

Found something broken? [Open an issue](https://github.com/laraowl/laraowl/issues) and include:

* Your LaraOwl version and install method (Docker or Composer).
* Steps to reproduce the problem.
* What you expected to happen versus what actually happened.
* Relevant log output from `storage/logs/laravel.log` (or `docker compose logs`).

## Request a feature

Have an idea? Open an issue describing the use case and the problem it solves. Discussing the approach before you build it saves everyone time.

## Submit a pull request

<Steps>
  <Step title="Fork and branch">
    Fork the repository and create a descriptive branch (for example, `fix/uptime-check-timeout`).
  </Step>

  <Step title="Set up the project locally">
    Install dependencies and start the development environment:

    ```bash theme={null}
    composer setup
    composer dev
    ```
  </Step>

  <Step title="Make your change with tests">
    Every change should be covered by a test. LaraOwl uses [Pest](https://pestphp.com):

    ```bash theme={null}
    php artisan test
    ```
  </Step>

  <Step title="Format and lint">
    Match the project's code style before committing:

    ```bash theme={null}
    vendor/bin/pint       # PHP
    npm run lint          # JavaScript / TypeScript
    ```
  </Step>

  <Step title="Open the pull request">
    Push your branch and open a PR against `main`. Describe what changed and why, and link any related issue.
  </Step>
</Steps>

<Tip>
  Keep pull requests focused. Small, single-purpose changes are reviewed and merged faster than large ones.
</Tip>

## Maintainer

LaraOwl is created and maintained by **Abdelmjid Saber**.

<Card title="Abdelmjid Saber" icon="github" href="https://github.com/megoxv" horizontal>
  Creator & lead maintainer — [@megoxv](https://github.com/megoxv)
</Card>

## Contributors

LaraOwl is built by its community. Thank you to everyone who has contributed code, documentation, and bug reports.

<a href="https://github.com/laraowl/laraowl/graphs/contributors">
  <img src="https://contrib.rocks/image?repo=laraowl/laraowl" alt="LaraOwl contributors" />
</a>

Want to see your avatar here? [Open a pull request](https://github.com/laraowl/laraowl/pulls) — every contribution counts.

Thank you for helping make LaraOwl better.