Skip to content

Work With Local Data Environments ​

Task guide

Create, switch, seed, inspect, reset, and export local SQLite-backed Glade environments.

  • Use a named environment for the local DB.
  • Open a browser record manager for create, edit, delete, and undelete.
  • Clone an environment for a branch.
  • Seed and inspect local data.

Before you start ​

  • Glade is initialized in a Salesforce DX project.
  • For the editor steps, VS Code has the bundled Glade extension installed; other extensions and themes can remain.
  • These environments are local SQLite files. They do not copy Salesforce org data unless you import or seed data yourself.

Steps ​

1. Inspect the active environment in VS Code ​

Open the Glade side view. Use Data Environments and Data Browser to see the active DB.

VS Code showing Glade local data environments

2. Seed and inspect from a terminal ​

bash
glade doctor --project .
glade db seed --project . <seed-file>
glade db inspect --project .

Expected: doctor shows the project local data environment, and db inspect reports local rows in the default project DB.

Use a named environment when you want a separate project DB:

bash
glade db seed --project . --env qa <seed-file>
glade db inspect --project . --env qa

Terminal showing local data seed and inspect output

3. Open the browser record manager ​

bash
glade db ui --project .

Expected: Glade opens /db for the default project DB. Use the object rail to pick an object, then use Create, Save, Delete, and Undelete from the record table and drawer.

Use a named project DB when you need a separate data set:

bash
glade db ui --project . --env qa

For automation or smoke tests, avoid opening a browser and wait on a ready file:

bash
glade db ui --project . --addr 127.0.0.1:0 --no-open --ready-file /tmp/glade-db-ui-ready.json

Common wrong turn ​

Do not reuse a SQLite file from another project. Glade binds local DBs to the project schema and stops early when the object or field shape does not match.

Glade: Clone Local Data Environment copies local SQLite state. It does not contact Salesforce or refresh data from an org.

Next ​

Glade is an independent project and is not affiliated with, sponsored by, or endorsed by Salesforce. Salesforce and Apex are trademarks of Salesforce, Inc. · Maintainer · Security · Releases · Apache-2.0