Skip to content
Mosayic

Quick Start

This page is the short version. The in-app Setup Guide is the long version, and it walks you through every step inside the dashboard with live status checks. You should follow the in-app guide once you’ve completed the prerequisites here.

Prerequisites

Section titled “Prerequisites”

You need:

A Google account

You’ll sign in to Mosayic with Google. The same account is used to authenticate everywhere.

VS Code 1.96 or newer

Mosayic is a VS Code extension. Download VS Code if you don’t have it.

A phone you can install dev builds on

iPhone (requires a $99/yr Apple Developer account) or Android (free).

A computer you can install CLI tools on

macOS, Windows, or Linux. You’ll install Node, Docker, Expo CLI, the GitHub CLI, the Google Cloud CLI, and the Supabase CLI as you go.

You do not need to set up any accounts in advance. The setup guide walks you through creating your GitHub, Google Cloud, Expo, and Supabase accounts at the right moments.

Five-minute setup

Section titled “Five-minute setup”

  1. Sign in to the dashboard.

    Visit app.mosayic.io and click Continue with Google. You’ll land on a page that asks you to name your first project.

  2. Create a project.

    Pick a name — it’s just for your dashboard, so anything short and memorable is fine. Click Create project. You’ll be dropped into the in-app Setup Guide.

  3. Install the VS Code extension.

    In VS Code, open the Extensions panel and search for Mosayic. Install the one published by mosayic. The extension activates automatically when VS Code finishes loading.

  4. Sign the extension in.

    Open the Command Palette (Cmd/Ctrl + Shift + P), run Mosayic: Sign In, and complete the Google consent flow in your browser. Use the same Google account you signed in to the dashboard with.

    When the extension’s status bar item (bottom-left of VS Code) shows Mosayic: connected, you’re done.

  5. Follow the Setup Guide.

    Switch back to the dashboard. The guide will detect that the extension is online and unlock the remaining steps. From here, the dashboard walks you through:

    • Choosing iPhone or Android
    • Connecting GitHub, Google Cloud, and Expo
    • Scaffolding the mobile and API repos
    • Starting Supabase locally
    • Building your first dev client
    • Scanning a QR code to open the app on your phone

When you finish, you’ll have a real React Native app running on your phone, talking to a real API on your machine, backed by a real Postgres database. Everything is in your own GitHub repos and your own cloud accounts.

What’s next

Section titled “What’s next”
The Setup Guide Read the long version of the setup, with screenshots and gotchas for each step.
The Blueprint Once setup is done, the Blueprint is where you go to add features (push notifications, payments, auth flows, etc.).
VS Code Extension Reference for what the extension does, the commands it provides, and the settings you can tweak.