Development Environment Setup SOP

Note: This is a template. Replace placeholders like {PROJECT_NAME}, {REPO_DIRECTORY}, and {BUNDLE_ID} with your actual project values.

Version: 1.0.0 Last Updated: 2026-01-11 Status: Active

Overview

Purpose

This SOP guides developers through setting up the complete development environment for the mobile app. It ensures consistent environments across the team and enables productive development from day one.

When to Use

ALWAYS: New developer onboarding, setting up a new machine, clean reinstall, troubleshooting environment issues SKIP: Already have working environment, only need platform-specific setup (use setup-ios or setup-android)

Process Workflow

Flow Diagram

[Prerequisites] --> [Automated Setup] --> [Verification] --> [First Run]

Phase Summary

Quick Start

Option 1: Fully Automated Setup (5 minutes)

# Clone the repository
git clone <repository-url>
cd {REPO_DIRECTORY}

# Run automated setup (installs everything)
./scripts/setup-development.sh

The script handles:

• Volta installation
• Node.js 20 setup
• Project dependency installation
• Development environment configuration

Option 2: Manual Setup (10 minutes)

# 1. Install Volta
curl https://get.volta.sh | bash

# 2. Restart terminal, then setup Node
volta install node@20
volta pin node@20

# 3. Install dependencies
pnpm install

# 4. Setup development environment
task setup-dev

# 5. Verify setup
task check-prereqs

Option 3: One-Command Full Setup (Fastest)

If you already have the repository cloned and just need to complete setup:

task setup-full

This does everything in one command:

1. Install all dependencies (pnpm install)
2. Create local environment config (.env.local)
3. Pull development settings from EAS
4. Verify all patches applied correctly

Detailed Guide

For comprehensive setup instructions including prerequisites and troubleshooting, see:

• SETUP_GUIDE.md - Detailed setup steps

Quick Reference

Common Commands

# Verify environment
task check-prereqs

# Start iOS development
task run-ios

# Start Android development
task run-android

# Run tests
task test

# Clean and regenerate
task clean && task generate

Local Environment Setup

task setup-local-env    # Creates .env.local
task verify-patches     # Check patches are applied
task setup-full         # Complete setup in one command

Key Environment Variables

# Check Node version (should be v20.x.x)
node --version

# Check Volta version
volta --version

# Check pnpm version
pnpm --version

Troubleshooting

Related Skills

Note: Skill paths (/skill-name) work after deployment. In the template repo, skills are in domain folders.

End of SOP