Billion

Welcome to the codebase. See below for development set-up instructions. See Manifesto for what Billion even is.

Quick Start

These instructions were originally copy-pasted from https://github.com/t3-oss/create-t3-turbo (which this project is scaffolded from). I've modified it to get rid of the bs that we don't use. For example, I've commented out all of the original auth instructions cuz we're not using that for now.

Anything in blockquotes without admonitions (like this one you're reading) is additional commentary I added

If already set up

pnpm run dev

And go to the @acme/ios tab in that TUI and follow Expo's instructions (press i, typically)

Otherwise...

Make sure you have:

• pnpm
• Xcode CLI stuff whatever (run xcode-select --install)
• Xcode installed with the iOS simulator installed (go to App Store)
• Postgres installed globally (unless you want to figure out how to run this project in a Docker container?). It's easy with https://postgresapp.com/ on macOS

(instructions copied from https://github.com/t3-oss/create-t3-turbo)

To get it running, follow the steps below:

1. Setup dependencies

git clone https://github.com/ThatXliner/billion.git
cd billion
# Install dependencies
pnpm i

# Configure environment variables
# There is an `.env.example` in the root directory you can use for reference
cp .env.example .env

# Push the Drizzle schema to the database
pnpm db:push

2. Configure Expo dev-script

Idk why these instructions tell you to change the dev script (in apps/expo) but if that's what helps, sure. Remember to change it back to "dev": "expo start",

Use iOS Simulator

1. Make sure you have XCode and XCommand Line Tools installed as shown on expo docs.

Note

If you just installed XCode, or if you have updated it, you need to open the simulator manually once. Run npx expo start from apps/expo, and then enter I to launch Expo Go. After the manual launch, you can run pnpm dev in the root directory.

+  "dev": "expo start --ios",

2. Run pnpm dev at the project root folder.

Use Android Emulator

(who is doing this anyway...)

1. Install Android Studio tools as shown on expo docs.

2. Change the dev script at apps/expo/package.json to open the Android emulator.

   +  "dev": "expo start --android",

3. Run pnpm dev at the project root folder.

Congratulations

Congrats it's set up. See CONTRIBUTING if you need to add a new UI component or a new package in the packages/ folder.

---

Now, everything below is NOT copy+pasted from the original template README. Good job reading this far. Send me a text if you did.

Troubleshooting

• If there's any issues with dependencies, just add to the project root.

# .npmrc
node-linker=hoisted

• Make sure Next.js is running. Maybe cp .env.example .env and update the values (if needed)?

"CommandError: No development build (dev.thatxliner.billion) for this project is installed. Please make and install a development build on the device first. Learn more: https://docs.expo.dev/development/build/"

In this case, pnpm clean && pnpm install && cd apps/expo && pnpm ios before you go back to root and run pnpm dev. Maybe open the Xcode project and build from there?

FAQ & Deployment

Just see the original here (permalink here).