---
url: /docs/contribute/introduction.md
---

# Contributing to Oxc

Thank you for your interest in contributing to Oxc! We're building the next generation of JavaScript tooling, and we'd love your help.

## Quick Start

The fastest way to get started is through our [good first issues](https://github.com/oxc-project/oxc/contribute). These are carefully selected tasks that are perfect for new contributors.

Need guidance? Join our [Discord community](https://discord.gg/9uXCAwqQZW) where our team and community members are happy to help.

## Ways to Contribute

We welcome and appreciate any form of contributions:

### 🐛 Bug Reports

* Report parsing errors or incorrect linting behavior
* Share performance issues or regressions
* Document edge cases we haven't considered

### 🚀 Feature Development

* Add new linting rules
* Improve parser conformance
* Enhance transformer capabilities
* Build new tools in the Oxc ecosystem

### 📚 Documentation

* Improve getting started guides
* Add examples and tutorials
* Document architecture decisions
* Translate content to other languages

### 🧪 Testing

* Add test cases from real-world codebases
* Improve test coverage
* Create performance benchmarks
* Test against ecosystem projects

### 🔧 Infrastructure

* Improve build and CI systems
* Enhance development tooling
* Optimize performance critical paths
* Maintain compatibility with other tools

### Understanding the Codebase

Oxc is organized into several crates:

* **`oxc_parser`**: High-performance JavaScript/TypeScript parser
* **`oxc_linter`**: Fast linting engine with 650+ rules
* **`oxc_transformer`**: TypeScript and JSX transformation
* **`oxc_minifier`**: JavaScript minification (in development)
* **`oxc_formatter`**: Code formatting, compatible with Prettier

### Your First Contribution

1. **Browse Issues**: Look for issues labeled [`good first issue`](https://github.com/oxc-project/oxc/labels/good%20first%20issue)
2. **Ask Questions**: Don't hesitate to ask for clarification on Discord or GitHub
3. **Start Small**: Begin with documentation improvements or small bug fixes
4. **Learn the Patterns**: Study existing code to understand our conventions

## Community

### Communication Channels

* **GitHub Discussions**: For design discussions and questions
* **Discord**: Real-time chat with the team and community
* **GitHub Issues**: Bug reports and feature requests
* **Twitter**: Follow [@boshen\_c](https://twitter.com/boshen_c) for updates

### Code of Conduct

We are committed to providing a welcoming and inclusive experience for everyone. Please read our [Code of Conduct](https://github.com/oxc-project/oxc?tab=coc-ov-file#readme) before participating.

### AI Usage Policy

When using AI tools (including LLMs like ChatGPT, Claude, Copilot, etc.) to contribute to Oxc:

* **Please disclose AI usage** to reduce maintainer fatigue
* **You are responsible** for all AI-generated issues or PRs you submit
* **Low-quality or unreviewed AI content will be closed immediately**
* **Contributors who submit repeated low-quality ("slop") PRs will be banned without prior warning.** Bans may be lifted if you commit to contributing to Oxc in accordance with this policy. You may request an unban via our [Discord](https://discord.gg/9uXCAwqQZW).

We encourage the use of AI tools to assist with development, but all contributions must be thoroughly reviewed and tested by the contributor before submission. AI-generated code should be understood, validated, and adapted to meet Oxc's standards.

## Next Steps

Ready to contribute? Here are some great places to start:

* 📖 **Learn More**: Check out our [development guide](./development.md)
* 🔍 **Find an Issue**: Browse our [good first issues](https://github.com/oxc-project/oxc/contribute)
* 💬 **Join the Community**: Connect with us on [Discord](https://discord.gg/9uXCAwqQZW)
* 🛠️ **Pick a Tool**: Dive into [parser](./parser.md), [linter](./linter.md), [transformer](./transformer.md), or [other tools](./formatter.md)
* ⚡️ **Open a Pull Request**: Review our [PR Rules and Policies](./rules.md) to get started.

We can't wait to see what you'll build with us! 🚀