Installation

Template Installation

Start from a template for JavaScript or TypeScript. Replace my-project with your desired directory name.

JavaScript

npm

$ npx degit almadoro/react-just/templates/node-js my-project

pnpm

$ pnpx degit almadoro/react-just/templates/node-js my-project

bun

$ bunx degit almadoro/react-just/templates/node-js my-project

TypeScript

npm

$ npx degit almadoro/react-just/templates/node-ts my-project

pnpm

$ pnpx degit almadoro/react-just/templates/node-ts my-project

bun

$ bunx degit almadoro/react-just/templates/node-ts my-project

Manual Installation

Follow the steps below to manually install React Just in your project.

Packages Installation

Install React packages:

npm

$ npm install [email protected] [email protected]

pnpm

$ pnpm add [email protected] [email protected]

Bun

$ bun add [email protected] [email protected]

React 19.1.x recommended

The underlying APIs for React Server Components are not yet stable. The React team warns that these APIs may change between minor versions.

React Just has been tested with React 19.1 and should work with any patch version (19.1.x). Compatibility with future versions is not guaranteed.

Install Vite and React Just as dev dependencies:

npm

$ npm install -D vite@7 react-just

pnpm

$ pnpm add -D vite@7 react-just

Bun

$ bun add -D vite@7 react-just

TypeScript Configuration (Optional)

For a minimal TypeScript setup, use the following configuration:

tsconfig.json

{
  "compilerOptions": {
    "moduleResolution": "bundler",
    "module": "esnext",
    "jsx": "preserve"
  }
}

Vite Configuration

Create a Vite config file that uses the React Just plugin:

vite.config.ts

import react from "react-just/vite";
import { defineConfig } from "vite";

export default defineConfig({
  plugins: [react()],
});

Minimal App Component

For a working project, you need to add an App Component. Add a minimal version.

src/index.tsx

export default function App() {
  return (
    <html>
      <body>
        <h1>Hello, World!</h1>
      </body>
    </html>
  );
}

Development Server

Start the development server with the vite command. For convenience, add the following script to your package.json:

package.json

{
  "scripts": {
    "dev": "vite"
  }
}

Then start the development server with:

npm

$ npm run dev

pnpm

$ pnpm dev

Bun

$ bun dev