Quick Start

Get up and running with TinySystems in minutes. This guide walks you through creating your first flow.

Prerequisites

• A TinySystems account (sign up here)
• A connected Kubernetes cluster (or use the shared environment)

Step 1: Create a Project

1. Log in to the TinySystems platform
2. Click New Project
3. Enter a name (e.g., "My First Project")
4. Click Create

Step 2: Create a Flow

1. Inside your project, click New Flow
2. Name it "Hello World"
3. You'll see the visual flow editor

Step 3: Add Components

Let's build a simple HTTP echo service:

Add an HTTP Server

1. From the component palette, find HTTP Server (http-module)
2. Drag it onto the canvas
3. Click on the node to configure:
   • Leave default settings
   • Note the Request output port (right side)

Add a Modify Component

1. Find Modify (common-module)
2. Drag it onto the canvas to the right of HTTP Server
3. This component passes data through unchanged

Add an HTTP Response

1. The HTTP Server has a Response input port
2. We'll connect the modify output back to it

Step 4: Connect the Nodes

1. Click on the Request port (right side of HTTP Server)
2. Drag to the Input port (left side of Modify)
3. A connection line appears

Now connect Modify back to the response:

1. Click on the Output port of Modify
2. Drag to the Response port of HTTP Server

Step 5: Configure Data Mapping

Click on the edge between Modify and HTTP Response. Configure the response:

{
  "body": "{{$.context}}",
  "statusCode": 200,
  "contentType": "application/json"
}

This returns whatever was received in the request.

Step 6: Deploy and Test

1. Click Deploy in the top toolbar
2. Wait for the deployment to complete
3. Find the generated URL in the HTTP Server settings
4. Test with curl:

curl -X POST https://your-url.tinysystems.io/hello \
  -H "Content-Type: application/json" \
  -d '{"message": "Hello World"}'

You should see the same JSON echoed back!

What Just Happened?

HTTP Request → HTTP Server → Modify → HTTP Response
     │              │           │           │
     │              ▼           ▼           │
     │         TinyNode    TinyNode         │
     │         (CRD)       (CRD)            │
     │              │           │           │
     └──────────────┴───────────┴───────────┘
              Kubernetes Cluster

1. Your flow was translated into TinyNode CRDs
2. The http-module operator received the HTTP request
3. Data flowed through the Modify component
4. The response was sent back to the client

Next Steps

Now that you've created your first flow, explore further:

For Users

• Creating Flows - Detailed flow creation guide
• Expression Syntax - Transform data between nodes
• Connecting Clusters - Use your own Kubernetes cluster

For Developers

• Build Custom Components - Create your own modules
• Component Patterns - Common implementation patterns
• Kubernetes Architecture - Understand the runtime

Example Flows

Here are some ideas to try next:

Webhook to Slack

Receive webhooks and post to Slack:

HTTP Server → Router → HTTP Client (Slack API)

Scheduled Data Sync

Periodically fetch and process data:

Ticker → HTTP Client → Split → Process Each

API Aggregator

Combine multiple API calls:

HTTP Server → Parallel HTTP Clients → Merge → Response

Getting Help

• Check the FAQ for common questions
• Browse Examples for more patterns
• Visit our GitHub for source code