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:
- Create a connection named “My App - Production” with your production credentials.
- Create a second connection named “My App - Staging” with your staging credentials.
- 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.