Developer Environment Quickstart

Consolidated setup of all essential development tools. For detailed instructions, see the Complete Setup Guide.

Company Employees

Ybor employees: Complete Ybor Employee Onboarding first for company-specific requirements.

Overview

Time: ~15 minutes
Result: Complete professional development environment

---

Step 1: Package Managers

macOS - Homebrew

Installation: Follow the official guide at Homebrew.sh

Quick install: /bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

Windows - Chocolatey + PowerShell 7

Installation: Follow the official guide at Chocolatey Install

PowerShell 7: Install from Microsoft PowerShell Docs

Quick setup:

1. Install Chocolatey (see official docs)
2. Install PowerShell 7: choco install powershell-core -y
3. Use PowerShell 7 for remaining steps

Windows - Manual Installation (No Package Manager)

For users unable to use Chocolatey/Winget (corporate restrictions, permissions, etc.):

Required Downloads:

1. PowerShell 7: GitHub Releases - Download .msi installer
2. Git: git-scm.com/download/win - Download Git for Windows
3. Node.js: nodejs.org/download - Download LTS .msi installer
4. Java 17: aws.amazon.com/corretto - Download Windows x64 .msi
5. Docker Desktop: docker.com/products/docker-desktop - Download Windows installer
6. VS Code: code.visualstudio.com/download - Download Windows installer
7. Visual Studio Build Tools: visualstudio.microsoft.com/downloads - Scroll to "Tools for Visual Studio"

Installation Order:

1. Install PowerShell 7 first (restart terminal after)
2. Install Git (add to PATH when prompted)
3. Install Node.js (automatic PATH configuration)
4. Install Java 17 (note installation path for JAVA_HOME)
5. Install Docker Desktop (requires restart)
6. Install VS Code
7. Install Visual Studio Build Tools (select "C++ build tools" workload)

Manual PATH Configuration (if needed):

• Press Win + R, type sysdm.cpl, press Enter
• Click "Environment Variables"
• Edit "PATH" under "User variables"
• Add installation directories as needed

Linux - Native Package Managers

Use your distribution's package manager. No additional setup needed.

---

Step 2: Core Development Tools

Install these essential tools using the official installation guides:

Required Tools

Tool	Official Documentation	Quick Reference
Git	git-scm.com/downloads	brew install git / choco install git
Node.js	nodejs.org	brew install node@20 / choco install nodejs-lts
Java 17	aws.amazon.com/corretto	brew install --cask corretto17 / choco install corretto17jdk
Docker	docs.docker.com/get-docker	brew install --cask docker / choco install docker-desktop
VS Code	code.visualstudio.com	brew install --cask visual-studio-code / choco install vscode

Build Tools

Platform	Tool	Documentation
macOS	Xcode Command Line Tools	xcode-select --install
Windows	Visual Studio Build Tools	visualstudio.microsoft.com
Linux	Build Essential	sudo apt install build-essential

Quick Install Commands

# macOS (after installing Homebrew)
brew install git node@20 openjdk@17 docker && brew install --cask visual-studio-code
xcode-select --install

# Windows (after installing Chocolatey + PowerShell 7)
choco install git nodejs-lts openjdk17 docker-desktop vscode visualstudio2022buildtools -y

# Windows Manual Installation - See "Windows - Manual Installation" section above

# Linux (Ubuntu/Debian)
sudo apt install -y git nodejs npm openjdk-17-jdk docker.io build-essential code

---

Step 3: Environment Setup

Git Configuration

# Replace with your info
git config --global user.name "Your Name"
git config --global user.email "your.email@example.com"
git config --global init.defaultBranch main

# Generate SSH key for GitHub/GitLab
ssh-keygen -t ed25519 -C "your.email@example.com"
ssh-add ~/.ssh/id_ed25519

# Copy public key (add to GitHub/GitLab)
# macOS: pbcopy < ~/.ssh/id_ed25519.pub
# Windows: Get-Content ~/.ssh/id_ed25519.pub | Set-Clipboard
# Linux: cat ~/.ssh/id_ed25519.pub | xclip -selection clipboard

Java Environment (if needed)

Most package managers auto-configure Java. If java -version fails:

# macOS
export JAVA_HOME=$(/usr/libexec/java_home -v 17)

# Linux  
export JAVA_HOME=/usr/lib/jvm/java-17-openjdk-amd64

# Windows PowerShell (auto-detects Java installation)
if (-not $env:JAVA_HOME) {
    $javaPath = (Get-Command java).Path
    $javaHome = Split-Path (Split-Path $javaPath -Parent) -Parent
    [Environment]::SetEnvironmentVariable("JAVA_HOME", $javaHome, "User")
}

---

Step 4: Platform Tools (Company/Optional)

If you have company access:

# P6M Platform CLI (company-specific)
npm install -g p6m-cli

# Verify P6M
p6m --version

Archetect (project templates): Follow the official installation guide at Archetect Installation

Quick Archetect install options:

• macOS/Linux: brew tap archetect/tap && brew install archetect
• Windows: Download binary from GitHub releases
• Any OS: Build from source with Rust toolchain

