https://github.com/react18-tools/esbuild-react18-useclient
esbuild plugin for compiling libraries compatible with React 18 server and client component, Nextjs13, Remix, etc. Please use Turborepo Template -> https://github.com/react18-tools/turborepo-template
https://github.com/react18-tools/esbuild-react18-useclient
esbuild esbuild-plugin javascript nextjs nodejs react-libraries react-server-components react18 reactjs tsup tsup-plugin typescript
Last synced: 2 months ago
JSON representation
esbuild plugin for compiling libraries compatible with React 18 server and client component, Nextjs13, Remix, etc. Please use Turborepo Template -> https://github.com/react18-tools/turborepo-template
- Host: GitHub
- URL: https://github.com/react18-tools/esbuild-react18-useclient
- Owner: react18-tools
- License: mit
- Created: 2023-07-31T10:30:17.000Z (almost 2 years ago)
- Default Branch: main
- Last Pushed: 2025-02-04T07:41:31.000Z (5 months ago)
- Last Synced: 2025-04-04T19:50:23.817Z (3 months ago)
- Topics: esbuild, esbuild-plugin, javascript, nextjs, nodejs, react-libraries, react-server-components, react18, reactjs, tsup, tsup-plugin, typescript
- Language: TypeScript
- Homepage: https://github.com/react18-tools/turborepo-template
- Size: 69.3 KB
- Stars: 8
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# esbuild-react18-useclient [](https://www.npmjs.com/package/esbuild-react18-useclient) [](https://www.npmjs.com/package/esbuild-react18-useclient) [](https://github.com/mayank1513/esbuild-react18-useclient/actions/workflows/publish-to-npm-on-new-release.yml)
> This package is deprecated in favor of [esbuild-plugin-react18](https://github.com/mayank1513/esbuild-plugin-react18)
> Please switch to [esbuild-plugin-react18](https://github.com/mayank1513/esbuild-plugin-react18), which also offers additional options and more control over your build output.
> Build Awesome Libraries using React Server Components and make your Mark!
This is an `esbuild` plugin for compiling libraries compatible with React 18 server and client component, Nextjs13, Remix, etc.
## Why?
✅ Unleash the power of combining react client and server components in your libraries
✅ Full TypeScript support out of the box
✅ Simple and tiny
✅ Easy to use — just add the plugin, and you are good to go
Introduction of React server components in React 18 has unlocked immense possibilities. However, library authors are not yet able to fully encash upon this potential. Many libraries, like `chakra-ui`, simply add “use client” for each component. However, much more can be unleashed when we can use both server and client components to build libraries. Also check-out this [blog](https://mayank1513.medium.com/unleash-the-power-of-react-server-components-eb3fe7201231).
## Example
Checkout https://github.com/mayank1513/nextjs-themes
## Compatibility
- JavaScript/TypeScript React libraries using `tsup` or other builders based on `esbuild`
This plugin seamlessly integrates with `tsup` and any other builders based on `esbuild`. With this you can have both server and client components in your library and the plugin will take care of the rest. All you need to do is add this plugin and add `"use client";` on top of client components (in your source code).
## Add dependencies:
```bash
yarn add --dev esbuild-react18-useclient
```
or
```bash
pnpm add -D esbuild-react18-useclient
```
or
```bash
npm install -D esbuild-react18-useclient
```
> If you are using `monorepo` or `workspaces` you can install this plugin to root using `-w` or to specific workspace using `--filter your-package` or `--scope your-package` for `pnpm` and `yarn` workspaces respectively.
## Use with `tsup`
```javascript
// tsup.config.ts or tsup.config.js
import { defineConfig } from "tsup";
import reactUseClient from "esbuild-react18-useclient";
export default defineConfig(options => ({
...
esbuildPlugins:[reactUseClient]
}));
```
## License
Licensed as MIT open source.
with 💖 by Mayank Kumar Chaudhari