This package provides bidirectional real-time synchronization with Pronghorn.
# Extract ZIP, then:
npm install
npm startgit clone https://github.com/pronghorn-red/pronghorn-runner.git
cd pronghorn-runner
# Download your .run from Pronghorn and place it here
npm install
npm startAll configuration is in the .run file (same format as .env, different name to avoid conflicts). Key settings:
PROJECT_TYPE=vue_vite # vue_vite, react_vite, node, python, go, ruby, rust, elixir, docker
RUN_COMMAND=npm run dev
BUILD_COMMAND=npm run build
INSTALL_COMMAND=npm install| Variable | Default | Description |
|---|---|---|
REBUILD_ON_STAGING |
true |
Sync when files are staged |
REBUILD_ON_FILES |
true |
Sync when files are committed |
PUSH_LOCAL_CHANGES |
true |
Push local edits back to cloud |
SYNC_PROJECT_DATA |
false |
Export requirements, canvas, artifacts to ./project |
PROJECT_SYNC_FOLDER |
./project |
Folder for project data exports |
| Type | Runtime | Install Command | Run Command |
|---|---|---|---|
| vue_vite | Node.js | npm install | npm run dev |
| react_vite | Node.js | npm install | npm run dev |
| node | Node.js | npm install | node index.js |
| python | Python 3 | pip install -r requirements.txt | python main.py |
| go | Go 1.18+ | go mod download | ./app |
| ruby | Ruby | bundle install | bundle exec ruby app.rb |
| rust | Rust | - | cargo run --release |
| elixir | Elixir | mix deps.get | mix phx.server |
| docker | Docker | - | docker-compose up |
- Downloads all files from Pronghorn to
./app/ - Listens for real-time changes
- Updates files when changes detected
- Hot-reloads or restarts server as needed
- Watches
./app/for file changes - Automatically pushes edits to Pronghorn staging
- Binary files are skipped
Create a .runignore file to exclude paths from sync (same syntax as .gitignore):
# Example .runignore
background/logs/
*.log
.cache/
temp/
This prevents files matching these patterns from:
- Being synced FROM cloud TO local
- Being pushed FROM local TO cloud
- Causing continuous sync loops (e.g., log files)
When SYNC_PROJECT_DATA=true:
- Exports project settings to
./project/settings/folder - Exports requirements to
./project/requirements/folder - Exports canvas nodes/edges to
./project/canvas/folder - Exports artifacts to
./project/artifacts/folder - Exports specifications to
./project/specifications/folder - Exports chat sessions to
./project/chats/folder - Exports repositories to
./project/repositories/folder - Exports databases to
./project/databases/folder - Exports deployments to
./project/deployments/folder - Real-time sync: updates when project data changes in Pronghorn
| Property | Value |
|---|---|
| Project | E2E Testing |
| Environment | dev |
| Project Type | node |
| Run Command | node index.js |
| Repository | https://github.com/pronghorn-cloud/deleteme-5bb755fb |
Run npm install in this directory.
- Check
PRONGHORN_SHARE_TOKENis set in.run - Ensure
PRONGHORN_REPO_IDis correct
Change APP_PORT in your .run file.
Generated by Pronghorn.RED - Real-Time Development Platform