Skip to content

Development Setup ​

Get a local SilentSuite development environment running. You should be able to go from git clone to a working dev server in under 15 minutes.

Prerequisites ​

ToolVersionInstall
Node.js22.13+ or 24+ (not 23)nodejs.org
pnpm10.34.9corepack enable && corepack prepare pnpm@10.34.9 --activate
Docker24+docs.docker.com (for running services locally)

1. Clone the Repository ​

bash
git clone https://github.com/silent-suite/silentsuite.git
cd silentsuite

2. Install Dependencies ​

bash
pnpm install

This installs dependencies for all packages in the monorepo.

3. Run the Dev Server ​

bash
pnpm dev

This starts all apps in development mode using Turborepo.

Monorepo Structure ​

SilentSuite is a pnpm monorepo managed by Turborepo:

silentsuite/
  apps/
    web/             # Main web application (Next.js)
    docs/            # Documentation (you are here)
  android/           # Kotlin Android sync adapter
  bridge/            # CalDAV/CardDAV bridge daemon
  packages/          # Shared packages
  server/            # Etebase sync server
  self-host/         # Self-hosting configuration (Docker Compose)
  deploy/            # Deployment scripts and configuration

Available Commands ​

CommandDescription
pnpm devStart all apps in development mode
pnpm buildBuild all apps
pnpm lintLint all packages
pnpm testRun all tests
pnpm type-checkRun TypeScript type checking

Troubleshooting ​

pnpm install fails ​

Use the pnpm version declared in the root package.json packageManager field (currently pnpm@10.34.9). Run corepack enable first.

Port conflicts ​

The dev server uses port 3000 by default. If that's in use, check which app is occupying it or configure a different port.

Released under the AGPL-3.0 License.