Contributing

Use the setup instructions in README.md. Keep documentation, comments, commit messages and user-facing copy in English. Multilingual search examples and input handling are welcome.

Before opening a pull request:

pnpm install --frozen-lockfile
pnpm generate-routes
pnpm cf-typegen
pnpm test
pnpm build

Keep changes focused. Explain the user-visible problem, the resulting behavior and how you verified it. Add regression coverage for behavioral changes, especially provider failures, cancellation, source selection and ranking. Tests should mock network calls and must not require real API keys. For layout changes, check both mobile and desktop widths and include screenshots when possible.

Do not commit .dev.vars, .env, API keys, provider responses containing private queries, generated build output or local Cloudflare state. Commit pnpm-lock.yaml when dependencies change. Generate worker-configuration.d.ts rather than editing it manually; route types are generated and ignored.

Source definitions live in src/lib/sources.ts. The UI should keep search progress and results aligned, chips stationary as counts update, and result links visually distinct from brand accents. See design-context.md for design context.

Report ordinary bugs through GitHub issues. Follow SECURITY.md for sensitive reports.