README.md

📱 Vibetype iOS

The native iOS wrapper for Vibetype's Progressive Web App

---

📋 Table of Contents

• Overview
• Quick Start
• Full Setup

---

🎯 Overview

Vibetype iOS provides a native wrapper around Vibetype's Progressive Web App, running in a WKWebView. This approach gives you:

• ✅ Native feel with full-screen WebView experience
• 🔔 Push notifications via Firebase Cloud Messaging (APNs-backed)
• 📦 Zero setup – dependencies included via CocoaPods
• 🚀 Fast iteration – update web content without app store releases

🔗 Related Projects

• 🌐 Web App: maevsi/vibetype – Progressive Web App (PWA)
• 🤖 Android App: maevsi/android – Trusted Web Activity (TWA)

---

⚡ Quick Start

Already have Xcode? You can start immediately:

open vibetype.xcworkspace

That's it! All dependencies are pre-installed. Press Cmd+R to build and run.

ℹ️ Note: Always open vibetype.xcworkspace, never vibetype.xcodeproj

---

🔧 Full Setup

Prerequisites

• macOS with Xcode installed
• Apple Developer account for signing & push notifications (optional)
• Homebrew for managing Ruby (optional)

Installing Dependencies

Dependencies are already included, but if you need to update or modify them:

🍺 Step 1: Install Homebrew & Ruby

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

# Install Ruby via Homebrew
brew install ruby

Configure PATH (choose based on your Mac architecture):

Apple Silicon (M1/M2/M3)

echo 'export PATH="/opt/homebrew/opt/ruby/bin:$PATH"' >> ~/.zshrc
echo 'export LDFLAGS="-L/opt/homebrew/opt/ruby/lib"' >> ~/.zshrc
echo 'export CPPFLAGS="-I/opt/homebrew/opt/ruby/include"' >> ~/.zshrc
echo 'export PATH="$(ruby -e '\''print Gem.default_dir'\'')/bin:$PATH"' >> ~/.zshrc
exec zsh

Intel Mac

echo 'export PATH="/usr/local/opt/ruby/bin:$PATH"' >> ~/.zshrc
echo 'export LDFLAGS="-L/usr/local/opt/ruby/lib"' >> ~/.zshrc
echo 'export CPPFLAGS="-I/usr/local/opt/ruby/include"' >> ~/.zshrc
echo 'export PATH="$(ruby -e '\''print Gem.default_dir'\'')/bin:$PATH"' >> ~/.zshrc
exec zsh

Verify installation:

ruby -v
# Should show Ruby 3.x

💎 Step 2: Install CocoaPods

sudo gem install cocoapods

Verify:

pod --version

Common CocoaPods Commands:

# 📦 Install dependencies (after Podfile changes)
pod install

# ⬆️ Update pods to latest compatible versions
pod update

# 🔄 Refresh CocoaPods spec repository
pod install --repo-update

# 🧹 Remove CocoaPods integration completely
pod deintegrate

# 🗑️ Clear local cache (when troubleshooting)
pod cache clean --all