medito-app

# About Medito

## About

Meditation can positively transform people's lives, and we believe no one should have to pay for it. We are the [Medito Foundation](https://meditofoundation.org), and we've built the Medito App for people who have never meditated before or want to deepen their meditation practice.

The app is free, forever: no ads, no spam, no need to sign up or pay. Medito App is a Flutter project available on Android and iOS maintained by the Medito Foundation and its community.

## Download

- Play Store: [Download on Google Play](https://play.google.com/store/apps/details?id=meditofoundation.medito)
- App Store: [Download on the App Store](https://apps.apple.com/us/app/medito/id1500780518)
- APK:

**NOTE:** If you install the Medito app using the APK file, please make sure to verify that the APK file is signed by Medito Foundation. See [VERIFY_APK](docs/VERIFY_APK.md) for more information.

### Contributions (Running in Mock Mode (no keys required))

Contributors can run the app without any API keys or Firebase setup using mock mode. All network calls are intercepted and return hardcoded sample data — no real credentials are needed.

1. Clone the repository and install dependencies:
   ```
   git clone https://github.com/meditohq/medito-app.git
   cd medito-app
   flutter pub get
   ```

1. Generate required code (Pigeon + Riverpod):
   ```
   for f in pigeon_conf.dart pigeons/*.dart; do flutter pub run pigeon --input "$f"; done
   dart run build_runner build --delete-conflicting-outputs
   ```

1. Create `android/keystore.properties` using your own debug keystore. The Android SDK auto-creates one at `~/.android/debug.keystore` with default credentials:

   ```
   cp android/keystore.properties.example android/keystore.properties
   ```

   Then edit `android/keystore.properties` with your keystore details:

   ```
   storePassword=<your-keystore-password>
   keyPassword=<your-key-password>
   keyAlias=<your-key-alias>
   storeFile=<absolute-path-to-your-keystore>
   appId=meditofoundation.medito
   versionCode=1
   versionName=1.0.0
   ```

   For the default Android debug keystore the password, key password, and alias are `android`, `android`, and `androiddebugkey` respectively.

1. Create a placeholder `android/app/google-services.json` (Firebase is skipped in mock mode, but Gradle requires the file)
2. Run the app using the **"Flutter (Mock)"** run configuration in VS Code or Android Studio, or from the terminal:
   ```
   flutter run --flavor dev --dart-define=MOCK_MODE=true -d <device-id>
   ```

In mock mode, Firebase, the paywall webview, Stripe, and Meta SDK are all skipped. The app runs with sample content so you can work on UI and logic without real credentials.

### Setup (with real keys)

1. Clone the repository:
   ```
   git clone https://github.com/meditohq/medito-app.git
   cd medito-app
   ```

1. Install dependencies:
   ```
   flutter pub get
   ```

1. Set up environment files:
   - Create `.env.staging` and `.en