Skip to main content

​
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

​
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 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:
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!

Build docs developers (and LLMs) love

Get started for freeTalk to us