vibefast-cli 0.2.4 → 0.3.0

package/recipes/README.md

@@ -0,0 +1,156 @@
+# VibeFast Service Configuration Recipes
+
+This directory contains configuration guides for third-party services that are **already integrated** in VibeFast. These services just need your API keys and credentials to work.
+
+## What are Recipes?
+
+Recipes are JSON files that provide:
+- **Configuration steps** - How to get API keys and set them up
+- **Environment variables** - Which .env vars you need
+- **File locations** - Where to add your credentials in the codebase
+- **Documentation links** - Official service documentation
+
+## Available Recipes
+
+### Analytics & Monitoring
+- **sentry.json** - Error tracking (already integrated, just add DSN)
+- **posthog.json** - Product analytics (already integrated, just add API key)
+
+### Payments & Subscriptions
+- **revenuecat.json** - In-app purchases (already integrated, just add API keys)
+
+## Recipe Structure
+
+```json
+{
+  "name": "service-name",
+  "version": "1.0.0",
+  "description": "Service description",
+  "target": "service",
+  "manualSteps": [
+    {
+      "title": "Step Title",
+      "description": "Step description",
+      "link": "https://docs.example.com",
+      "file": ".env.local",
+      "content": "ENV_VAR=value"
+    }
+  ],
+  "env": [
+    {
+      "key": "ENV_VAR_NAME",
+      "description": "Variable description",
+      "example": "example-value",
+      "required": true,
+      "link": "https://docs.example.com"
+    }
+  ],
+  "postInstall": {
+    "message": "Success message"
+  }
+}
+```
+
+## Fields
+
+### Root Level
+- `name` - Service identifier (lowercase, no spaces)
+- `version` - Recipe version (semver)
+- `description` - Short description of the service
+- `target` - Type of recipe (usually "service")
+- `manualSteps` - Array of setup steps
+- `env` - Array of environment variables
+- `postInstall` - Post-installation message
+
+### Manual Steps
+- `title` - Step title
+- `description` - Step description
+- `link` - (Optional) Documentation link
+- `file` - (Optional) File to edit
+- `content` - (Optional) Content to add
+
+### Environment Variables
+- `key` - Variable name
+- `description` - What the variable is for
+- `example` - Example value
+- `required` - Whether it's required
+- `link` - (Optional) Where to get the value
+
+## How to Use
+
+### View Setup Steps
+```bash
+vf checklist sentry
+vf checklist posthog
+vf checklist stripe
+```
+
+### List All Services
+```bash
+vf list
+```
+
+## Adding New Recipes
+
+1. Create a new JSON file in this directory
+2. Follow the recipe structure above
+3. Include clear setup steps and documentation links
+4. Test with `vf checklist <service-name>`
+
+## Recipe Guidelines
+
+### Setup Steps
+- Keep steps clear and actionable
+- Include links to official documentation
+- Specify which files need to be edited
+- Provide example values
+
+### Environment Variables
+- Use clear, descriptive names
+- Include example values
+- Mark required vs optional
+- Provide links to where users can get values
+- Never include actual secrets in examples
+
+### Documentation
+- Link to official service documentation
+- Link to relevant setup guides
+- Include links to dashboards/settings pages
+
+## Integration with CLI
+
+Recipes are automatically discovered by the CLI through the VibeFast API. When users run:
+
+```bash
+vf list              # Shows all available services
+vf checklist <name>  # Shows setup steps for a service
+vf env               # Prompts for environment variables
+```
+
+The CLI fetches recipe data from the API and displays it to users.
+
+## Testing Recipes
+
+To test a recipe locally:
+
+1. Ensure the recipe JSON is valid
+2. Run `vf checklist <service-name>`
+3. Verify all steps display correctly
+4. Check that environment variables are listed
+5. Verify documentation links work
+
+## Best Practices
+
+1. **Be Specific** - Clear, actionable steps
+2. **Provide Examples** - Show what values should look like
+3. **Link to Docs** - Always provide official documentation
+4. **Test Thoroughly** - Verify all links work
+5. **Keep Updated** - Update recipes when services change
+6. **Security** - Never include real secrets or API keys
+
+## Support
+
+For issues or questions about recipes:
+- 📧 Email: support@vibefast.pro
+- 📚 Docs: https://vibefast.pro/docs
+- 🐛 Issues: https://github.com/vibefast/vibefast-cli/issues

package/recipes/image-analysis/recipe.json

