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)

bash
1# Clone the repository
2git clone <repository-url>
3cd {REPO_DIRECTORY}
4
5# Run automated setup (installs everything)
6./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)

bash
1# 1. Install Volta
2curl https://get.volta.sh | bash
3
4# 2. Restart terminal, then setup Node
5volta install node@20
6volta pin node@20
7
8# 3. Install dependencies
9pnpm install
10
11# 4. Setup development environment
12task setup-dev
13
14# 5. Verify setup
15task check-prereqs

Option 3: One-Command Full Setup (Fastest)

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

bash
1task 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

bash
1# Verify environment
2task check-prereqs
3
4# Start iOS development
5task run-ios
6
7# Start Android development
8task run-android
9
10# Run tests
11task test
12
13# Clean and regenerate
14task clean && task generate

Local Environment Setup

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

Key Environment Variables

bash
1# Check Node version (should be v20.x.x)
2node --version
3
4# Check Volta version
5volta --version
6
7# Check pnpm version
8pnpm --version

Troubleshooting

Related Skills

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

End of SOP