Serenity Flow is an intelligent productivity and wellness application that automates meeting insights, manages your backlog, and helps you maintain work-life balance through smart break scheduling and wellness tracking.

Serenity Flow integrates with your existing tools (Google Calendar, Notion) to:

• Automate meeting insights - Extract action items and stories from meeting notes
• Manage your backlog - Automatically organize, deduplicate, and prioritize tasks
• Schedule intelligent breaks - AI-powered break suggestions based on your schedule
• Track wellness metrics - Monitor your meeting patterns and wellness scores
• Generate reports - Automated release reports and stakeholder updates

• Story Extraction - Automatically extract actionable items from Notion meeting notes
• Backlog Auditing - Identify duplicates and low-priority items
• Stakeholder Mapping - Track and map stakeholders from stories
• Customer Research - Analyze customer feedback and market trends
• Release Reports - Generate automated release reports
• Meeting Insights - Extract insights and action items from meetings
• Sprint Planning - Assist with sprint planning and story organization

• Smart Break Scheduling - AI-powered break suggestions based on your calendar
• Wellness Tracking - Monitor meeting patterns, engagement, and wellness scores
• Calming Audio - Theme-based background sounds (Forest, Rain, Ocean, Wind Chimes)
• Break Types - Different break types based on time available and context

• Theme System - Multiple calming themes (Ocean Waves, Forest, Gentle Rain, Wind Chimes)
• Sound Controls - Mute/unmute functionality with persistent preferences
• Real-time Notifications - Toast notifications for actions and status updates
• Interactive Dashboard - Clean, modern UI with real-time updates
• Responsive Design - Works on desktop and mobile devices

• React 18 - UI framework
• Vite - Build tool and dev server
• Tailwind CSS - Utility-first CSS framework
• Framer Motion - Animation library
• React Router - Client-side routing
• Axios - HTTP client

• FastAPI - Modern Python web framework
• SQLAlchemy - ORM for database operations
• SQLite - Database (default, can be configured for PostgreSQL)
• Google Generative AI (Gemini) - AI-powered analysis and extraction
• Google Calendar API - Calendar integration
• Notion API - Notion integration
• Uvicorn - ASGI server

Before you begin, ensure you have the following installed:

• Node.js (v16 or higher) - Download
• Python (3.8 or higher) - Download
• pip - Python package manager
• Git - Version control system

You'll need to set up the following:

1. Google Cloud Console

   • Google OAuth Client ID and Secret
   • Google Calendar API enabled
   • Gemini API Key

2. Notion

   • Notion OAuth Client ID and Secret
   • Notion workspace with meeting notes

3. Optional

   • ElevenLabs API Key (for audio features)
   • Twilio credentials (for voice calls)

git clone <repository-url>
cd serenityflow

cd backend
python -m venv venv

Windows:

venv\Scripts\activate

macOS/Linux:

source venv/bin/activate

pip install -r requirements.txt

Create a .env file in the backend directory:

# Google OAuth
GOOGLE_CLIENT_ID=your_google_client_id
GOOGLE_CLIENT_SECRET=your_google_client_secret
GOOGLE_REDIRECT_URI=http://localhost:8000/auth/google/callback

# Notion OAuth
NOTION_CLIENT_ID=your_notion_client_id
NOTION_CLIENT_SECRET=your_notion_client_secret
NOTION_REDIRECT_URI=http://localhost:8000/auth/notion/callback

# API Keys
GEMINI_API_KEY=your_gemini_api_key
ELEVENLABS_API_KEY=your_elevenlabs_api_key  # Optional

# Database
DATABASE_URL=sqlite:///./serenity.db

# Security
SECRET_KEY=change-this-to-a-secure-random-string-in-production
ALGORITHM=HS256

OAUTHLIB_RELAX_TOKEN_SCOPE=1

cd ..
npm install

1. Go to Google Cloud Console
2. Create a new project or select an existing one
3. Enable the following APIs:
   • Google Calendar API
   • Google OAuth2 API
4. Create OAuth 2.0 credentials:
   • Go to "Credentials" → "Create Credentials" → "OAuth client ID"
   • Choose "Web application"
   • Add authorized redirect URI: http://localhost:8000/auth/google/callback
   • Copy the Client ID and Client Secret to your .env file