@@ -0,0 +1,61 @@
+{
+  "name": "image-analysis",
+  "version": "1.0.0",
+  "description": "AI-powered image analysis with trait detection",
+  "copy": [
+    {
+      "from": "apps/native/src/app/image-analysis",
+      "to": "apps/native/src/app/(root)/(protected)/image-analysis"
+    },
+    {
+      "from": "apps/native/src/features/image-analysis",
+      "to": "apps/native/src/features/image-analysis"
+    },
+    {
+      "from": "apps/native/src/api-client/image-analysis.ts",
+      "to": "apps/native/src/api-client/image-analysis.ts"
+    },
+    {
+      "from": "packages/backend/convex/image-analysis",
+      "to": "packages/backend/convex/image-analysis"
+    },
+    {
+      "from": "packages/backend/convex/imageAnalysisFunctions.ts",
+      "to": "packages/backend/convex/imageAnalysisFunctions.ts"
+    }
+  ],
+  "nav": {
+    "href": "/(root)/(protected)/image-analysis",
+    "label": "Image Analysis",
+    "icon": "🔍",
+    "color": "#06B6D4"
+  },
+  "target": "native",
+  "env": [
+    {
+      "key": "OPENAI_API_KEY",
+      "description": "OpenAI API key for image analysis (optional - use this OR Gemini, not both).",
+      "example": "sk-abc123def456",
+      "link": "https://platform.openai.com/account/api-keys"
+    },
+    {
+      "key": "GEMINI_API_KEY",
+      "description": "Google Generative AI key for image analysis (optional - use this OR OpenAI, not both).",
+      "example": "AIzaSyExampleGeminiKey",
+      "link": "https://console.cloud.google.com/apis/credentials"
+    }
+  ],
+  "manualSteps": [
+    {
+      "title": "Get ONE LLM API key (choose your provider)",
+      "description": "You only need ONE of these:\n\n  Option A: OpenAI\n    Visit https://platform.openai.com/account/api-keys and create an API key\n\n  Option B: Google Gemini\n    Visit https://console.cloud.google.com/apis/credentials and create an API key",
+      "link": "https://platform.openai.com/account/api-keys"
+    },
+    {
+      "title": "Add key to .env file",
+      "description": "Open your .env file and add the API key you chose. Only add ONE:\n\n  For OpenAI: OPENAI_API_KEY=sk-...\n  For Gemini: GEMINI_API_KEY=AIzaSy...",
+      "file": ".env",
+      "content": "# Choose ONE provider:\nOPENAI_API_KEY=sk-...\n# OR\nGEMINI_API_KEY=AIzaSy...\n"
+    }
+  ]
+}

package/recipes/image-generator/recipe.json

@@ -30,33 +30,28 @@
   "env": [
     {
       "key": "OPENAI_API_KEY",
-      "description": "OpenAI key to call DALL·E or other text-to-image models.",
+      "description": "OpenAI key for DALL-E image generation (optional - use this OR Gemini, not both).",
       "example": "sk-abc123def456",
       "link": "https://platform.openai.com/account/api-keys"
     },
     {
       "key": "GEMINI_API_KEY",
-      "description": "Google Generative AI key used to access Gemini image models.",
+      "description": "Google Generative AI key for Gemini image generation (optional - use this OR OpenAI, not both).",
       "example": "AIzaSyExampleGeminiKey",
       "link": "https://console.cloud.google.com/apis/credentials"
     }
   ],
   "manualSteps": [
     {
-      "title": "Create an OpenAI API key",
-      "description": "Sign into the OpenAI dashboard and create a server API key for image generation.",
+      "title": "Get ONE LLM API key (choose your provider)",
+      "description": "You only need ONE of these:\n\n  Option A: OpenAI (DALL-E)\n    Visit https://platform.openai.com/account/api-keys and create an API key\n\n  Option B: Google Gemini\n    Visit https://console.cloud.google.com/apis/credentials and create an API key",
       "link": "https://platform.openai.com/account/api-keys"
     },
     {
-      "title": "Create a Gemini API key",
-      "description": "Enable Generative AI APIs in Google Cloud and copy a key for Gemini image models.",
-      "link": "https://console.cloud.google.com/apis/credentials"
-    },
-    {
-      "title": "Store the keys in .env",
-      "description": "Add whichever providers you plan to use to your environment so Convex can authenticate.",
+      "title": "Add key to .env file",
+      "description": "Open your .env file and add the API key you chose. Only add ONE:\n\n  For OpenAI: OPENAI_API_KEY=sk-...\n  For Gemini: GEMINI_API_KEY=AIzaSy...",
       "file": ".env",
-      "content": "OPENAI_API_KEY=sk-...\nGEMINI_API_KEY=AIzaSy...\n"
+      "content": "# Choose ONE provider:\nOPENAI_API_KEY=sk-...\n# OR\nGEMINI_API_KEY=AIzaSy...\n"
     }
   ]
 }

package/recipes/posthog.json

