Skip to main content

​
Installation Guide

This guide covers everything you need to set up a complete development environment for CryptoTracker, including platform-specific requirements for iOS and Android development.

​
Prerequisites

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

​
Required Software

CryptoTracker requires Node.js v18 or later.Check your current version:
node --version
Install or update Node.js:
# Install nvm
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.0/install.sh | bash

# Install Node.js
nvm install 18
nvm use 18
Git is required to clone the repository.Check if Git is installed:
git --version
Install Git:
  • macOS: brew install git (requires Homebrew)
  • Windows: Download from git-scm.com
  • Linux: sudo apt-get install git (Ubuntu/Debian) or sudo yum install git (CentOS/RHEL)
Choose one of the following package managers:npm (comes with Node.js)
npm --version
yarn (optional)
npm install -g yarn
pnpm (optional)
npm install -g pnpm

​
Basic Installation

1

Clone the Repository

Clone CryptoTracker from GitHub:
git clone https://github.com/sebas9526/CryptoTracker.git
cd CryptoTracker
2

Install Dependencies

Install all required npm packages:
npm install
This installs key dependencies including:
  • expo ~53.0.9 - Expo framework
  • react-native 0.79.2 - React Native core
  • expo-router ^5.0.6 - File-based routing
  • typescript ~5.8.3 - TypeScript support
  • And many more (see package.json for full list)
3

Verify Installation

Verify that everything installed correctly:
npx expo --version
You should see the Expo version number (53.0.x or similar).
The basic installation is sufficient for running the app on Expo Go or in a web browser. For native development, continue with the platform-specific setup below.

​
Platform-Specific Setup

​
iOS Development (macOS only)

1

Install Xcode

iOS development requires Xcode, which is only available on macOS.
  1. Download Xcode from the Mac App Store
  2. Install Command Line Tools:
xcode-select --install
  1. Accept the Xcode license:
sudo xcodebuild -license accept
2

Install CocoaPods

CocoaPods manages iOS dependencies:
sudo gem install cocoapods
Verify installation:
pod --version
3

Install iOS Simulator

iOS Simulator comes with Xcode. To verify it’s available:
# List available simulators
xcrun simctl list devices
4

Run on iOS

Start the app on iOS Simulator:
npm run ios

​
Android Development

1

Install Android Studio

Download and install Android Studio.During installation, make sure to install:
  • Android SDK
  • Android SDK Platform
  • Android Virtual Device (AVD)
2

Configure Environment Variables

Add Android SDK to your PATH:
# Add to ~/.bash_profile or ~/.zshrc
export ANDROID_HOME=$HOME/Library/Android/sdk
export PATH=$PATH:$ANDROID_HOME/emulator
export PATH=$PATH:$ANDROID_HOME/platform-tools
Verify installation:
adb --version
3

Create an Android Virtual Device

  1. Open Android Studio
  2. Go to Tools > AVD Manager
  3. Click Create Virtual Device
  4. Select a device (e.g., Pixel 5)
  5. Download a system image (e.g., API 33)
  6. Finish the setup
Or create via command line:
# List available system images
sdkmanager --list

# Create AVD
avdmanager create avd -n Pixel_5_API_33 -k "system-images;android-33;google_apis;x86_64"
4

Run on Android

Start the app on Android Emulator:
npm run android
Make sure an emulator is running or a physical device is connected via USB with USB debugging enabled.

​
Web Development

No additional setup required! Just run: 
npm run web
The app will open in your default browser at http://localhost:19006.
Some React Native features may not work on web. The app is primarily designed for mobile platforms.

​
Development Tools

For the best development experience, install these VS Code extensions:
  • ES7+ React/Redux/React-Native snippets - Code snippets
  • Prettier - Code formatter
  • ESLint - Code linting
  • React Native Tools - Debugging and IntelliSense
  • TypeScript - TypeScript support

​
Running Tests

CryptoTracker uses Jest for testing: 
npm test
Run tests in watch mode: 
npm test -- --watch
Example test from the codebase (__tests__/CryptoCard.test.tsx): 
import { render } from '@testing-library/react-native';
import CryptoCard from '../src/components/CryptoCard';

const mockCrypto = {
  id: '90',
  name: 'Bitcoin',
  symbol: 'BTC',
  rank: 1,
  price_usd: '50000.00',
  percent_change_24h: '2.5'
};

test('renders crypto card correctly', () => {
  const { getByText } = render(<CryptoCard crypto={mockCrypto} />);
  expect(getByText('Bitcoin')).toBeTruthy();
  expect(getByText('(BTC)')).toBeTruthy();
});

​
Project Configuration

​
TypeScript Configuration

The project uses TypeScript with strict mode enabled. See tsconfig.json: 
{
  "compilerOptions": {
    "strict": true,
    "esModuleInterop": true,
    "jsx": "react-native",
    "moduleResolution": "node"
  },
  "extends": "expo/tsconfig.base"
}

​
Expo Configuration

Key configurations in app.json: 
{
  "expo": {
    "name": "CryptoTracker",
    "slug": "CryptoTracker",
    "version": "1.0.0",
    "orientation": "portrait",
    "scheme": "cryptotracker",
    "newArchEnabled": true,
    "plugins": ["expo-router"],
    "experiments": {
      "typedRoutes": true
    }
  }
}
The app uses Expo’s new architecture (newArchEnabled: true) for improved performance.

​
Troubleshooting

Clear the Metro bundler cache:
npx expo start -c
Or manually clear caches:
rm -rf node_modules
rm -rf .expo
npm install
Clean iOS build:
cd ios
pod deintegrate
pod install
cd ..
npx expo run:ios
Check if virtualization is enabled in BIOS/UEFI:
# Check on Linux
egrep -c '(vmx|svm)' /proc/cpuinfo
# Result > 0 means virtualization is enabled
Try starting the emulator manually:
emulator -avd Pixel_5_API_33
Ensure TypeScript dependencies are installed:
npm install --save-dev typescript @types/react @types/react-native
Restart the TypeScript server in VS Code:
  • Press Cmd+Shift+P (Mac) or Ctrl+Shift+P (Windows/Linux)
  • Type “TypeScript: Restart TS Server”

​
Next Steps

Quick Start

Start building with CryptoTracker

Architecture

Learn about the app’s architecture

Components

Explore reusable components

API Reference

Understand the API integration

Build docs developers (and LLMs) love

Get started for freeTalk to us