Documentation

Introduction

• What is Tiny Systems?
• Core Concepts
• Architecture Overview
• Quick Start

Getting Started

• MCP Server Setup
• Running and Debugging

Flows

• Flow Basics
• Nodes and Edges
• Data Mapping
• Error Handling

Expressions

• Expression Syntax
• JSONPath Reference
• Operators and Functions
• Expression Examples

Clusters

• Cluster Requirements

Modules

• Installing Modules
• Available Modules
• Module Configuration

Solutions

• Publishing Solutions

Maintenance

• Uninstall

Core Concepts

• Component Model
• Ports and Messages
• Message Flow
• Blocking vs Async
• Error Handling

Components

• Component Interface
• Defining Ports
• Handling Messages
• Settings and Configuration
• Control Ports
• System Ports
• Component Patterns

Schema

• JSON Schema Basics
• Schema from Go
• Secrets in Settings
• Dynamic Schemas
• Configurable Overlay

Kubernetes

• Architecture
• TinyNode CRD
• TinyModule CRD
• Signals (NATS wire)
• Controller Reconciliation
• Leader Election

Scalability

• Module Discovery
• CR-Based State Propagation
• Leader-Reader Pattern
• Multi-Replica Coordination
• Horizontal Scaling

Communication

• gRPC Fundamentals
• Internal Routing
• Cross-Module Communication
• Client Pool

Advanced

• Testing Components
• Resource Manager
• Ingress Exposure
• Observability
• Debugging
• Project JSON Generation

CLI

• CLI Overview
• Development Commands
• Module Scaffold
• Local Testing

Publishing

• Building Modules
• Helm Charts
• Registry Publishing
• Versioning

API Reference

• Kubernetes API
• Component Interface
• Port Interface
• Handler Interface

Struct Tags

• Complete Reference

System Ports

• System Ports Reference

Component Examples

• Simple Transformer
• Conditional Router
• Array Iterator
• Periodic Emitter
• HTTP Server
• HTTP Client
• Database Connector
• Stateful Component

Flow Examples

• Webhook to Slack
• API Integration

Contributing

• Create a Module

Appendix

• Glossary
• FAQ
• Migration Guide
• Changelog