@@ -0,0 +1,46 @@
+{
+  "name": "posthog",
+  "version": "1.0.0",
+  "description": "Product analytics and feature flags (already integrated in VibeFast)",
+  "target": "service",
+  "manualSteps": [
+    {
+      "title": "Create PostHog Project",
+      "description": "Sign up at posthog.com and create a new project",
+      "link": "https://posthog.com/signup"
+    },
+    {
+      "title": "Get Your API Key",
+      "description": "Copy your project API key from PostHog settings",
+      "link": "https://app.posthog.com/project/settings"
+    },
+    {
+      "title": "Add API Key to Environment Files",
+      "description": "Add POSTHOG_API_KEY to all your .env files",
+      "file": "apps/native/.env.local",
+      "content": "POSTHOG_API_KEY=phc_your_api_key_here"
+    },
+    {
+      "title": "Restart Development Server",
+      "description": "Restart your Expo dev server to load the new environment variable",
+      "content": "pnpm dev:native"
+    },
+    {
+      "title": "Verify Analytics",
+      "description": "PostHog is already integrated via core/analytics. Check your PostHog dashboard for events",
+      "link": "https://app.posthog.com/events"
+    }
+  ],
+  "env": [
+    {
+      "key": "POSTHOG_API_KEY",
+      "description": "PostHog project API key - get from your PostHog project settings",
+      "example": "phc_abc123def456ghi789",
+      "required": true,
+      "link": "https://app.posthog.com/project/settings"
+    }
+  ],
+  "postInstall": {
+    "message": "✅ PostHog is already integrated! Just add your API key to .env files"
+  }
+}

package/recipes/revenuecat.json

@@ -0,0 +1,43 @@
+{
+  "name": "revenuecat",
+  "version": "1.0.0",
+  "description": "In-app purchases and subscriptions (already integrated in VibeFast)",
+  "target": "service",
+  "manualSteps": [
+    {
+      "title": "Create RevenueCat Project",
+      "description": "Sign up at revenuecat.com and create a new project",
+      "link": "https://app.revenuecat.com/signup"
+    },
+    {
+      "title": "Configure App Stores",
+      "description": "Link your iOS (App Store Connect) and Android (Google Play) apps to RevenueCat",
+      "link": "https://www.revenuecat.com/docs/getting-started"
+    },
+    {
+      "title": "Get API Keys",
+      "description": "Copy your public API keys (iOS and Android) from RevenueCat settings",
+      "link": "https://app.revenuecat.com/settings/api-keys"
+    },
+    {
+      "title": "Update Payment Service",
+      "description": "Replace mock API keys in payment-service.ts with your real keys",
+      "file": "apps/native/src/features/payments/services/payment-service.ts",
+      "content": "// Find and replace:\nconst REVENUECAT_API_KEY_IOS = 'your_actual_ios_key';\nconst REVENUECAT_API_KEY_ANDROID = 'your_actual_android_key';"
+    },
+    {
+      "title": "Create Products & Entitlements",
+      "description": "Set up your subscription products and entitlements in RevenueCat dashboard",
+      "link": "https://www.revenuecat.com/docs/entitlements"
+    },
+    {
+      "title": "Test Purchases",
+      "description": "Use sandbox accounts to test purchases. RevenueCat integration is already complete in VibeFast",
+      "link": "https://www.revenuecat.com/docs/test-and-launch"
+    }
+  ],
+  "env": [],
+  "postInstall": {
+    "message": "✅ RevenueCat is already integrated! Just update API keys in payment-service.ts"
+  }
+}

package/recipes/sentry.json

@@ -0,0 +1,46 @@
+{
+  "name": "sentry",
+  "version": "1.0.0",
+  "description": "Error tracking and performance monitoring (already integrated in VibeFast)",
+  "target": "service",
+  "manualSteps": [
+    {
+      "title": "Create Sentry Project",
+      "description": "Sign up at sentry.io and create a React Native project",
+      "link": "https://sentry.io/signup/"
+    },
+    {
+      "title": "Get Your DSN",
+      "description": "Copy your project's DSN from Sentry dashboard",
+      "link": "https://sentry.io/settings/projects/"
+    },
+    {
+      "title": "Add DSN to Environment Files",
+      "description": "Add SENTRY_DSN to all your .env files",
+      "file": "apps/native/.env.local",
+      "content": "SENTRY_DSN=https://your-key@o0.ingest.sentry.io/your-project-id"
+    },
+    {
+      "title": "Restart Development Server",
+      "description": "Restart your Expo dev server to load the new environment variable",
+      "content": "pnpm dev:native"
+    },
+    {
+      "title": "Test Error Tracking",
+      "description": "Sentry is already initialized in your app. Trigger a test error to verify it's working",
+      "link": "https://docs.sentry.io/platforms/react-native/usage/"
+    }
+  ],
+  "env": [
+    {
+      "key": "SENTRY_DSN",
+      "description": "Sentry Data Source Name - get from your Sentry project settings",
+      "example": "https://abc123@o0.ingest.sentry.io/123456",
+      "required": true,
+      "link": "https://sentry.io/settings/projects/"
+    }
+  ],
+  "postInstall": {
+    "message": "✅ Sentry is already integrated! Just add your DSN to .env files"
+  }
+}