# Verify Archetect after installation
archetect --version

Public alternatives:

Tool	Official Documentation	Purpose
Create React App	create-react-app.dev	React project generator
Vue CLI	cli.vuejs.org	Vue.js project generator
Yeoman	yeoman.io	Generic project generator
Archetect	archetect.github.io	Git-based project templates

# Quick install commands (after Node.js is installed)
npm install -g create-react-app @vue/cli yo

---

Step 5: Kubernetes Tools (Optional)

Install using official documentation for the most current versions:

Kubernetes Tools

Tool	Official Documentation	Purpose
kubectl	kubernetes.io/docs/tasks/tools	Kubernetes CLI
k9s	k9scli.io	Kubernetes dashboard
Helm	helm.sh/docs/intro/install	Kubernetes package manager

Quick Install Commands

# macOS (Homebrew)
brew install kubectl k9s helm

# Windows (Chocolatey)
choco install kubernetes-cli k9s kubernetes-helm -y

# Linux - see official docs for your distribution
# kubectl: kubernetes.io/docs/tasks/tools/install-kubectl-linux/
# k9s: github.com/derailed/k9s/releases
# helm: helm.sh/docs/intro/install/

---

Verification

Run these commands to verify everything works:

macOS/Linux

# Core tools
git --version && node --version && java -version && docker --version

# Build tools
gcc --version && pkg-config --modversion openssl

# Platform tools (if installed)
p6m --version
archetect --version  # See installation guide: https://archetect.github.io/docs/getting-started/installation

# Kubernetes tools (if installed)
kubectl version --client && k9s version

# Test functionality
docker run hello-world
git config --get user.name
ssh -T git@github.com  # Should authenticate if SSH key added

Windows (PowerShell 7)

# Core tools
git --version; node --version; java -version; docker --version

# Build tools
where cl  # Visual Studio compiler

# Platform tools (if installed)
p6m --version
archetect --version  # See installation guide: https://archetect.github.io/docs/getting-started/installation

# Kubernetes tools (if installed)
kubectl version --client; k9s version; helm version

# Test functionality
docker run hello-world
git config --get user.name
ssh -T git@github.com  # Should authenticate if SSH key added

# Verify PowerShell version
$PSVersionTable.PSVersion

---

Quick Project Test

macOS/Linux

# Create test project
mkdir my-test-project && cd my-test-project

# Initialize
git init && npm init -y

# Create simple app
echo 'console.log("Environment ready!");' > app.js

# Test
node app.js && git add . && git commit -m "Initial commit"

# Open in VS Code
code .

Windows (PowerShell 7)

# Create test project
mkdir my-test-project; cd my-test-project

# Initialize
git init; npm init -y

# Create simple app
'console.log("Environment ready!");' | Out-File -Encoding UTF8 app.js

# Test
node app.js; git add .; git commit -m "Initial commit"

# Open in VS Code
code .

Expected Results:

• "Environment ready!" prints
• Git commit succeeds
• VS Code opens the project

---

Troubleshooting

Commands not found?

• Restart terminal after installations
• macOS/Linux: Reload shell profile with source ~/.zshrc
• Windows: Run refreshenv in PowerShell 7 or restart PowerShell
• Check PATH: echo $PATH (macOS/Linux) or $env:PATH (Windows)

Docker issues?

• Start Docker Desktop (all platforms)
• Linux: sudo systemctl start docker
• Windows: Ensure Docker Desktop is running and WSL2 is enabled
• Permissions: sudo usermod -aG docker $USER (Linux only)

SSH key issues?

• Generate: ssh-keygen -t ed25519 -C "your.email@example.com"
• Add to agent: ssh-add ~/.ssh/id_ed25519
• Windows: Ensure OpenSSH is enabled: Get-WindowsCapability -Online | Where-Object Name -like 'OpenSSH*'
• Test: ssh -T git@github.com

Java not working?

• Check JAVA_HOME: echo $JAVA_HOME (macOS/Linux) or $env:JAVA_HOME (Windows)
• Reinstall: Follow aws.amazon.com/corretto for recommended Java installation
• Environment: Run the Java environment commands from Step 3

Chocolatey/PowerShell issues?

• PowerShell 7: Install from Microsoft PowerShell Docs
• Run as Administrator: Required for most Chocolatey operations
• Execution Policy: Run Set-ExecutionPolicy RemoteSigned -Scope CurrentUser
• Chocolatey troubleshooting: See chocolatey.org/docs/troubleshooting

---

Next Steps

For Detailed Setup

• Complete Setup Guide - Step-by-step detailed instructions
• Language-Specific Guides - JavaScript, Python, Java, Rust

For Company Development

• Company Onboarding - Required for company employees
• Core Tools Guide - Detailed tool documentation

For Specific Workflows

• Frontend Development - React, Vue, Angular
• Backend Development - APIs, microservices
• DevOps & Infrastructure - CI/CD, monitoring

---

Congratulations! Your development environment is ready for any project.