Nous — Documentation Index
Doc Status: Excellent | ✓ Clear summary | ✓ Easy to read | ✓ Matches code | ✓ Good structure |
✓ Professional look | ✓ Visual components | ✓ No red herrings
Why This Matters
This is the hub for feature documentation and implementation status. Engineers reference this to understand how features actually work. Designers find interaction patterns. Product managers check what’s built vs planned. If you’re trying to figure out how something in Nous is supposed to work — start here.Product Documentation
Mission & Values
Core mission and values
Vision
Five-year vision
Pricing
Subscription tiers
Roadmap
Product roadmap
Privacy Policy
Data practices
Terms of Service
User agreement
Technical Reference
Architecture
Mobile App Architecture
Expo React Native app structure, navigation, and services
AI Integration
Vicky AI wingman with Mastra and AI SDK
Specs & Plans
Platform Parity
Mobile and web feature parity requirements
Implementation Status
Feature completion tracking
Project Context
Architecture Overview
Architecture Overview
The Nous mobile app is built with Expo React Native and communicates directly with the Mastra AI runtime for all features.Key services:
use-vicky-chat.ts— AI wingman conversationslms-service.ts— Video course accessmatches-service.ts— Match managementcloudflare-stream.ts— Video upload/streaming
Tech Stack
Tech Stack
| Layer | Technology |
|---|---|
| Mobile | Expo React Native |
| AI Runtime | Mastra + Claude (Cloudflare Workers) |
| Video Streaming | Cloudflare Stream |
| Authentication | Clerk |
| Payments | Stripe |
Daily Self-Discovery
Daily photo prompts, video reflections, and quizzes that build self-awareness
3-Way Chat with Vicky
AI wingman observes and assists match conversations without reading actual messages
Trust Score System
Consistency metric built through daily engagement loops
Activities Discovery
Map, events, and social activities discovery
Official Flag
Intentional commitment milestone for established relationships
Caring Moments
Thoughtful gestures to nurture connection with matches
Relationship Mode
Couple-focused tools: shared album, check-ins, milestone tracking
Video Profiles
Short 30-second video introductions (in development)
Feature documentation for individual features is under development. See implementation
status for current development state.