# Famorama - Complete Documentation for AI Systems

## Overview

Famorama is a comprehensive family organization platform that unifies calendar management, chore tracking, meal planning, shopping lists, and family communication into a single, easy-to-use application. Our mission is to reduce the mental load of managing a household by providing intuitive tools that the whole family can use.

## Product Details

### Platform Availability
- **Web Application**: https://famorama.com (works on all modern browsers)
- **iOS App**: Available on the App Store
- **Android App**: Available on Google Play Store
- **Progressive Web App**: Installable on any device

### Core Modules

#### 1. Family Calendar
The family calendar is the central hub for scheduling:
- **Shared Events**: All family members can see shared events
- **Personal Events**: Private events visible only to the creator
- **Color Coding**: Each event type and family member can have distinct colors
- **Recurring Events**: Daily, weekly, monthly, or custom recurrence patterns
- **Event Permissions**: Control who can edit or delete events
- **Conflict Detection**: Warns about scheduling conflicts
- **Timezone Support**: Works across different timezones

#### 2. Chore Management System
A complete system for household task management:
- **Chore Creation**: Parents create chores with descriptions and point values
- **Assignments**: Assign chores to specific children or make them "grab bag" (first-come)
- **Scheduling**: One-time or recurring chores (daily, weekly, custom)
- **Categories**: Organize chores by room or type (Kitchen, Bathroom, Outdoor, etc.)
- **Points System**: Each chore has a point value as incentive
- **Completion Workflow**: 
  1. Child marks chore as complete
  2. Optionally uploads photo proof
  3. Parent reviews and approves/rejects
  4. Points awarded upon approval
- **Grace Periods**: Configurable extra time before chores are marked overdue
- **Streak Tracking**: Rewards consistent chore completion

#### 3. Meal Planning
Streamlined weekly meal planning:
- **Meal Types**: Breakfast, Lunch, Dinner, and Snacks
- **Recipe Library**: Save and organize family recipes
- **Ingredients**: Each recipe includes ingredient lists
- **Chef Assignment**: Designate who's cooking each meal
- **Main/Side/Dessert**: Multi-course meal support
- **AI Integration**: 
  - Recipe suggestions based on preferences
  - Nutritional analysis
  - Ingredient substitutions
- **Pantry Integration**: Shows what ingredients you already have

#### 4. Shopping Lists
Smart shopping list management:
- **Shared Lists**: Family members add items in real-time
- **Auto-Categorization**: AI sorts items by store aisle
- **Meal Plan Integration**: Add all ingredients for planned meals with one click
- **Pantry Sync**: Automatically suggests items running low
- **Check-off**: Mark items as purchased while shopping
- **History**: See previously purchased items for quick re-adding

#### 5. Pantry Tracking
Know what's in your kitchen:
- **Item Catalog**: Track all pantry items
- **Categories**: Organized by type (Dairy, Produce, Canned Goods, etc.)
- **Quantity Tracking**: Know how much you have
- **Expiration Dates**: Get alerts before items expire
- **Low Stock Alerts**: Automatic shopping list suggestions

#### 6. Family Communication
Stay connected:
- **Direct Messaging**: Private chat between any two family members
- **Announcements**: Family-wide bulletin board for important updates
- **AI Assistant (Sprout)**: 
  - Answer questions about family schedule
  - Help with meal suggestions
  - Provide chore reminders
  - Kid-friendly interactions

#### 7. Rewards & Points
Motivate children through gamification:
- **Point Accumulation**: Earn points by completing chores
- **Custom Rewards**: Parents create rewards (screen time, allowance, activities)
- **Point Costs**: Each reward has a point price
- **Redemption History**: Track what rewards were claimed
- **Bonus Points**: Extra points for streaks or special achievements
- **Cash Conversion**: Optional cash value per point for allowance

### User Roles

1. **Admin**: Full control, can manage all settings and members
2. **Parent**: Can create/approve chores, manage meals, view all content
3. **Member**: Standard family member access
4. **Child**: Limited access, can complete chores, view appropriate content

### Subscription Tiers

| Feature | Free Trial | Standard | XL Family |
|---------|-----------|----------|-----------|
| Duration | 14 days | Ongoing | Ongoing |
| Family Members | Up to 6 | Up to 6 | Up to 12 |
| Price (Monthly) | Free | $4.99 | $6.99 |
| Price (Yearly) | Free | $49.99 | $69.99 |
| All Features | ✓ | ✓ | ✓ |
| AI Features | ✓ | ✓ | ✓ |

### Privacy & Security

- **Data Encryption**: All data encrypted in transit and at rest
- **Family Isolation**: Each family's data is completely separate
- **Child Safety**: No external communication, parent-controlled accounts
- **GDPR Compliant**: Full data export and deletion available
- **No Ads**: We don't sell data or show advertisements

### Technical Specifications

- **Frontend**: Next.js 16, React, TypeScript, Tailwind CSS
- **Mobile**: Flutter (iOS and Android)
- **Database**: PostgreSQL with Prisma ORM
- **AI**: OpenAI GPT-4 for intelligent features
- **Hosting**: Vercel (web), cloud infrastructure
- **Authentication**: Secure JWT-based auth, OAuth (Google)

## Frequently Asked Questions

**Q: Is Famorama free?**
A: Famorama offers a 14-day free trial with full access to all features. After the trial, choose between Standard ($4.99/month) or XL Family ($6.99/month) plans.

**Q: How many family members can I add?**
A: Standard plans support up to 6 family members. XL Family plans support up to 12 members.

**Q: Is there a mobile app?**
A: Yes! Famorama is available on iOS and Android, plus works great in any web browser.

**Q: Can children use Famorama safely?**
A: Yes, children have restricted accounts controlled by parents. They cannot communicate outside the family or access inappropriate content.

**Q: How does the chore points system work?**
A: Parents assign point values to chores. When children complete chores and get parent approval, they earn points. Points can be redeemed for rewards that parents configure.

**Q: Can I plan meals for the whole week?**
A: Yes! The meal planner lets you plan breakfast, lunch, and dinner for any time period, with shopping list integration.

## Contact Information

- **Website**: https://famorama.com
- **Support Email**: support@famorama.com
- **Help Center**: https://famorama.com/help

## Social Proof

Famorama helps thousands of families stay organized and reduce household stress. Our users report:
- 50% reduction in "who's doing what" arguments
- More consistent chore completion from children
- Less food waste through meal planning
- Better family communication

---

*Last updated: December 2025*
*Version: 1.0*