Engineer Onboarding

Welcome to the Engineering team! This guide will help you set up your development environment once your laptop is ready.

Prerequisites

Ensure you have:

• Admin access on your laptop
• Your Selora Homes email configured
• Access to 1Password

macOS Setup

Homebrew

Install Homebrew, the package manager for macOS:

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

After installation, follow the instructions to add Homebrew to your PATH.

Development Tools

Claude Code

Claude Code is our primary AI-assisted development tool.

Install Claude Code:

Follow the installation instructions at Claude Code documentation .

Configure with your Selora Homes subscription:

Log in using your Selora Homes account credentials when prompted.

Add the Serena MCP server:

claude mcp add serena -- uvx --from git+https://github.com/oraios/serena serena start-mcp-server --context ide-assistant

For more information about Serena, see the Serena GitHub repository .

OpenAI Codex CLI

Configure Codex with your Selora Homes subscription and add the Serena MCP server.

Follow the setup instructions in the Serena Codex documentation .

Communication Tools

Zoom

Install Zoom for video meetings:

brew install --cask zoom

Database Tools

pgAdmin 4

Install pgAdmin 4 for PostgreSQL database management:

brew install --cask pgadmin4

Programming Languages

Go

Install the Go programming language:

brew install go

Verify the installation:

go version

Container Tools

Docker

Install Docker and related tools:

brew install docker
brew install docker-buildx
brew install docker-compose
brew install docker-credential-helper

Colima

Colima is a container runtime for macOS that works with Docker:

brew install colima

Start Colima:

colima start

Verification

After completing the setup, verify your environment:

# Check Homebrew
brew --version

# Check Go
go version

# Check Docker
docker --version
docker-compose --version

# Check Colima
colima status

Next Steps

Once your environment is set up:

1. Clone the repositories you’ll be working on
2. Review the Release Process
3. Review the Sprint Planning process
4. Introduce yourself in #engineering