Set Up Your Machine

This step installs the command-line tools Mosayic uses. The dashboard probes your machine and tells you which tools are missing — you only need to install the ones it flags.

What gets installed

Tool	What it’s for	How Mosayic uses it
Node.js (via nvm)	JavaScript runtime	Running Expo, EAS, npm
Docker Desktop	Containers	Running Supabase locally
GitHub CLI (gh)	GitHub from the terminal	Creating repos, setting Actions secrets, creating releases
Google Cloud CLI (gcloud)	Google Cloud from the terminal	Deploying your API to Cloud Run, managing Secret Manager
Supabase CLI	Supabase from the terminal	Starting local Supabase, running migrations
EAS CLI	Expo Application Services	Building dev builds and production builds
Claude Code (recommended)	AI coding assistant	Implementing features in your codebase

Install commands by platform

The dashboard runs these commands for you when you click Install missing tools — but here they are if you’d rather run them yourself.

macOS

# nvm + Node
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.40.1/install.sh | bash
nvm install --lts

# Docker Desktop — install from https://docker.com/products/docker-desktop

# GitHub CLI
brew install gh

# Google Cloud CLI
brew install --cask google-cloud-sdk

# Supabase CLI
brew install supabase/tap/supabase

# EAS CLI
npm install -g eas-cli

# Claude Code (optional)
npm install -g @anthropic-ai/claude-code

Windows

# Node.js — install LTS from https://nodejs.org

# Docker Desktop — install from https://docker.com/products/docker-desktop

# GitHub CLI
winget install --id GitHub.cli

# Google Cloud CLI
winget install Google.CloudSDK

# Supabase CLI
scoop bucket add supabase https://github.com/supabase/scoop-bucket.git
scoop install supabase

# EAS CLI
npm install -g eas-cli

# Claude Code (optional)
npm install -g @anthropic-ai/claude-code

Tip

On Windows, Mosayic defaults to running commands through cmd.exe. If you prefer Git Bash or PowerShell 7, set mosayic.windowsShell in your VS Code settings. See Extension Settings.

Linux

# nvm + Node
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.40.1/install.sh | bash
nvm install --lts

# Docker — follow https://docs.docker.com/engine/install/

# GitHub CLI
sudo apt install gh   # Debian/Ubuntu
# or: sudo dnf install gh  # Fedora

# Google Cloud CLI — follow https://cloud.google.com/sdk/docs/install

# Supabase CLI
# Follow https://supabase.com/docs/guides/cli/getting-started

# EAS CLI
npm install -g eas-cli

# Claude Code (optional)
npm install -g @anthropic-ai/claude-code

Why Claude Code?

Mosayic doesn’t require an AI coding assistant — but Mosayic projects are deliberately structured to play well with one. The codebase is opinionated, the patterns are consistent, and there’s plenty of shared context for the AI to draw on. The Blueprint cards even include ready-to-paste prompts for common features.

We recommend Claude Code because:

• It runs locally in your terminal — no copy-pasting code snippets in and out of a chat window
• It can read and modify whole files, run commands, and verify its own work
• It works with the same Anthropic API tier you’d already be using if you were calling Claude directly

You can also use Cursor, GitHub Copilot, Aider, or anything else. The Blueprint instructions are model-agnostic.

How the dashboard verifies

After installation, click Re-check in the dashboard. It runs a probe (POST /system/probe-tools to the backend, which relays to your extension) that runs a --version check on each tool. The result looks like:

Tool	Status	Version
node	✅ installed	v22.11.0
docker	✅ installed	27.3.1
gh	✅ installed	2.62.0
gcloud	✅ installed	502.0.0
supabase	✅ installed	1.226.4
eas	✅ installed	14.2.0
claude	⚠️ not installed	—

You can continue without Claude — it’s recommended, not required.

Caution

Docker must be running, not just installed. The dashboard checks this separately and surfaces a warning if Docker is installed but the daemon isn’t up. Start Docker Desktop before running the next step.

Next

Continue to Configure Your Project — this is where Mosayic actually creates the folder for your code.