Quick Start

Start with a template

Make sure to install iii (https://iii.dev/docs) and create a new project
with git clone git@github.com:MotiaDev/motia-iii-example.git before proceeding.

1. Start the project

Navigate into your new project directory and start iii. The config.yaml in the project folder tells iii how to run Motia so starting iii starts both!

cd motia-iii-example 
npm install
iii -c iii-config.yaml

2. Run Your First Flow

This example is a ticketing system for user issues. Try it out:

# Create a ticket
curl -X POST http://localhost:3111/tickets \
  -H "Content-Type: application/json" \
  -d '{"title":"Login issue","description":"User is having trouble creating an account","priority":"high","customerEmail":"user@example.com"}' | jq

# List all tickets
curl http://localhost:3111/tickets | jq

3. Read the code

The application code is in the src/ folder and iii-config.yaml describes the infrastructure that iii sets up to power Motia.

4. Try the iii Console

iii is in alpha

Motia and iii are under very active development. We will be regularly updating Motia, iii, and iii console to address any issues.

Motia now works with iii's web console and provides complete observability of Motia projects running on a iii daemon. Install and start it in a new terminal window with:

curl -fsSL https://install.iii.dev/console/main/install.sh | sh
iii-console --enable-flow

Then open your web browser to: http://localhost:3113/

Next Steps

Congratulations! You've successfully ran, your first Motia workflow.

1. Start the project

2. Run Your First Flow

3. Read the code

4. Try the iii Console

Next Steps

On this page