Connect an Emergent app

Create a login for the walker

Open your published app and sign up with a fresh email you control. Give FixWalk that email and password on the connections screen. The walker uses this account and no other.

Link your repo

In the Emergent chat, use Save to GitHub (available on the Standard plan and above) and choose the repository. Then pick it on FixWalk's connections screen. FixWalk only reads it.

Give the walker your database connection string

Read-only, always. We store it encrypted, use it only during a walk, and delete it the moment you disconnect. The walker writes only under its own account, never yours.

Emergent shows your live database connection once the app is published:

1. In your Emergent project, click Publish (top right), then Publish now. Publishing takes about six minutes.
2. When it says your app is live, close the dialog. You are now in Manage Publishing.
3. Open the Database tab. Under Database details you will see App name and Mongo URL. Copy the Mongo URL and paste it on FixWalk's connections screen.

Good to know: Emergent gives you one connection string for your live database, and that user can write as well as read; Emergent's database is a shared cluster it manages, so a separate read-only user cannot be created there. FixWalk stores the string encrypted, uses it only during a walk, deletes it the moment you disconnect, and the walker's database tool can only run read commands. If you would rather not share a write-capable key, skip this step and FixWalk runs a walk that checks your screens and exports instead.