flowguard-ai

A Motia project created with the starter template.

What is Motia?

Motia is an open-source, unified backend framework that eliminates runtime fragmentation by bringing APIs, background jobs, queueing, streaming, state, workflows, AI agents, observability, scaling, and deployment into one unified system using a single core primitive, the Step.

Quick Start

# Start the development server
npm run dev
# or
yarn dev
# or
pnpm dev

This starts the Motia runtime and the Workbench - a powerful UI for developing and debugging your workflows. By default, it's available at http://localhost:3000.

# Test your first endpoint
curl http://localhost:3000/hello

Step Types

Every Step has a type that defines how it triggers:

Type	When it runs	Use case
api	HTTP request	REST APIs, webhooks
event	Event emitted	Background jobs, workflows
cron	Schedule	Cleanup, reports, reminders

Development Commands

# Start Workbench and development server
npm run dev
# or
yarn dev
# or
pnpm dev

# Start production server (without hot reload)
npm run start
# or
yarn start
# or
pnpm start

# Generate TypeScript types from Step configs
npm run generate-types
# or
yarn generate-types
# or
pnpm generate-types

# Build project for deployment
npm run build
# or
yarn build
# or
pnpm build

Project Structure

steps/              # Your Step definitions (or use src/)
motia.config.ts     # Motia configuration

Steps are auto-discovered from your steps/ or src/ directories - no manual registration required.

Learn More

• Documentation - Complete guides and API reference
• Quick Start Guide - Detailed getting started tutorial
• Core Concepts - Learn about Steps and Motia architecture
• Discord Community - Get help and connect with other developers