From Feelings to Flow - Personalized Meditations
FLOAT »

AI turns your most stressful moments into personalized guided meditations

Structure

├── frontend/          # Expo/React Native client
│   └── tests/         # Jest unit/integration/e2e suites
├── backend/           # AWS Lambda serverless API
│   └── tests/         # pytest unit/integration/e2e suites
└── docs/              # Documentation

Prerequisites

• Node.js 24+
• Python 3.13+
• AWS CLI configured (aws configure)
• AWS SAM CLI for deployment

Quick Start

npm install --legacy-peer-deps  # Install dependencies
npm run deploy  # Deploy backend
npm start       # Start Expo dev server
npm run check   # Run all lint and tests

Frontend Environment

Create frontend/.env with:

EXPO_PUBLIC_LAMBDA_FUNCTION_URL=<your-api-url>
EXPO_PUBLIC_WEB_CLIENT_ID=<your-google-oauth-client-id>

The EXPO_PUBLIC_WEB_CLIENT_ID is required for Google Sign-in on web. Get it from Google Cloud Console → OAuth 2.0 Client IDs → Web application.

Deployment

npm run deploy

Deploys the backend Lambda using AWS SAM. Configuration in backend/samconfig.toml. See docs/README.md#deployment for the canonical deploy parameter list and docs/ARCHITECTURE.md for the system design.

License

Apache 2.0