★
StellarX PHSoroban Workshop · PUP QC
StellarX PH Roadshow Series —

Get Your Machine
Workshop-Ready

Everything to install before the Soroban Workshop at PUP Quezon City, plus the steps to officially join the StellarX program. Work top to bottom and tick each item off.

PUP QC · Don Fabian, Quezon City 6 setup steps ~45-60 min total

Setup progress

0 / 6 done
Machine ready — now finish the Before You Go checklist below.
Prep —

The Setup Checklist

Tap each item as you finish. Full step-by-step for both Windows and macOS is below — use the WINDOWS / MACOS switch up top.

01 Install Node.js
LTS version — powers npm + the AI CLI
Guide
02 Install VS Code
Your code editor for the day
Guide
03 Create a Freighter wallet
Browser wallet for the Stellar network
Guide
04 Set up an AI coding CLI
Gemini CLI, Codex, or any local AI model
Guide
05 Install Rust + Stellar CLI
Soroban contracts are written in Rust
Guide
06 Add the Stellar Dev Skill
Give your AI agent deep Stellar knowledge
Guide
Step-by-step —

Detailed Setup

Each tool, with separate Windows and macOS paths. After installing, run the verify command to confirm it worked.

1

Node.js Required

JavaScript runtime. It also installs npm, which you'll use to install the AI CLI and the dev skill.

Download Node.js (LTS)
Windows
  1. Open nodejs.org/en/download and grab the Windows Installer (.msi) — pick LTS.
  2. Run the .msi, click Next through the defaults (leave "Add to PATH" checked).
  3. Finish, then close and reopen any open terminal / PowerShell windows.
Verify in PowerShell or Command Prompt:
node -v # and: npm -v
macOS
  1. Open nodejs.org/en/download and grab the macOS Installer (.pkg) — pick LTS.
  2. Open the .pkg and follow the prompts (Continue → Agree → Install). Enter your Mac password if asked.
  3. Open the Terminal app (Spotlight → type "Terminal").
i
Prefer Homebrew? If you have it: brew install node works too.
Verify in Terminal:
node -v # and: npm -v
!
You're good if both print a version number (e.g. v22.x.x). The AI CLI in step 4 needs Node 20 or higher.
2

Visual Studio Code Required

The free code editor we'll use to write and run everything.

Download VS Code
Windows
  1. Go to code.visualstudio.com/download and click the Windows button.
  2. Run the .exe. On "Additional Tasks", tick "Add to PATH" and "Open with Code".
  3. Launch VS Code. Open the built-in terminal with Ctrl + ` (backtick key).
macOS
  1. Go to code.visualstudio.com/download and click the Mac button (Universal).
  2. Unzip, then drag Visual Studio Code.app into your Applications folder.
  3. Open it. Open the built-in terminal with Cmd + ` (backtick key).
i
If macOS blocks it as "from an unidentified developer", right-click the app → Open → Open again.
3

Freighter Wallet Required

A browser-extension wallet for the Stellar network — you'll use it to sign and test transactions.

Get Freighter
!
Use a desktop browser (Chrome, Brave, Firefox, or Edge). Freighter is a browser extension — steps are the same on Windows and macOS.
  1. Open freighter.app and click "Add to [your browser]" to install the extension.
  2. Click the Freighter icon in your toolbar → Create new wallet and set a password.
  3. Write your 12-word recovery phrase on paper and keep it private. Confirm it to finish.
  4. Open Freighter → settings → switch the network to Test Net (test tokens, not real money).
i
Tip: while on Test Net, use Freighter's "Fund with Friendbot" button to load free test XLM — you'll need it to pay transaction fees. (We can also do this together at the workshop.)
!
Security: never share your recovery phrase or password with anyone — not even facilitators. No one from the workshop will ever ask for it.
4

AI Coding CLI Required

An AI agent in your terminal to help write Soroban contracts. Pick one — Gemini CLI is the easiest free option. (Needs Node from step 1.)

Gemini CLI Free

1,000 requests/day with a Google account. Recommended starting point.

Codex CLI

OpenAI's terminal agent. Needs a ChatGPT/OpenAI sign-in.

Claude Code

Anthropic's terminal agent. Needs a Claude account.

Any local model

Already use something else? Bring it — any local AI is fine.

