Skip to content

Commit 9c01c45

Browse files
committed
chore: add local-temporal skill
1 parent 3eafefb commit 9c01c45

File tree

1 file changed

+40
-0
lines changed

1 file changed

+40
-0
lines changed
Lines changed: 40 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,40 @@
1+
---
2+
name: local-temporal
3+
description: Instructions for running the UI against a local Temporal server build instead of the built-in CLI dev server. Use when asked how to start the dev environment, run the UI locally, or connect to a local Temporal repo.
4+
---
5+
6+
# Local Temporal Dev Setup
7+
8+
To develop against a local build of the Temporal server, you need two things running in separate terminals.
9+
10+
## Terminal 1 — Temporal server (from your local temporal repo)
11+
12+
Navigate to your local clone of the `temporalio/temporal` repo and start the server:
13+
14+
```bash
15+
make start
16+
```
17+
18+
This builds and starts the server with SQLite in-memory. If you want a specific branch, check it out first:
19+
20+
```bash
21+
git checkout <branch-name>
22+
make bins # safe to run even if already built — outputs "Nothing to be done" and exits cleanly
23+
make start
24+
```
25+
26+
The server runs gRPC on port `7233` and HTTP on `7243`.
27+
28+
## Terminal 2 — UI dev server (this repo)
29+
30+
From this repo, use the `local-temporal` script instead of the default `dev` script:
31+
32+
```bash
33+
pnpm dev:local-temporal
34+
```
35+
36+
This loads `.env.local-temporal` which points the UI at the local server instead of spinning up its own.
37+
38+
## Why not `pnpm dev`?
39+
40+
`pnpm dev` (aliased to `pnpm dev:ui-server`) starts a bundled Temporal server alongside the UI. `pnpm dev:local-temporal` skips that and connects to whatever is already running on the configured ports.

0 commit comments

Comments
 (0)