Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/dwlad90/stylex-swc-plugin

Community NAPI-RS/SWC plugin for StyleX.
https://github.com/dwlad90/stylex-swc-plugin

nextjs rust stylex swc-plugin webpack

Last synced: 4 days ago
JSON representation

Community NAPI-RS/SWC plugin for StyleX.

Host: GitHub
URL: https://github.com/dwlad90/stylex-swc-plugin
Owner: Dwlad90
License: mit
Created: 2024-04-26T19:28:02.000Z (8 months ago)
Default Branch: develop
Last Pushed: 2024-12-28T17:26:16.000Z (6 days ago)
Last Synced: 2024-12-30T09:46:40.745Z (5 days ago)
Topics: nextjs, rust, stylex, swc-plugin, webpack
Language: Rust
Homepage:
Size: 5.97 MB
Stars: 57
Watchers: 6
Forks: 5
Open Issues: 5
Metadata Files:
- Readme: README.md
- License: LICENSE

Awesome Lists containing this project

README

        # StyleX in Rust · [![GitHub license](https://img.shields.io/badge/license-MIT-green.svg)](https://github.com/Dwlad90/stylex-swc-plugin/blob/master/LICENSE) [![npm version](https://img.shields.io/npm/v/@stylexswc/swc-plugin.svg?style=flat)](https://www.npmjs.com/package/@stylexswc/swc-plugin) ![GitHub tag check runs](https://img.shields.io/github/check-runs/Dwlad90/stylex-swc-plugin/0.5.1?label=Release%20status) ![GitHub Actions Workflow Status](https://img.shields.io/github/actions/workflow/status/Dwlad90/stylex-swc-plugin/pr-validation.yml?branch=develop&label=Project%20Health)

This is a monorepo for an unofficial [`napi-rs`](https://napi.rs/) compiler and

an [SWC](https://swc.rs/) plugin for

[StyleX](https://github.com/facebook/stylex). Using SWC allows us to completely

ditch Babel and make StyleX faster.

**Key Benefits:**

* Faster build times by leveraging NAPI-RS/SWC instead of Babel.

* Seamless integration with Next.js SWC Compiler.

* Almost 100% compatibility with official StyleX tests.

This is specifically useful for Next.js projets as it allows us to use

[SWC Next.js Compiler](https://nextjs.org/docs/architecture/nextjs-compiler).

## Project Structure

This project is organized into several packages:

**Core:**

* [`rs-compiler`](https://github.com/dwlad90/stylex-swc-plugin/tree/develop/crates/stylex-rs-compiler) -

  Rust-based [`napi-rs`](https://napi.rs/) compiler for transforming StyleX code.

**Integration:**

* [`nextjs-plugin`](https://github.com/dwlad90/stylex-swc-plugin/tree/develop/packages/nextjs-plugin) -

  A wrapper for [`Next.JS configuration`](https://nextjs.org/docs/app/api-reference/next-config-js) that integrates the StyleX [napi-rs](https://napi.rs/) compiler into the Webpack processing pipeline.

* [`webpack-plugin`](https://github.com/dwlad90/stylex-swc-plugin/tree/develop/packages/webpack-plugin) -

  A `Webpack pluign` that integrates the StyleX

  [napi-rs](https://napi.rs/) compiler.

* [`rollup-plugin`](https://github.com/dwlad90/stylex-swc-plugin/tree/develop/packages/rollup-plugin) -

  A `Rollup plugin` that integrates the StyleX [napi-rs](https://napi.rs/)

  compiler.

* [`unplugin`](https://github.com/dwlad90/stylex-swc-plugin/tree/develop/packages/unplugin) -

  Plugin collection for various build tools that integrates the StyleX [napi-rs](https://napi.rs/)

  compiler.

  Supported build tools and libraries:

  * Farm

  * Rollup

  * Rsbuild

  * Rspack

  * Solid

  * Vite

  * Vue

  * Webpack

**Utilities:**

* [`stylex-shared`](https://github.com/dwlad90/stylex-swc-plugin/tree/develop/crates/stylex-shared) -

 Shared Rust codebase for the StyleX RS compiler and SWC plugin.

* [`path-resolver`](https://github.com/dwlad90/stylex-swc-plugin/tree/develop/crates/stylex-path-resolver) -

   Path handling and resolving utilities for the StyleX NAPI-RS/SWC plugin.

* [`test-parser`](https://github.com/dwlad90/stylex-swc-plugin/tree/develop/crates/stylex-test-parser) -

  Parser for [StyleX](https://github.com/facebook/stylex) repo Jest tests that

  helps to understand last changes and keeps the project up to date

**Internal Configurations:**

* [`eslint-config`](https://github.com/dwlad90/stylex-swc-plugin/tree/develop/packages/eslint-config) -

  Internal [ESLint](https://eslint.org/) configuration

* [`typescript-config`](https://github.com/dwlad90/stylex-swc-plugin/tree/develop/packages/typescript-config) -

  Internal

  [Typescript](https://www.typescriptlang.org/docs/handbook/tsconfig-json.htm)

  configuration

## Deprecated Packages

> [!WARNING]

> The packages below are finaly deprecated as of version `0.5.0` and will be removed in the next minor release. Please use the newer alternatives listed above.

**Core:**

* [`swc-plugin`](https://github.com/dwlad90/stylex-swc-plugin/tree/develop/crates/stylex-swc-plugin) -

  Unofficial SWC implementation of the native

  [StyleX](https://github.com/facebook/stylex) plugin. The new alternative is

  [`rs-compiler`](https://github.com/dwlad90/stylex-swc-plugin/tree/develop/crates/stylex-rs-compiler)

**Integration:**

* [`nextjs-swc-plugin`](https://github.com/dwlad90/stylex-swc-plugin/tree/develop/packages/nextjs-swc-plugin) -

  Wrapper for

  [`Next.JS config`](https://nextjs.org/docs/app/api-reference/next-config-js)

  that inject the StyleX SWC plugin to webpack processing. The new alternative

  is

  [`nextjs-plugin`](https://github.com/dwlad90/stylex-swc-plugin/tree/develop/packages/nextjs-plugin)