> ## Documentation Index
> Fetch the complete documentation index at: https://docs.nometria.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Manus to Supabase

> One-command migration for Manus AI projects: swap MySQL to PostgreSQL, add Supabase auth, wire everything up.

`manus-to-supabase` converts a Manus AI project from its default MySQL backend to Supabase + PostgreSQL. It patches your codebase, rewrites queries, and wires up Supabase auth — in one command.

<CardGroup cols={2}>
  <Card title="GitHub" icon="github" href="https://github.com/nometria/manus-to-supabase">
    nometria/manus-to-supabase
  </Card>

  <Card title="PyPI" icon="python" href="https://pypi.org/project/manus-to-supabase/">
    manus-to-supabase on PyPI
  </Card>
</CardGroup>

## Install

```bash theme={null}
pip install manus-to-supabase
```

## Usage

```bash theme={null}
# Run in your Manus project directory
manus-to-supabase /path/to/your/manus-project

# Or from inside the project
cd /path/to/manus-project
manus-to-supabase

# Dry run — preview changes without writing
manus-to-supabase . --dry-run
```

## What it does

| Step                   | What happens                                                   |
| ---------------------- | -------------------------------------------------------------- |
| **MySQL → PostgreSQL** | Rewrites SQL queries, data types, and ORM calls                |
| **Auth migration**     | Replaces Manus session auth with Supabase auth                 |
| **Environment setup**  | Generates `.env` template with required Supabase variables     |
| **Schema output**      | Produces a ready-to-run `schema.sql` for your Supabase project |
| **Dependency update**  | Updates `package.json` or `requirements.txt` with Supabase SDK |

## After migration

Set your environment variables:

```bash theme={null}
VITE_SUPABASE_URL=https://your-project.supabase.co
VITE_SUPABASE_ANON_KEY=eyJ...
SUPABASE_JWT_SECRET=your-jwt-secret
DATABASE_URL=postgresql://user:pass@host:5432/db
```

Run the generated schema in your Supabase SQL editor, then install and build:

```bash theme={null}
npm install
npm run build
```

## Why Supabase?

Manus uses a managed MySQL database that you don't control. Migrating to Supabase gives you:

* Full ownership of your data
* PostgreSQL with row-level security
* Drop-in auth with social providers
* Realtime subscriptions
* Open source and self-hostable

<Tip>For a fully managed deployment, use Nometria to deploy your migrated Manus project to AWS with a custom domain and SSL.</Tip>