Installation

Prerequisites

• Node.js for Nuxt 4
• pnpm (version in the client repo packageManager field)

Reference desktop (client monorepo)

git clone https://github.com/owdproject/client.git
cd client
pnpm install
pnpm dev

Open the URL from the terminal (often http://127.0.0.1:3000).
Configuration: desktop/desktop.config.ts.

Change theme or apps there, or use the CLI:

pnpm desktop add theme-paper --dev
pnpm desktop add app-todo --dev

New desktop project (not recommended)

npm create owd
cd client
pnpm install
pnpm dev

Or: desktop init <dir> after installing @owdproject/core globally / via pnpm exec.

Develop an app or theme package

Each publishable app/theme has a playground/ mini-desktop:

cd themes/theme-paper   # or apps/app-about
pnpm install
pnpm run dev

From the package directory you can also run:

pnpm exec desktop dev
desktop validate .

Next

• Project structure
• desktop CLI
• Package linking