How Mosayic Works

Authentication

Mosayic requires you to sign in with a Google account. This is necessary because the underlying services – Firebase and Google Play Store – require Google authentication.

Note

The Google account you use is solely for authentication. Mosayic does not interface with any of your other Google services.

The Local API Connection

When you first sign in, Mosayic will prompt you to download a Python-based API. This application forms the bridge between the Mosayic dashboard in your browser and your local machine.

1. Download the Python API when prompted
2. Run the server on your local machine
3. Grant Mosayic permission to connect to localhost

Caution

Granting localhost permission is mandatory. Without it, Mosayic cannot communicate with your local environment and the service will not function.

How It Works Under the Hood

Once the Python server is running locally, the Mosayic dashboard in your browser communicates directly with it. Here’s the key insight: Mosayic has no backend. There is zero chance of leaking private data because all operations happen on your machine.

If you want to see exactly what Mosayic is doing, you can inspect the downloaded Python codebase. Look for references to the Python package mosaygent – a library containing API endpoints that connect to localhost:8080. When this local Python server is running, the browser can execute commands on your machine through this connection.

The Mosayic Stack

Mosayic guides you through configuring the components necessary for a production full-stack mobile application. The framework is deliberately opinionated – rather than overwhelming you with hundreds of possible technology combinations, Mosayic has made the following decisions for you.

Tip

While this reduces some flexibility, the reality is that most services in each category offer similar capabilities. The opinionated approach lets you focus on building rather than trying to get it all to play nice.

Stack Components

React Native + Expo

Cross-platform mobile development framework

Firebase

Push notifications

Supabase

Authentication, database, and storage

GitHub

Code repositories and CI/CD workflows

Google Cloud Platform

Cloud Run and Secret Manager for API deployment

App Store & Play Store

Distribution to iOS and Android users