vibeclinic-reports

Deploying your app to the App Store

Video how-to

Dev environment setup

Project setup

  1. Download your code from Bolt. You can do this with their built-in download, or (recommended) clone it from GitHub like this:
git clone https://github.com/ScaleYourGenius/he-app.git
  1. Add your environment variables in a new file called .env at the root of your project folder. It should look like this:
VITE_SUPABASE_URL=your-url
VITE_SUPABASE_ANON_KEY=your-key
  1. If needed, install brew, and then node:
  2. Build your app to make sure it runs:
npm install
npm run build
  1. Run your app locally to make sure it works: 
    npm run dev

iOS development setup

  1. Download Xcode from the Apple App Store

  2. Install the Xcode command line tools: 
    xcode-select --install
  3. Install CocoaPods (make sure you installed brew in the earlier steps): 
    brew install cocoapods

Capacitor configuration

  1. Install capacitor with these three commands: 
    npm i @capacitor/core
npm i -D @capacitor/cli
npm install @capacitor/ios
  2. Initialize Capacitor: 
    npx cap init
  3. Add iOS to your app: 
    npx cap add ios
  4. If needed, update the capacitor.config.ts file with your actual project information:
    • appId: something like com.your-organization.app-name
    • appName: the display name for your app

Testing & deploying your app

Simulator

# first, build your project
npm run build

# sync your project to capacitor
npx cap sync

# finally, open the simulator!
npx cap run ios

Test on a real device

  1. Open the project in Xcode with this command:
npx cap open ios

  1. In Xcode, go to Product > Destination and select your device (might need to plug it into your computer, and/or enable development mode on your device)

  2. Click the “play” button to build & send to your phone

Submit to App Store

  1. Open the project in Xcode with this command:
npx cap open ios

  1. In Xcode, select to Product > Archive

  2. You’ll be prompted with instructions for submitting to the App Store. At this step, you may also get some errors for configuration stuff (like signing in to yoru Apple developer account, making sure you have an app icon, etc)