feat: New Session Page w/ one touch Profiles, adds z.ai / deepseek / microsoft AI Backend Support

.gitignore

@@ -44,4 +44,7 @@ yarn-error.*
 
 CLAUDE.local.md
 
-.dev/worktree/*
+.dev/worktree/*
+
+# Development planning notes (keep local, don't commit)
+notes/

CLAUDE.md

@@ -7,11 +7,17 @@ This file provides guidance to Claude Code (claude.ai/code) when working with co
 ### Development
 - `yarn start` - Start the Expo development server
 - `yarn ios` - Run the app on iOS simulator
-- `yarn android` - Run the app on Android emulator  
+- `yarn android` - Run the app on Android emulator
 - `yarn web` - Run the app in web browser
 - `yarn prebuild` - Generate native iOS and Android directories
 - `yarn typecheck` - Run TypeScript type checking after all changes
 
+### macOS Desktop (Tauri)
+- `yarn tauri:dev` - Run macOS desktop app with hot reload
+- `yarn tauri:build:dev` - Build development variant
+- `yarn tauri:build:preview` - Build preview variant
+- `yarn tauri:build:production` - Build production variant
+
 ### Testing
 - `yarn test` - Run tests in watch mode (Jest with jest-expo preset)
 - No existing tests in the codebase yet

CONTRIBUTING.md

@@ -0,0 +1,308 @@
+# Contributing to Happy
+
+## Development Workflow: Build Variants
+
+The Happy app supports three build variants across **iOS, Android, and macOS desktop**, each with separate bundle IDs so all three can be installed simultaneously:
+
+| Variant | Bundle ID | App Name | Use Case |
+|---------|-----------|----------|----------|
+| **Development** | `com.slopus.happy.dev` | Happy (dev) | Local development with hot reload |
+| **Preview** | `com.slopus.happy.preview` | Happy (preview) | Beta testing & OTA updates before production |
+| **Production** | `com.ex3ndr.happy` | Happy | Public App Store release |
+
+**Why Preview?**
+- **Development**: Fast iteration, dev server, instant reload
+- **Preview**: Beta testers get OTA updates (`eas update --branch preview`) without app store submission
+- **Production**: Stable App Store builds
+
+This allows you to test production-like builds with real users before releasing to the App Store.
+
+## Quick Start
+
+### iOS Development
+
+```bash
+# Development variant (default)
+npm run ios:dev
+
+# Preview variant
+npm run ios:preview
+
+# Production variant
+npm run ios:production
+```
+
+### Android Development
+
+```bash
+# Development variant
+npm run android:dev
+
+# Preview variant
+npm run android:preview
+
+# Production variant
+npm run android:production
+```
+
+### macOS Desktop (Tauri)
+
+```bash
+# Development variant - run with hot reload
+npm run tauri:dev
+
+# Build development variant
+npm run tauri:build:dev
+
+# Build preview variant
+npm run tauri:build:preview
+
+# Build production variant
+npm run tauri:build:production
+```
+
+**How Tauri Variants Work:**
+- Base config: `src-tauri/tauri.conf.json` (production defaults)
+- Partial configs: `tauri.dev.conf.json`, `tauri.preview.conf.json`
+- Tauri merges partial configs using [JSON Merge Patch (RFC 7396)](https://datatracker.ietf.org/doc/html/rfc7396)
+- Only differences need to be specified in partial configs (DRY principle)
+
+### Development Server
+
+```bash
+# Start dev server for development variant
+npm run start:dev
+
+# Start dev server for preview variant
+npm run start:preview
+
+# Start dev server for production variant
+npm run start:production
+```
+
+## Visual Differences
+
+Each variant displays a different app name on your device:
+- **Development**: "Happy (dev)" - Yellow/orange theme
+- **Preview**: "Happy (preview)" - Preview theme
+- **Production**: "Happy" - Standard theme
+
+This makes it easy to distinguish which version you're testing!
+
+## Common Workflows
+
+### Testing Development Changes
+
+1. **Build development variant:**
+   ```bash
+   npm run ios:dev
+   ```
+
+2. **Make your changes** to the code
+
+3. **Hot reload** automatically updates the app
+
+4. **Rebuild if needed** for native changes:
+   ```bash
+   npm run ios:dev
+   ```
+
+### Testing Preview (Pre-Release)
+
+1. **Build preview variant:**
+   ```bash
+   npm run ios:preview
+   ```
+
+2. **Test OTA updates:**
+   ```bash
+   npm run ota  # Publishes to preview branch
+   ```
+
+3. **Verify** the preview build works as expected
+
+### Production Release
+
+1. **Build production variant:**
+   ```bash
+   npm run ios:production
+   ```
+
+2. **Submit to App Store:**
+   ```bash
+   npm run submit
+   ```
+
+3. **Deploy OTA updates:**
+   ```bash
+   npm run ota:production
+   ```
+
+## All Variants Simultaneously
+
+You can install all three variants on the same device:
+
+```bash
+# Build all three variants
+npm run ios:dev
+npm run ios:preview
+npm run ios:production
+```
+
+All three apps appear on your device with different icons and names!
+
+## EAS Build Profiles
+
+The project includes EAS build profiles for automated builds:
+
+```bash
+# Development build
+eas build --profile development
+
+# Production build
+eas build --profile production
+```
+
+## Environment Variables
+
+Each variant can use different environment variables via `APP_ENV`:
+
+```javascript
+// In app.config.js
+const variant = process.env.APP_ENV || 'development';
+```
+
+This controls:
+- Bundle identifier
+- App name
+- Associated domains (deep linking)
+- Intent filters (Android)
+- Other variant-specific configuration
+
+## Deep Linking
+
+Only **production** variant has deep linking configured:
+
+- **Production**: `https://app.happy.engineering/*`
+- **Development**: No deep linking
+- **Preview**: No deep linking
+
+This prevents dev/preview builds from interfering with production deep links.
+
+## Testing Connected to Different Servers
+
+You can connect different variants to different Happy CLI instances:
+
+```bash
+# Development app → Dev CLI daemon
+npm run android:dev
+# Connect to CLI running: npm run dev:daemon:start
+
+# Production app → Stable CLI daemon
+npm run android:production
+# Connect to CLI running: npm run stable:daemon:start
+```
+
+Each app maintains separate authentication and sessions!
+
+## Local Server Development
+
+To test with a local Happy server:
+
+```bash
+npm run start:local-server
+```
+
+This sets:
+- `EXPO_PUBLIC_HAPPY_SERVER_URL=http://localhost:3005`
+- `EXPO_PUBLIC_DEBUG=1`
+- Debug logging enabled
+
+## Troubleshooting
+
+### Build fails with "Bundle identifier already in use"
+
+This shouldn't happen - each variant has a unique bundle ID. If it does:
+
+1. Check `app.config.js` - verify `bundleId` is set correctly for the variant
+2. Clean build:
+   ```bash
+   npm run prebuild
+   npm run ios:dev  # or whichever variant
+   ```
+
+### App not updating after changes
+
+1. **For JS changes**: Hot reload should work automatically
+2. **For native changes**: Rebuild the variant:
+   ```bash
+   npm run ios:dev  # Force rebuild
+   ```
+3. **For config changes**: Clean and prebuild:
+   ```bash
+   npm run prebuild
+   npm run ios:dev
+   ```
+
+### All three apps look the same
+
+Check the app name on the home screen:
+- "Happy (dev)"
+- "Happy (preview)"
+- "Happy"
+
+If they're all the same name, the variant might not be set correctly. Verify:
+
+```bash
+# Check what APP_ENV is set to
+echo $APP_ENV
+
+# Or look at the build output
+npm run ios:dev  # Should show "Happy (dev)" as the name
+```
+
+### Connected device not found
+
+For iOS connected device testing:
+
+```bash
+# List available devices
+xcrun devicectl list devices
+
+# Run on specific connected device
+npm run ios:connected-device
+```
+
+## Tips
+
+1. **Use development variant for active work** - Fast iteration, debug features enabled
+2. **Use preview for pre-release testing** - Test OTA updates before production
+3. **Use production for final validation** - Exact configuration that ships to users
+4. **Install all three simultaneously** - Compare behaviors side-by-side
+5. **Different CLI instances** - Connect dev app to dev CLI, prod app to stable CLI
+6. **Check app name** - Always visible which variant you're testing
+
+## How It Works
+
+The `app.config.js` file reads the `APP_ENV` environment variable:
+
+```javascript
+const variant = process.env.APP_ENV || 'development';
+const bundleId = {
+  development: "com.slopus.happy.dev",
+  preview: "com.slopus.happy.preview",
+  production: "com.ex3ndr.happy"
+}[variant];
+```
+
+The `cross-env` package ensures this works cross-platform:
+
+```json
+{
+  "scripts": {
+    "ios:dev": "cross-env APP_ENV=development expo run:ios"
+  }
+}
+```
+
+Cross-platform via `cross-env` - works identically on Windows, macOS, and Linux!

README.md

@@ -76,6 +76,7 @@ We're engineers scattered across Bay Area coffee shops and hacker houses, consta
 ## 📚 Documentation & Contributing
 
 - **[Documentation Website](https://happy.engineering/docs/)** - Learn how to use Happy Coder effectively
+- **[CONTRIBUTING.md](CONTRIBUTING.md)** - Development setup including iOS, Android, and macOS desktop variant builds
 - **[Edit docs at github.com/slopus/slopus.github.io](https://github.com/slopus/slopus.github.io)** - Help improve our documentation and guides
 
 ## License

babel.config.js

@@ -1,5 +1,23 @@
 module.exports = function (api) {
   api.cache(true);
+
+  // Determine which worklets plugin to use based on installed versions
+  // Reanimated v4+ uses react-native-worklets/plugin
+  // Reanimated v3.x uses react-native-reanimated/plugin
+  let workletsPlugin = 'react-native-worklets/plugin';
+  try {
+    const reanimatedVersion = require('react-native-reanimated/package.json').version;
+    const majorVersion = parseInt(reanimatedVersion.split('.')[0], 10);
+
+    // For Reanimated v3.x, use the old plugin
+    if (majorVersion < 4) {
+      workletsPlugin = 'react-native-reanimated/plugin';
+    }
+  } catch (e) {
+    // If reanimated isn't installed, default to newer plugin
+    // This won't cause issues since the plugin won't be needed anyway
+  }
+
   return {
     presets: ['babel-preset-expo'],
     env: {
@@ -8,8 +26,8 @@ module.exports = function (api) {
       },
     },
     plugins: [
-      'react-native-worklets/plugin',
-      ['react-native-unistyles/plugin', { root: 'sources' }]
+      ['react-native-unistyles/plugin', { root: 'sources' }],
+      workletsPlugin // Must be last - automatically selects correct plugin for version
     ],
   };
 };