nest-can-react

Nest-native React Server Components over the Flight protocol.

Nest owns the application (modules, DI, guards, routing, APIs). React streams Server Component trees; 'use client' marks interactive islands.

cd my-nest-app
npm install nest-can-react react react-dom react-server-dom-rspack
npx nest-can-react init
npm install
npm run view:dev

Open GET /welcome. Controllers return render(WelcomePage). The page calls inject() on the same Nest container.

Full demo apps in this repo:

• examples/express — default (@nestjs/platform-express)
• examples/fastify — optional Fastify adapter

Repository: github.com/acefolioDev/nest-can-react

App imports

import { NestReactModule, render, inject } from 'nest-can-react';

@Module({
  imports: [NestReactModule.forRoot(), WelcomeModule],
})
export class AppModule {}

import { WelcomePage } from './react-pages';

@Get()
index() {
  return render(WelcomePage);
}

'use server-entry';

import { inject } from 'nest-can-react';
import { WelcomeService } from './welcome.service';

export default function WelcomePage() {
  const data = inject(WelcomeService).getPage();
  return (
    <>
      <h1>{data.tagline}</h1>
      <Counter />
    </>
  );
}

'use client';

export function Counter() {
  const [n, setN] = useState(0);
  return <button onClick={() => setN(n + 1)}>{n}</button>;
}

Client helpers:

import { useCommit, refresh, navigateTo } from 'nest-can-react/client';

CLI

Command	What it does
nest-can-react init [dir]	Add the welcome starter to an existing Nest app
nest-can-react dev	Push-only HMR: Fast Refresh for client/CSS, Flight refetch for RSC, guarded full reload when an update cannot be applied
nest-can-react build	Production RSC/SSR/client assets

Docs

• Changelog
• Documentation — full guide index
• Introduction · Why nest-can-react? · Creating your first app · Package APIs · Glossary

Contributing

Contributions are welcome. See CONTRIBUTING.md for development setup, pull request guidance, and issue reporting. Please read the Code of Conduct and Security Policy before participating.