Cross-Platform UI Monorepo Template

Environment Set Up 🫨

Install Homebrew

/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

Please go through the following installations if you don't have one or more of the below in your local environment.

Install Gitleaks

brew install gitleaks

Install Fast Node Manager (fnm)

brew install fnm

Please follow the shell set up instructions here

Install Node

fnm install
fnm use

Install PNPM

corepack enable pnpm

Install Mobile Dependencies

iOS

Install XCode from the App Store

Android

Android Studio

brew install --cask android-studio

Java

brew install java

#For the system Java wrappers to find this JDK, symlink it with
sudo ln -sfn /opt/homebrew/opt/openjdk/libexec/openjdk.jdk /Library/Java/JavaVirtualMachines/openjdk.jdk

Create A Virtual Device

Follow the instructions here to create an virtual device

Clone Repository

# pull project to local file system
git clone https://github.com/iknowhtml/cross-platform-app-monorepo-template.git

# changes current directory to the root of the u1 directory
cd cross-platform-app-monorepo-template

Install Packages

# installs packages
pnpm i

Running Applications

Web

cd apps/web
# starts the web application on http://localhost:3000
pnpm dev

Native

cd apps/native

# set up android -- this only needs to be ran once
# note you must have your android emulator running before running the command before
pnpm setup:android

# set up/run ios dev environent
pnpm setup:ios

# starts native app development server
pnpm dev