1. Go to Notion Integrations
2. Click "New integration"
3. Give it a name (e.g., "Serenity Flow")
4. Select capabilities:
   • Read content
   • Update content
   • Insert content
5. Copy the OAuth client ID and secret
6. Add the integration to your Notion workspace
7. Set the redirect URI to: http://localhost:8000/auth/notion/callback

1. Go to Google AI Studio
2. Create a new API key
3. Copy the key to your .env file as GEMINI_API_KEY

1. Go to ElevenLabs
2. Sign up for an account
3. Get your API key from the dashboard
4. Add it to your .env file (optional, for future audio features)

cd backend
python main.py

Or using uvicorn directly:

uvicorn main:app --reload --host 0.0.0.0 --port 8000

The API will be available at:

• API: http://localhost:8000
• API Docs: http://localhost:8000/docs
• Health Check: http://localhost:8000/api/health

npm run dev

The frontend will be available at http://localhost:3000 (or the port shown in terminal)

serenityflow/
├── backend/                 # FastAPI backend
│   ├── routes/             # API route handlers
│   │   ├── auth.py        # Authentication endpoints
│   │   ├── automation.py  # Automation pipeline
│   │   ├── checklist.py   # Checklist management
│   │   ├── serenity.py    # Main Serenity features
│   │   └── wellness.py    # Wellness tracking
│   ├── utils/             # Utility functions
│   │   ├── agents/        # Automation agents
│   │   ├── gemini.py      # Gemini AI integration
│   │   ├── google_calendar.py  # Google Calendar integration
│   │   └── notion.py      # Notion integration
│   ├── database.py        # Database models
│   ├── main.py           # FastAPI application
│   ├── config.py         # Configuration settings
│   └── requirements.txt  # Python dependencies
│
├── src/                   # React frontend
│   ├── components/       # React components
│   │   ├── Dashboard.jsx
│   │   ├── AutomationChecklist.jsx
│   │   ├── BreakTimeline.jsx
│   │   └── ...
│   ├── hooks/           # Custom React hooks
│   │   ├── useAuth.js
│   │   ├── useTheme.jsx
│   │   └── ...
│   └── utils/           # Utility functions
│
├── public/              # Static assets
│   ├── *.mp3           # Theme sounds
│   └── *.wav           # Event sounds
│
├── package.json         # Node.js dependencies
└── README.md           # This file

1. Start both servers (backend and frontend)
2. Navigate to http://localhost:3000
3. Authenticate with Google to connect your calendar
4. Connect Notion from the Settings page
5. Start using the automation features!

1. Go to the Dashboard
2. Scroll to the Automation Checklist section
3. Follow the Quick Start Workflow:
   • Step 1: Extract stories from your Notion pages
   • Step 2: Analyze and clean your backlog
   • Step 3: Monitor system health
4. Review and approve extracted items
5. Let the automation handle the rest!

1. The system automatically suggests breaks based on your calendar
2. Click "Take a Break" when a break is suggested
3. Choose your preferred theme and background sound
4. The break modal will guide you through a 5-minute meditation

• View your wellness metrics on the dashboard
• Monitor meeting patterns and engagement scores
• Track your break frequency and effectiveness

cd backend
uvicorn main:app --reload --host 0.0.0.0 --port 8000

The --reload flag enables auto-reload on file changes.

npm run dev

The Vite dev server supports hot module replacement (HMR).

Frontend:

npm run build

Backend: The backend can be deployed as-is or using a production ASGI server like Gunicorn with Uvicorn workers.

• Never commit your .env file to version control
• Change the SECRET_KEY in production
• Use HTTPS in production
• Set up proper CORS for your production domain
• Use environment variables for all sensitive data
• Regularly rotate API keys and OAuth credentials

See backend/config.py for all configuration options. Required environment variables:

This project is licensed under the MIT License.

• Google Calendar API - For calendar integration
• Notion API - For workspace integration
• Google Gemini - For AI-powered analysis
• FastAPI - For the excellent Python web framework
• React - For the UI framework
• Tailwind CSS - For the utility-first CSS framework