# Contributing

Thanks for your interest in improving this repository.

## Local development

1. Install dependencies:

   ```bash
   pnpm install
   ```

2. Run the validation commands:

   ```bash
   pnpm test
   pnpm typecheck
   npm pack --dry-run
   ```

## Contribution guidelines

- Keep changes focused and explain the user-facing motivation in the pull request.
- Prefer small, reviewable commits over large mixed refactors.
- Update documentation when behavior, public APIs, or local workflows change.
- Add or update tests for meaningful behavior changes.
- Follow the existing TypeScript style and naming conventions in the repo.

## Working with related Mosaicora repos

This repo is designed to work cleanly with other Mosaicora packages, including
[`@mosaicora/plugin-nextjs`](https://github.com/Mosaicora/plugin-nextjs).
Cross-repo changes should be coordinated through public package interfaces and
versioned releases.

## Issues and security

- Use GitHub issues for bugs, questions, and feature requests.
- Do not report security issues publicly. See [SECURITY.md](./SECURITY.md).