Contributing to AI DIAL React File Manager

Thank you for your interest in contributing to AI DIAL React File Manager.

Prerequisites

The development branch is the integration branch. Create a focused feature branch from it and open a pull request back to development.

git checkout development
git pull origin development
git checkout -b your-feature-name
npm ci

Run Storybook for local visual development:

npm run storybook

Follow the existing Dial* naming used by exported components.
Keep component, story, and test files colocated with the existing structure.
Add public exports to src/index.ts and export consumer-facing types.
Use the existing Tailwind tokens and utilities; avoid inline styles and hardcoded design values.
Preserve accessibility, keyboard interaction, selection behavior, and async error states.
Avoid breaking public APIs. Document an approved breaking change in CHANGELOG.md and provide migration guidance.

Before opening a pull request, run:

npm run typecheck
npm run lint
npm run format
npm run test
npm run build

Update or add tests and Storybook stories for behavior or visual changes. Keep the repository-wide test coverage at or above 70%.

Use a Conventional Commit style pull request title.
Link the related issue when one exists.
Keep the change focused and describe API or UI impact.
Confirm that no confidential information, credentials, or private endpoints are included.
Address review feedback and keep all required checks passing.

Publishing is performed only by project maintainers through the release process. Contributors should not publish package versions manually.

For the wider AI DIAL contribution policy, see the AI DIAL contributing documentation.