PHPackages                             kocal/oxc-bundle - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. [Utility & Helpers](/categories/utility)
4. /
5. kocal/oxc-bundle

ActiveSymfony-bundle[Utility & Helpers](/categories/utility)

kocal/oxc-bundle
================

A Symfony Bundle to easily download tools from the JavaScript Oxidation Compiler (Oxc).

v1.0.0(3mo ago)31031MITPHPPHP >=8.1CI failing

Since Feb 4Pushed 3mo agoCompare

[ Source](https://github.com/Kocal/OxcBundle)[ Packagist](https://packagist.org/packages/kocal/oxc-bundle)[ RSS](/packages/kocal-oxc-bundle/feed)WikiDiscussions main Synced 1mo ago

READMEChangelog (1)Dependencies (7)Versions (2)Used By (1)

OxcBundle
=========

[](#oxcbundle)

[![.github/workflows/ci.yaml](https://github.com/Kocal/OxcBundle/actions/workflows/ci.yaml/badge.svg)](https://github.com/Kocal/OxcBundle/actions/workflows/ci.yaml)[![Packagist Version](https://camo.githubusercontent.com/042182e864a705abba08488b8b7620b81d9dd57494a9c25fe510fd05f4447a60/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f762f6b6f63616c2f6f78632d62756e646c65)](https://packagist.org/packages/kocal/oxc-bundle)

A Symfony Bundle to easily download and use [Oxlint](https://oxc.rs/docs/guide/usage/linter.html) and [Oxfmt](https://oxc.rs/docs/guide/usage/formatter.html)(from the [Oxc project](https://oxc.rs/)) in your Symfony applications, to lint your front assets without needing Node.js (ex: when using [Symfony AssetMapper](https://symfony.com/doc/current/frontend/asset_mapper.html)).

Tip

If you prefer to use Biome.js instead, check [Kocal/BiomeJsBundle](https://github.com/Kocal/BiomeJsBundle)!

---

Installation
------------

[](#installation)

Install the bundle with Composer:

```
composer require kocal/oxc-bundle --dev
```

If you use [Symfony Flex](https://symfony.com/doc/current/setup/flex.html), everything must be configured automatically. If that's not the case, please follow the next steps:

Manual installation steps1. Register the bundle in your `config/bundles.php` file:

```
return [
    // ...
    Kocal\OxcBundle\KocalOxcBundle::class => ['dev' => true],
];
```

2. Create the configuration file `config/packages/kocal_oxc.yaml`:

```
when@dev:
    kocal_oxc:
        # The Oxc apps version to use, that you can find at https://github.com/oxc-project/oxc/tags,
        # it follows the pattern "apps_v"
        apps_version: '1.43.0'
```

3. Create the recommended `.oxlintrc.json` file at the root of your project:

```
{
    "plugins": null,
    "categories": {},
    "rules": {},
    "env": {
        "builtin": true
    },
    "globals": {},
    "ignorePatterns": [
        "assets/vendor/**",
        "assets/controllers.json",
        "public/assets/**",
        "public/bundles/**",
        "tests/**",
        "var/**",
        "vendor/**",
        "composer.json",
        "package.json"
    ]
}
```

4. Create the recommended `.oxfmtrc.json` file at the root of your project:

```
{
    "ignorePatterns": [
        "assets/vendor/**",
        "assets/controllers.json",
        "public/assets/**",
        "public/bundles/**",
        "tests/**",
        "var/**",
        "vendor/**",
        "composer.json",
        "package.json"
    ]
}
```

Configuration
-------------

[](#configuration)

The bundle is configured in the `config/packages/kocal_oxc.yaml` file:

```
when@dev:
    kocal_oxc:
        # The Oxc apps version to use, that you can find at https://github.com/oxc-project/oxc/tags,
        # it follows the pattern "apps_v"
        apps_version: '1.43.0'
```

Usage
-----

[](#usage)

### `oxc:download:oxlint`

[](#oxcdownloadoxlint)

Download Oxlint for your configured version and for your platform.

By default, the command will download the binary in the `bin/` directory of your project.

```
php bin/console oxc:download:oxlint
bin/oxlint --version

# or, with a custom destination directory
php bin/console oxc:download:oxlint path/to/bin
path/to/bin/oxlint --version
```

### `oxc:download:oxfmt`

[](#oxcdownloadoxfmt)

Download Oxfmt for your configured version and for your platform.

By default, the command will download the binary in the `bin/` directory of your project.

```
php bin/console oxc:download:oxfmt
bin/oxfmt --version

# or, with a custom destination directory
php bin/console oxc:download:oxfmt path/to/bin
path/to/bin/oxfmt --version
```

Inspirations
------------

[](#inspirations)

-
-

###  Health Score

39

—

LowBetter than 86% of packages

Maintenance80

Actively maintained with recent releases

Popularity16

Limited adoption so far

Community10

Small or concentrated contributor base

Maturity43

Maturing project, gaining track record

 Bus Factor1

Top contributor holds 100% of commits — single point of failure

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

###  Release Activity

Cadence

Unknown

Total

1

Last Release

103d ago

### Community

Maintainers

![](https://www.gravatar.com/avatar/193fce7c976005d2fdb59268f6ebc90f262d21e3cbc01e65300200ff70d74fe6?d=identicon)[Kocal](/maintainers/Kocal)

---

Top Contributors

[![Kocal](https://avatars.githubusercontent.com/u/2103975?v=4)](https://github.com/Kocal "Kocal (2 commits)")

---

Tags

symfonybundleformatlintoxlintoxcoxfmt

###  Code Quality

Static AnalysisPHPStan

Code StyleECS

Type Coverage Yes

### Embed Badge

![Health badge](/badges/kocal-oxc-bundle/health.svg)

```
[![Health](https://phpackages.com/badges/kocal-oxc-bundle/health.svg)](https://phpackages.com/packages/kocal-oxc-bundle)
```

###  Alternatives

[sulu/sulu

Core framework that implements the functionality of the Sulu content management system

1.3k1.3M152](/packages/sulu-sulu)[symplify/monorepo-builder

Not only Composer tools to build a Monorepo.

5205.3M82](/packages/symplify-monorepo-builder)[pentatrion/vite-bundle

Vite integration for your Symfony app

2755.3M13](/packages/pentatrion-vite-bundle)[shlinkio/shlink

A self-hosted and PHP-based URL shortener application with CLI and REST interfaces

4.8k4.3k](/packages/shlinkio-shlink)[shyim/danger-php

Port of danger to PHP

8544.9k](/packages/shyim-danger-php)[kocal/biome-js-bundle

A Symfony Bundle to easily download and use Biome.js in your Symfony applications, to lint your front assets without needing Node.js.

30131.3k4](/packages/kocal-biome-js-bundle)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)