Workspace Setup

Organize your workspace with multiple environments, configure settings, and understand Stackpane's project model.

Project Organization

Stackpane organizes your work around connections. Each connection points to a single project and environment (production, staging, or local dev) for any supported provider — Firebase, Supabase, or AWS. You can create multiple connections to the same project with different environments.

A typical setup for a team project might include:

  • Production — read-only or limited access for safe browsing of live data
  • Staging — full access for testing (service account, service role key, or admin IAM credentials)
  • Local Dev — local emulator, Docker, or LocalStack environment for development

Multiple Environments

Production and Staging

If your project uses multiple environments (separate projects or instances for prod and staging), create one connection for each:

  1. Create a connection named “My App - Production” with your production credentials.
  2. Create a second connection named “My App - Staging” with your staging credentials.
  3. Switch between them using the project picker in the sidebar.

Stackpane clearly labels the active connection so you always know which environment you are working in.

Local Dev Alongside Production

You can keep a production connection and a local dev connection side by side. This is useful for comparing production data with local test data, or for copying production records into a local environment for testing.

Connection Settings

Each connection stores:

  • Name — a human-readable label
  • Provider — Firebase, Supabase, or AWS
  • Project identifier — project ID (Firebase), project URL (Supabase), or region and endpoint (AWS)
  • Environment — Production, Staging, or Local Dev
  • Auth credentials — provider-specific authentication (Google Sign-In, Service Account, API key, or IAM credentials)
  • Local dev config — host, ports, and launch method (local environments only)

Edit a connection at any time from the sidebar by clicking the gear icon next to the connection name.

Global Settings

Stackpane’s global settings apply across all connections. Open settings with Cmd+, or from the menu bar.

Appearance

  • Accent color — choose from Blue, Purple, Orange, Green, Red, Pink, or Indigo
  • Row density — Compact, Regular, or Comfortable spacing in tables
  • Font size — Small, Default, or Large

General

  • Confirm destructive actions — show confirmation dialogs before deletes
  • Always dry-run bulk operations — preview changes before executing
  • Rate limiting — throttle API calls to avoid quota issues
  • Connection health check — periodic background checks for connectivity

Data

  • Default page size — number of documents loaded per page (25, 50, 100, 250, or 500)
  • Cache TTL — how long to cache API responses locally
  • Query history size — number of recent queries to remember

Export

  • Default export format — JSON or CSV

Usage

  • Retention period — how long to keep activity tracking data
  • Default chart period — time range for usage trend charts

Next Steps

With your connection set up and settings configured, you are ready to start working with your data. Head to the Database Overview to understand how Stackpane handles each database type, or explore the sidebar to access Authentication, Storage, and other services.