Introduction

StayDistributed is a suite of developer tools for building and operating distributed systems. Each product in the suite is independent — install only what you need.

Products

Product	Description
Check	Health checking and validation tool
Signal	Event signalling tool

How it works

The suite ships a meta-CLI called stay that acts as a unified entry point:

• Discover available tools with stay list
• Install a product with stay <tool> init
• Use a product with stay <tool> <command>

Each product is a standalone npm package with its own CLI binary. The stay CLI delegates commands to the product binary — it never imports product code directly, keeping installs lightweight.

Architecture

Every product follows the same layered structure:

core   → Business logic (zero external deps)
cli    → Terminal interface (Commander.js)
api    → HTTP interface (Fastify) — optional
web    → Browser UI (React + Vite) — optional

The core package is the source of truth. CLI, API, and programmatic consumers all share the same behaviour through it.