Installation

In an existing React 18/19 project (Vite, Next.js, Create React App, etc.):

npm install @caoergou/windows-xp react react-dom styled-components

react, react-dom, and styled-components (v6) are peer dependencies. All implementation details (react-draggable, react-resizable, i18next, react-i18next, immer) are regular dependencies installed automatically, and the XP theme CSS is compiled into style.css, so there is nothing else to install.

Quick start

import { WindowsXP } from '@caoergou/windows-xp';
import '@caoergou/windows-xp/style.css';

function App() {
  // autoLogin and skipBoot jump straight to the desktop while you are developing.
  // Remove them to see the boot screen and login.
  return <WindowsXP autoLogin skipBoot />;
}

Without autoLogin/skipBoot you get the full experience: boot screen → login (default user User, password forthe2000s) → desktop.

Next steps

• Props reference — all <WindowsXP> props and defaults.
• Content model — how to define apps, files, and desktop data.
• Events — the events emitted by the engine.
• Embedding — embed the engine in another page or app.