Installation

Set up your development environment and install Simple Manager Mobile

Installation Guide

This guide will walk you through setting up Simple Manager Mobile on your local development environment.

Prerequisites

Before you begin, ensure you have the following installed on your system:

Required Software

1. Node.js

   Install Node.js 18 or higher. We recommend using the LTS version.

   Check your Node.js version:

   node --version
   

   Download from nodejs.org if needed.

2. Package Manager

   Simple Manager supports npm, yarn, or pnpm. Choose your preferred package manager.

   npm comes with Node.js. For alternatives:

   • Yarn: npm install -g yarn
   • pnpm: npm install -g pnpm
3. Expo CLI

   Install Expo CLI globally (optional but recommended):

   npm install -g expo-cli
   

   Expo CLI is optional as Expo SDK 54+ includes npx expo commands, but global installation provides a better development experience.

Platform-Specific Requirements

You only need to set up the platforms you plan to develop for. Start with one platform and add others later.

iOS Development (macOS only)

• macOS Monterey or later
• Xcode 14 or later (download from Mac App Store)
• iOS Simulator (included with Xcode)
• CocoaPods: sudo gem install cocoapods

Android Development

• Android Studio (includes Android SDK and emulator)
• Java Development Kit (JDK) 11 or later
• Configure ANDROID_HOME environment variable
• Create an Android Virtual Device (AVD) in Android Studio

Physical Device

• Install Expo Go app from:
  • App Store (iOS)
  • Google Play (Android)

Installation Steps

1. Clone the Repository

   Clone the Simple Manager repository to your local machine:

   git clone https://github.com/marcosfabricio3/simple-manager-mobile.git
   cd simple-manager-mobile
   
2. Install Dependencies

   Install all required dependencies using your preferred package manager:

   npm

   npm install
   

   This will install all dependencies including:

   • Expo SDK (~54.0)
   • React Native (0.81.5)
   • expo-sqlite for database
   • expo-router for navigation
   • All other required packages
3. Verify Installation

   Verify that the installation was successful by checking the project structure:

   ls -la
   

   You should see directories like:

   • app/ - Expo Router pages
   • src/ - Application source code
   • components/ - Reusable components
   • assets/ - Images and static files

iOS Setup (macOS only)

1. Install CocoaPods Dependencies

   Navigate to the iOS directory and install pods:

   cd ios
   pod install
   cd ..
   

   If you encounter issues, try pod install --repo-update to update the CocoaPods repository.

2. Open iOS Simulator

   You can open the iOS Simulator before running the app:

   open -a Simulator
   

Android Setup

1. Configure Android SDK

   Ensure your ANDROID_HOME environment variable is set:

   macOS/Linux

   export ANDROID_HOME=$HOME/Library/Android/sdk
   export PATH=$PATH:$ANDROID_HOME/emulator
   export PATH=$PATH:$ANDROID_HOME/platform-tools
   

   Add these to your shell profile (~/.bashrc, ~/.zshrc, etc.) to make them permanent.

2. Create Android Virtual Device

   Open Android Studio, go to Device Manager, and create a new AVD if you don’t have one:

   1. Open Android Studio
   2. Click More Actions > Virtual Device Manager
   3. Click Create Device
   4. Select a device (e.g., Pixel 5)
   5. Download and select a system image (API 33 or higher recommended)
   6. Finish the setup

Troubleshooting

If you encounter issues during installation, try these common solutions:

Clear Cache and Reinstall

rm -rf node_modules package-lock.json
npm install

Expo Cache Issues

npx expo start -c

The -c flag clears the Metro bundler cache.

iOS Pod Installation Issues

cd ios
pod deintegrate
pod install
cd ..

Port Already in Use

If port 8081 is already in use:

npx expo start --port 8082

Next Steps

Quick Start Guide

Now that installation is complete, follow the Quick Start guide to run your app and create your first record!