This is robotube, a video streaming app built with Mux, Convex, Expo and React Native.

This applicaiton uses Mux Robots, the latest video intelligence API by Mux.

Heres the breakdown of the stack:

Mux:

• Video storage, streaming and delivery

• Mux Robots gives this app the ability to:

  • Generate summary and tags
  • Moderate a videos
  • Generate a video's chapters
  • Generate a video's key moments
  • Translate captions
  • Ask questions about a video

Expo:

• Expo video player
• Expo Native Tabs

Convex: Convex is our database of choice with a bunch of added feqtures below

• Mux Convex Component
• Convex Auth
• Convex Agent
• Vector Search

This is an Expo project created with create-expo-app.

Get started

This project uses Expo SDK 55 and React 19.2, so the <Activity> component is available.

1. Install dependencies:

   npm install

2. Create .env.local in the project root:

   EXPO_PUBLIC_CONVEX_URL=https://<your-deployment>.convex.cloud
   EXPO_PUBLIC_CONVEX_SITE_URL=https://<your-convex-site-url>.convex.site
   CONVEX_DEPLOYMENT=dev:<your-convex-deployment>

   You can get these values from your Convex dashboard, or from the first npx convex dev run.

3. Start Convex in one terminal:

   npx convex dev

4. Start the app in another terminal:

   npx expo start

In the Expo output, you'll find options to open the app in a:

• development build
• Android emulator
• iOS simulator
• Expo Go, a limited sandbox for trying out app development with Expo

You can start developing by editing the files inside the app directory. This project uses file-based routing.

Authentication (Convex Auth + OAuth)

Robotube uses Convex Auth with Google and Apple OAuth.

If you are setting up a new deployment, initialize Convex Auth once:

npx @convex-dev/auth

Then add the required auth env vars:

npx convex env set SITE_URL robotube://
npx convex env set AUTH_GOOGLE_ID <google-client-id>
npx convex env set AUTH_GOOGLE_SECRET <google-client-secret>
npx convex env set AUTH_APPLE_ID <apple-service-id>
npx convex env set AUTH_APPLE_SECRET <apple-client-secret-jwt>

OAuth callback URLs for your provider dashboards:

• Google: https://<your-deployment>.convex.site/api/auth/callback/google
• Apple: https://<your-deployment>.convex.site/api/auth/callback/apple

Notes:

• Apple OAuth requires a public HTTPS deployment (no localhost-only flow).
• Apple client secret expires and must be rotated periodically.

Mux AI features used in this app

Robotube uses @mux/ai with Convex to enrich uploaded videos and power semantic search.

• generateEmbeddings: generates transcript chunk embeddings used for vector search in Convex.

How the pipeline works

1. User uploads a video to Mux via direct upload.
2. When the asset is ready, Convex schedules AI metadata generation.
3. Summary + tags are written to video metadata in Convex.
4. Embeddings are generated and stored in the videoEmbeddings table with a vector index.
5. Explore search combines vector similarity and lexical matching (title, summary, tags).

Backfill existing videos

If you uploaded videos before enabling these features, run the backfills after your app and Convex deployment are set up:

npx convex run migrations:backfillAiMetadataForReadyAssets '{"maxAssets":500,"defaultUserId":"mobile-user","onlyMissing":true}'
npx convex run migrations:backfillEmbeddingsForReadyAssets '{"maxAssets":500,"defaultUserId":"mobile-user","onlyMissing":true}'
npx convex run migrations:backfillModerationForReadyAssets '{"maxAssets":500,"defaultUserId":"mobile-user","onlyMissing":true}'

Get a fresh project

When you're ready, run:

npm run reset-project

This command will move the starter code to the app-example directory and create a blank app directory where you can start developing.