feat: add start command to docs and templates (#996)

Author: glauberfc

packages/docs/content/docs/api-reference.mdx

@@ -1391,7 +1391,7 @@ motia dev --port 4000 --host 0.0.0.0
 
 ### `motia start`
 
-Start production server (no Workbench, no hot reload).
+Start production server without hot reload. Workbench is included by default (can be disabled via `MOTIA_DOCKER_DISABLE_WORKBENCH` environment variable).
 
 ```bash
 motia start

packages/docs/content/docs/development-guide/cli.mdx

@@ -110,7 +110,7 @@ The deployment process:
 
 ### `dev`
 
-Start the development server.
+Start the development server with hot reload and Workbench.
 
 ```bash
 npx motia dev [options]
@@ -121,6 +121,36 @@ Options:
 - `-p, --port <port>`: The port to run the server on (default: 3000).
 - `-H, --host [host]`: The host address for the server (default: localhost).
 - `-d, --debug`: Enable debug logging.
+- `-m, --mermaid`: Enable Mermaid diagram generation.
+- `--motia-dir <path>`: Custom path for `.motia` folder.
+
+### `start`
+
+Start the production server without hot reload. Workbench is included by default (can be disabled via `MOTIA_DOCKER_DISABLE_WORKBENCH` environment variable).
+
+```bash
+npx motia start [options]
+```
+
+Options:
+
+- `-p, --port <port>`: The port to run the server on (default: 3000).
+- `-H, --host [host]`: The host address for the server (default: localhost).
+- `-d, --debug`: Enable debug logging.
+- `--motia-dir <path>`: Custom path for `.motia` folder.
+
+Example:
+
+```bash
+# Start production server on port 8080
+npx motia start --port 8080
+
+# Start on a specific host
+npx motia start --host 0.0.0.0 --port 3000
+
+# Start without Workbench
+MOTIA_DOCKER_DISABLE_WORKBENCH=true npx motia start
+```
 
 ### `get-config`
 

packages/docs/public/llm-docs/concepts/cli.mdx.md

@@ -73,7 +73,7 @@ The deployment process:
 
 ### `dev`
 
-Start the development server.
+Start the development server with hot reload and Workbench.
 
 ```bash
 npx motia dev [options]
@@ -84,6 +84,23 @@ Options:
 - `-p, --port <port>`: The port to run the server on (default: 3000).
 - `-H, --host [host]`: The host address for the server (default: localhost).
 - `-d, --debug`: Enable debug logging.
+- `-m, --mermaid`: Enable Mermaid diagram generation.
+- `--motia-dir <path>`: Custom path for `.motia` folder.
+
+### `start`
+
+Start the production server without hot reload. Workbench is included by default (can be disabled via `MOTIA_DOCKER_DISABLE_WORKBENCH` environment variable).
+
+```bash
+npx motia start [options]
+```
+
+Options:
+
+- `-p, --port <port>`: The port to run the server on (default: 3000).
+- `-H, --host [host]`: The host address for the server (default: localhost).
+- `-d, --debug`: Enable debug logging.
+- `--motia-dir <path>`: Custom path for `.motia` folder.
 
 ### `get-config`
 

packages/snap/src/create/index.ts

@@ -125,6 +125,7 @@ export const create = async ({ projectName, template, cursorEnabled, context }:
       scripts: {
         postinstall: 'motia install',
         dev: 'motia dev',
+        start: 'motia start',
         'generate-types': 'motia generate-types',
         build: 'motia build',
         clean: 'rm -rf dist node_modules python_modules .motia .mermaid',

packages/snap/src/create/templates/hello/README.md.txt

@@ -44,6 +44,13 @@ 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

packages/snap/src/create/templates/hello_js/README.md.txt

@@ -44,6 +44,13 @@ 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

packages/snap/src/create/templates/hello_python/README.md.txt

@@ -44,6 +44,13 @@ 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

packages/snap/src/create/templates/nodejs/README.md.txt

@@ -43,6 +43,13 @@ 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

packages/snap/src/create/templates/python/README.md.txt

@@ -43,6 +43,13 @@ 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

packages/snap/src/cursor-rules/dot-files/AGENTS.md

@@ -20,9 +20,12 @@ This is a **Motia** application - a framework for building event-driven, type-sa
 # Install dependencies
 npm install
 
-# Start development server
+# Start development server (with hot reload)
 npm run dev
 
+# Start production server (without hot reload)
+npm run start
+
 # Generate TypeScript types from steps
 npx motia generate-types
 ```