package/recipes/voice-bot/recipe.json

@@ -49,21 +49,24 @@
   "manualSteps": [
     {
       "title": "Create an ElevenLabs Conversational AI agent",
-      "description": "Sign up at ElevenLabs, enable the Conversational AI tab, and provision an agent with speech capabilities."
+      "description": "Visit https://elevenlabs.io, sign up, go to the Conversational AI tab, and create a new agent with speech capabilities enabled.",
+      "link": "https://elevenlabs.io/"
     },
     {
-      "title": "Copy your agent ID and API key",
-      "description": "Copy the agent ID and the API key from the ElevenLabs dashboard so the backend token route can authenticate."
+      "title": "Get your ElevenLabs API key and Agent ID",
+      "description": "From the ElevenLabs dashboard, copy your API key (from Account settings) and your Agent ID (from the agent you just created).",
+      "link": "https://elevenlabs.io/account"
     },
     {
-      "title": "Store env variables",
-      "description": "Add the agent ID and API key to your `.env` file to unlock the voice route.",
+      "title": "Add keys to .env file",
+      "description": "Open your .env file and add the API key and Agent ID you just copied.",
       "file": ".env",
       "content": "ELEVENLABS_AGENT_ID=agent-...\nELEVENLABS_API_KEY=elevenlabs_...\n"
     },
     {
-      "title": "Install native dependencies and build a dev client",
-      "description": "Voice bot requires a dev client (WebRTC/native modules), so run `pnpx expo prebuild` and start a native build (`pnpm ios -d` or `pnpm android -d`)."
+      "title": "Build a dev client with native modules",
+      "description": "Voice bot requires native WebRTC modules. Run: pnpx expo prebuild && pnpm ios -d (or pnpm android -d for Android)",
+      "link": "https://docs.expo.dev/build/setup/"
     }
   ]
 }

package/recipes/wake-word/apps/native/assets/vosk-model/README.md

@@ -0,0 +1,103 @@
+# Vosk Model for Wake Word Detection
+
+This directory contains the Vosk speech recognition model for on-device wake word detection.
+
+## Required Model
+
+You need to download and place a Vosk model here.
+
+### Recommended Model
+
+**vosk-model-small-en-us-0.15** (~40 MB)
+
+- Optimized for mobile devices
+- Good accuracy for wake word detection
+- Low memory footprint
+
+## How to Download
+
+### Automated (Recommended)
+
+Run this command from the project root:
+
+```bash
+pnpm setup:vosk
+```
+
+This will automatically download, extract, and configure the model.
+
+### Manual Setup
+
+1. Go to [Vosk Models Page](https://alphacephei.com/vosk/models)
+2. Download `vosk-model-small-en-us-0.15.zip`
+3. Extract the ZIP file
+4. Rename the extracted folder to `model-en-us`
+5. Place the entire folder in this directory
+
+## Directory Structure
+
+After setup, you should have:
+
+```
+assets/vosk-model/
+└── vosk-model-small-en-us-0.15/
+    ├── am/
+    ├── conf/
+    ├── graph/
+    ├── ivector/
+    └── README
+```
+
+## Important Notes
+
+- **Do NOT commit the model** to git (it's in .gitignore)
+- Each developer needs to download their own model
+- The model is ~40 MB uncompressed
+- Model works offline (no internet required)
+- Model is free and open source
+
+## Alternative Models
+
+If you need a different language or size:
+
+- **Smaller** (~10 MB): `vosk-model-small-en-us-0.15` (less accurate)
+- **Larger** (~1.8 GB): `vosk-model-en-us-0.22` (more accurate, not recommended for mobile)
+- **Other languages**: See [Vosk Models](https://alphacephei.com/vosk/models)
+
+## Configuration
+
+The model path is configured in `app.config.ts`:
+
+```typescript
+[
+  'react-native-vosk',
+  {
+    models: ['assets/vosk-model'],
+    iOSMicrophonePermission:
+      'We use the mic for on-device wake-phrase detection.',
+  },
+];
+```
+
+## No API Key Required
+
+Unlike Picovoice, Vosk is completely free and open source. No API key or account needed!
+
+## Troubleshooting
+
+### Model not found error
+
+- Verify the model folder exists in `assets/vosk-model/`
+- Check the folder name matches what's in `app.config.ts`
+- Run `pnpm prebuild` after adding the model
+
+### Build size too large
+
+- Use the "small" model variant
+- Ensure you're not including multiple models
+
+### Recognition not working
+
+- Verify model is for English (if using English wake words)
+- Check microphone permissions are granted
+- Test with clear speech at normal volume