Hot App

The Hot App provides real-time visibility into your Hot executions, events, and workflows. Access it at app.hot.dev after signing up.

Overview

The Hot App gives you complete observability into your Hot platform:

• Real-time execution monitoring - Watch runs as they happen
• Full execution traces - See every step, timing, and result
• Event inspection - View incoming events and their payloads
• File management - Browse and manage stored files
• Project configuration - Manage environments and settings

Runs

The Runs view shows all executions of your Hot code:

• Status - Success, failure, cancelled, or in-progress
• Duration - How long each run took
• Trigger - What initiated the run (API, event, schedule)
• Timestamp - When the run started

Click on any run to see the full execution trace, including:

• Input parameters
• Each expression evaluated
• Return values
• Any errors or failures
• Timing for each step

Run States

Events

The Events view shows all events received by your Hot application:

• Event type - The event name (e.g., user:created)
• Payload - The event data
• Source - Where the event came from
• Triggered runs - Which handlers processed this event

Events are the primary way to trigger Hot workflows. See Events & Handlers for more on event handlers.

Streams

Streams provide real-time data flow for long-running operations:

• Server-sent events (SSE) for live updates
• WebSocket connections for bidirectional communication
• Streaming responses from AI/LLM integrations

Files

The Files view lets you manage files stored in Hot:

• Upload and download files
• View file metadata (size, type, timestamps)
• Organize files by project

Files can be accessed in your Hot code using the ::hot::file namespace.

Projects

Projects organize your Hot code and configuration:

• Environments - Development, staging, production
• Contexts - Shared configuration values
• API Keys - Authentication for the REST API
• Builds - Deployment history

Environments

Each environment has its own:

• Context values (secrets, configuration)
• Execution history
• API endpoints

This allows you to test in development without affecting production.

Contexts

Contexts store configuration values accessible to your Hot code:

// Access context values
api-key ::hot::ctx/get("API_KEY")
debug-mode ::hot::ctx/get("DEBUG", false)

Set context values in the Hot App or via the CLI:

hot ctx set API_KEY "sk-..."
hot ctx set DEBUG true

Organizations & Teams

Hot supports multi-tenant organization structures:

• Organizations - Top-level accounts for billing
• Teams - Groups of users within an organization
• Projects - Belong to teams

User Roles

Getting Started

1. Sign up at app.hot.dev
2. Create an organization
3. Create a project
4. Deploy your Hot code with hot deploy
5. View executions in the Hot App