rowboat/apps/x/README.md
nocxcloud-oss 4239f9f1ef strengthen repo verification and runtime coverage
Add clearer app docs plus targeted desktop, CLI, web, and worker tests so cross-surface regressions are caught earlier and the repo is easier to navigate.
2026-04-15 19:10:41 +08:00

1.3 KiB

Rowboat Desktop App

apps/x is the primary local-first Rowboat desktop product. It is a nested pnpm workspace that packages the Electron app, renderer, preload bridge, shared contracts, and core knowledge/runtime logic.

Workspace Layout

  • apps/main - Electron main process
  • apps/renderer - React and Vite renderer UI
  • apps/preload - validated IPC bridge
  • packages/shared - shared schemas and IPC contracts
  • packages/core - workspace, knowledge graph, integrations, agents, and background services

Local Development

Install dependencies:

pnpm install

Build shared dependencies used by the app:

npm run deps

Run the desktop app in development:

npm run dev

Useful verification commands:

npm run lint
npm run typecheck
npm run test
npm run verify

Build Notes

  • npm run deps builds shared, core, and preload
  • apps/main bundles the Electron main process with esbuild for packaging
  • The renderer uses Vite and hot reloads during development

Local Data Model

  • Default work directory: ~/.rowboat
  • Knowledge is stored as Markdown
  • Knowledge note history is Git-backed for transparent local versioning

If you are new to the repo, read the root ARCHITECTURE.md before making cross-surface changes.