Skip to main content
Rowboat uses a monorepo structure with multiple applications and a nested pnpm workspace for the Electron app.

​
Top-Level Structure

rowboat/
├── apps/
│   ├── x/                 # Electron desktop app
│   ├── rowboat/           # Next.js web dashboard
│   ├── rowboatx/          # Next.js frontend
│   ├── cli/               # CLI tool
│   ├── python-sdk/        # Python SDK
│   └── docs/              # Documentation site
├── CLAUDE.md              # AI agent context file
└── README.md              # User-facing readme

​
Electron App Workspace (apps/x)

The Electron app is a nested pnpm workspace with its own package management and build system.

​
Directory Layout

apps/x/
├── package.json           # Workspace root, dev scripts
├── pnpm-workspace.yaml    # Defines workspace packages
├── pnpm-lock.yaml         # Lockfile
├── apps/
│   ├── main/              # Electron main process
│   │   ├── src/           # Main process source
│   │   ├── forge.config.cjs   # Electron Forge config
│   │   └── bundle.mjs     # esbuild bundler
│   ├── renderer/          # React UI (Vite)
│   │   ├── src/           # React components
│   │   └── vite.config.ts
│   └── preload/           # Electron preload scripts
│       └── src/
└── packages/
    ├── shared/            # @x/shared - Types, utilities, validators
    └── core/              # @x/core - Business logic, AI, OAuth, MCP

​
Workspace Configuration

The pnpm workspace is configured in apps/x/pnpm-workspace.yaml: 
packages:
  - apps/*
  - packages/*

onlyBuiltDependencies:
  - core-js
  - electron
  - electron-winstaller
  - esbuild
  - fs-xattr
  - macos-alias
  - protobufjs
The onlyBuiltDependencies field ensures that only these packages are built during installation, improving build performance.

​
Package Descriptions

​
Internal Packages

{
  "name": "@x/shared",
  "private": true,
  "type": "module",
  "main": "./dist/index.js",
  "types": "./dist/index.d.ts",
  "dependencies": {
    "zod": "^4.2.1"
  }
}

​
@x/shared

Contains shared types, utilities, and validators used across all workspace packages.
  • Dependencies: Zod for schema validation
  • Purpose: Type definitions, common utilities
  • Build: TypeScript compilation only

​
@x/core

Contains core business logic and integrations:
  • AI provider integrations (Vercel AI SDK, Anthropic, OpenAI, Google)
  • OAuth and authentication
  • Model Context Protocol (MCP) implementation
  • Document parsing (PDF, CSV, XLSX, DOCX)
  • Git operations
@x/core depends on @x/shared via the workspace:* protocol. Always build shared before core.

​
Application Packages

​
apps/main

The Electron main process:
  • Entry: apps/main/src/main.ts
  • Output: .package/dist/main.cjs (bundled with esbuild)
  • Depends on: @x/shared, @x/core

​
apps/renderer

The React UI:
  • Entry: apps/renderer/src/main.tsx
  • Output: apps/renderer/dist/ (bundled with Vite)
  • Depends on: @x/shared
  • Hot-reloads in development mode

​
apps/preload

Electron preload scripts for secure IPC:
  • Entry: apps/preload/src/preload.ts
  • Output: apps/preload/dist/preload.js
  • Depends on: @x/shared

​
Workspace Dependencies

Packages reference each other using pnpm’s workspace:* protocol: 
{
  "dependencies": {
    "@x/shared": "workspace:*",
    "@x/core": "workspace:*"
  }
}
The workspace:* protocol tells pnpm to symlink local packages instead of installing from npm. This is why pnpm is required.

​
Build Dependencies

The workspace has a specific build order based on dependencies: 
shared (no deps)
   ↓
core (depends on shared)
   ↓
preload (depends on shared)
   ↓
renderer (depends on shared)
main (depends on shared, core)
The npm run deps command in the workspace root builds packages in order: 
{
  "scripts": {
    "shared": "cd packages/shared && npm run build",
    "core": "cd packages/core && npm run build",
    "preload": "cd apps/preload && npm run build",
    "deps": "npm run shared && npm run core && npm run preload"
  }
}

​
Key Files Reference

PurposeFile
Electron main entryapps/x/apps/main/src/main.ts
React app entryapps/x/apps/renderer/src/main.tsx
Forge config (packaging)apps/x/apps/main/forge.config.cjs
Main process bundlerapps/x/apps/main/bundle.mjs
Vite configapps/x/apps/renderer/vite.config.ts
Shared typesapps/x/packages/shared/src/
Core business logicapps/x/packages/core/src/
Workspace configapps/x/pnpm-workspace.yaml
Root scriptsapps/x/package.json

Build docs developers (and LLMs) love

Get started for freeTalk to us