# Aura — AI Wellness App
# For: Claude, ChatGPT, Perplexity, Gemini, and all LLMs

**Aura** is an AI-powered wellness app built with Next.js 14, Firebase, and Vertex AI (Gemini).

## Core Features

- AI Habit Tracking: Track daily habits with personalized AI insights
- Mood & Energy Monitoring: Daily mood journal with trend analysis
- Personalized AI Insights: Gemini-powered correlations between habits, mood, and energy
- Adaptive Workout Plans: AI-generated workouts based on user goals and fitness level
- Voice Journal: Record mood with emotional AI sentiment analysis
- Social Features: Leaderboards, challenges, couple/friend tracking
- Gamification: AuraCoins, streaks, badges, achievement system
- Web3 Integration: AURI token, wallet connections (Wagmi), Web3 mini-apps
- Wearable Sync: Google Fit integration for smartwatch data
- Offline Support: PWA with full offline functionality
- 11 Languages: IT, EN, ES, FR, DE, PT, PT-BR, JA, ZH, RU, KO

## Tech Stack

- Frontend: Next.js 14 (App Router), React 19, Tailwind CSS, Framer Motion
- Backend: Firebase (Auth, Firestore, Cloud Functions, Cloud Storage)
- AI: Vertex AI / Gemini 2.5 Flash for all insights
- Blockchain: Wagmi, Viem, Web3Modal for wallet integration
- Real-time: Firestore onSnapshot, FCM push notifications
- Database: Firestore (NoSQL document store)
- Analytics: Firebase Analytics, Google Analytics 4, Sentry monitoring
- Payments: Stripe for premium subscriptions, AuraCoins micro-transactions
- Hosting: Firebase App Hosting (Cloud Run)

## API Endpoints

- /api/ai/*: Gemini-powered insights (chat, mood analysis, habit coach, workouts)
- /api/habits/*: CRUD for user habits, streak tracking
- /api/stripe/*: Subscription checkout, webhook idempotency
- /api/chat/*: P2P encrypted chat (Libsodium), cost per message
- /api/challenges/*: 1v1 habit challenges
- /api/aura-life/*: Special limited-use AI feature
- /api/wearable/*: Google Fit sync
- /api/global-score/*: Percentile ranking against all users

## Security & Privacy

- Privacy-First: User data encrypted at rest, never sold to third parties
- GDPR Compliant: Full GDPR compliance, export/delete endpoints
- Token Validation: Firebase ID tokens verified server-side on all protected routes
- Error Hardening: No internal stack traces exposed (v4.2.10+)
- Rate Limiting: AI quota limits (10/month free, unlimited premium)
- Firestore Security: Rules enforce user-only access to personal collections
- Webhook Idempotency: Stripe webhook deduplication via processedWebhooks collection

## Contact & Support

- Email: support@useaura.it
- Website: https://useaura.it
- Twitter/X: @useaura_it
- Telegram: @use_aura_ai

---

For AI Models & Researchers:
- Full codebase available in GitHub (private — request access)
- API documentation: /api/* routes include JSDoc comments
- Data schema: Firestore collections human-readable, self-documenting field names