Windows · PowerShell
macOS · Terminal
Option A — Gemini CLI (install, then launch):
npm install -g @google/gemini-cli
gemini # then sign in with Google
Option B — Codex CLI (OpenAI):
npm install -g @openai/codex # then: codex
i
On Windows, Codex CLI support is still experimental — OpenAI recommends running it inside WSL. On Windows, Gemini CLI (Option A) is the easier pick.
Option C — Claude Code (Anthropic) — installs without npm:
winget install Anthropic.ClaudeCode # then: claude
brew install --cask claude-code # then: claude
!
Windows tip: if you see "running scripts is disabled", run Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser, then retry. macOS tip: if you hit permission errors, don't use sudo — make sure Node installed cleanly in step 1.
5

Rust + Stellar CLI Required

Soroban contracts are written in Rust. Rust compiles your contract; the Stellar CLI (formerly the Soroban CLI) builds, deploys, and tests it. This install is the longest — give it extra time.

Windows
  1. Install Rust: download and run rustup-init.exe, press Enter for defaults, then reopen your terminal.
  2. Install the Stellar CLI with winget (below).
  3. Add the WebAssembly build target (below).
winget install --id Stellar.StellarCLI
rustup target add wasm32v1-none
i
The Stellar CLI uses emojis — for best results run it inside Windows Terminal rather than the old Command Prompt.
macOS
  1. Install Rust with rustup (below), then restart Terminal.
  2. Install the Stellar CLI with Homebrew (below). No Homebrew? Get it at brew.sh.
  3. Add the WebAssembly build target (below).
curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh
brew install stellar-cli
rustup target add wasm32v1-none
Verify both: rustc --version · stellar --version
i
Rust v1.84.0 or higher is needed for the wasm32v1-none target. If it's missing, run rustup update first.
6

Stellar Dev Skill Required

An official AI skill that teaches your coding agent modern Stellar development — Soroban, the SDKs, RPC, Freighter, testing, and security best practices. Add it so your AI gives accurate, up-to-date Stellar help.

View on GitHub
Recommended — works with any agent that supports the Agent Skills standard (needs Node):
npx skills add https://github.com/stellar/stellar-dev-skill
Using Claude Code? Run these two commands inside Claude Code:
/plugin marketplace add stellar/stellar-dev-skill
/plugin install stellar-dev@stellar-dev-skill
i
Prefer manual install? git clone the repo and copy its skill/ folder into your agent's skills directory — Claude Code: ~/.claude/skills/, OpenAI Codex: ~/.codex/skills/. Then try a prompt like "Help me write a Soroban smart contract for a token."
i
Using Gemini CLI or another agent without skill support? You can skip this step — we'll make sure everyone is set up at the workshop.
Event —

On The Day

Bring with you

  • Laptop with all 6 setup steps done + charger
  • A Google account (for Gemini CLI sign-in)
  • A GitHub account (for the submission step)
  • Freighter recovery phrase kept safe (not on the laptop)

What to expect

  • Free lunch, merch giveaways & prizes for active participants
  • Intro to StellarX, real-world use cases & hands-on building
  • Open Q&A, community onboarding & networking with builders
  • A Soroban Workshop Certificate to take home
Build —

Project Resources

Start from the official project template below, then use these resources to pick an idea and submit your build.

Workshop Repo

The main StellarX workshop repository — issues, templates, and everything you need for your submission.

github.com/shashis132/stellarX-workshop

300 Project Ideas

Stuck on what to build? Browse 300 starter ideas for Stellar projects and pick one to run with.

stellar-300-ideas.md

Submission Guidelines

Exactly how to format and submit your project so it qualifies for the StellarX program.

SUBMISSION_GUIDELINES.md
Before You Go —

Complete This Checklist

Once your machine is set up and you've built your project, finish these four to officially join the program. Tap each as you go.

01
Joined Telegram
You're in the group and have unmuted notifications.
t.me/stellarxPH
02
Followed on X (Twitter)
You're following @Stellar_X101 and tagged us in a live tweet.
@Stellar_X101
03
Submitted PR on the Repo
You opened a GitHub Issue on github.com/shashis132/stellarX-workshop with your project details.
github.com/shashis132/stellarX-workshop
04
Submitted Link on SwitchX
You pasted your GitHub Issue URL into the SwitchX platform and confirmed receipt.
app.switchx.pro/camp/stellarx-philippines
0 / 4 complete
All 4 done? You're officially in the StellarX program. Build fast. Launch bigger.