Introduction

Welcome to the Mosayic documentation. This guide will help you get started with Mosayic and explore its features.

What Makes Mosayic Different?

Mosayic is an architecture framework for building full-stack mobile applications. While AI and large language model-based coding play a role in Mosayic, it takes a fundamentally different approach from the generalized one-shot prompt AI app builders you may have encountered.

A realistic approach to AI-assisted development

Short of very simple MVPs, it’s unreasonable to expect a single prompt to produce a fully working application with any real complexity. Mosayic embraces this reality.

Rather than attempting to build your entire application in a black box in the cloud, Mosayic interfaces directly with your local machine. The focus is on constructing a proper development environment that you control.

Why Local Development Matters

With Mosayic, you get a clear separation between environments:

Development Environment

Runs on your local machine where you can safely experiment, iterate, and break things without consequences.

Production Environment

Lives in the cloud serving real users in a stable, protected environment you’re not actively modifying.

Complete Isolation for Safe Development

This architecture gives you isolated instances of every component of your stack:

• Database – Modify schemas and experiment with test data without risk
• Authentication – Test auth flows separately from your live user base
• API – Develop and debug endpoints in isolation
• Mobile codebase – Experiment freely, discard changes that don’t work, and push only what you’re ready to ship

When you’re satisfied with your changes, you push to production on your terms.