@mudlab/create-workflow 1.0.0 → 1.0.2

package/README.md

@@ -15,14 +15,20 @@ npx @mudlab/create-workflow my-automations
 yarn create @mudlab/workflow my-automations
 ```
 
-Then:
+Then set up your API key:
 
 ```bash
 cd my-automations
 cp .env.example .env
-# Add your Mudlab API key to .env
 ```
 
+Get your Mudlab API key:
+1. Log into your [Mudlab](https://mudlab.io) agency account
+2. Click **API Keys** in the left sidebar
+3. Click **Generate API Key**
+4. Name it `Push Mudlab Workflow Claude Code`
+5. Copy the key and add it to `.env`
+
 ## What You Get
 
 ```

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mudlab/create-workflow",
-  "version": "1.0.0",
+  "version": "1.0.2",
   "description": "Create Mudlab workflow projects with a single command",
   "bin": {
     "create-mudlab-workflow": "./bin/create.js"

package/template/.env.example

@@ -1,9 +1,24 @@
-# Mudlab API Configuration
-MUDLAB_API_URL=http://localhost:3000
+# ===========================================
+# MUDLAB API (Required for pushing workflows)
+# ===========================================
+# Get your API key:
+#   1. Log into https://mudlab.io
+#   2. Click "API Keys" in the left sidebar
+#   3. Generate a key named "Push Mudlab Workflow Claude Code"
+MUDLAB_API_URL=https://mudlab.io
 MUDLAB_API_KEY=your_mudlab_api_key_here
 
-# Add your integration API keys below
-# These are passed to tools when running workflows locally
+# ===========================================
+# INTEGRATION KEYS (For local testing only)
+# ===========================================
+# These keys are used when running tools locally with Node.js.
+#
+# FOR PRODUCTION: Add these in Mudlab UI instead:
+#   1. Log into https://mudlab.io
+#   2. Click "Environment Variables" in the left sidebar (below API Keys)
+#   3. Add your variables there
+#
+# The variable NAMES you define here should match what you add in Mudlab.
 # Example:
 # NOTION_API_KEY=your_notion_api_key
 # NOTION_DATABASE_ID=your_database_id

package/template/README.md

@@ -4,12 +4,42 @@ Automated workflows powered by [Mudlab](https://mudlab.io).
 
 ## Setup
 
-1. Copy `.env.example` to `.env` and add your API keys:
+1. Copy `.env.example` to `.env`:
    ```bash
    cp .env.example .env
    ```
 
-2. Edit `.env` with your Mudlab API key and any integration keys you need.
+2. Get your Mudlab API key:
+   1. Log into your [Mudlab](https://mudlab.io) agency account
+   2. Click **API Keys** in the left sidebar
+   3. Click **Generate API Key**
+   4. Name it `Push Mudlab Workflow Claude Code`
+   5. Copy the key
+
+3. Add the key to `.env`:
+   ```
+   MUDLAB_API_KEY=ml_your_key_here
+   ```
+
+4. (Optional) Add integration keys for **local testing**:
+   ```
+   NOTION_API_KEY=your_notion_api_key
+   RESEND_API_KEY=your_resend_api_key
+   ```
+
+## Environment Variables
+
+Your workflows reference environment variable **names** (like `NOTION_API_KEY`). The actual values are stored in two places:
+
+| Environment | Where to add keys | Used for |
+|-------------|-------------------|----------|
+| **Local** | `.env` file | Testing tools with `node` |
+| **Production** | Mudlab UI | Running workflows via webhooks |
+
+**To add production keys in Mudlab:**
+1. Log into [Mudlab](https://mudlab.io)
+2. Click **Environment Variables** in the left sidebar (below API Keys)
+3. Add your variables (use the same names as in your workflow definitions)
 
 ## Creating Workflows