Settings

Configure appearance, behavior, data handling, export preferences, and usage tracking in Stackpane.

Overview

Stackpane’s settings are organized into five tabs: Appearance, General, Data, Export, and Usage. Open settings with Cmd+, or from the menu bar.

Appearance

Customize the visual presentation of Stackpane.

Accent Color

Choose from seven accent colors that tint interactive elements throughout the app:

  • Blue (default), Purple, Orange, Green, Red, Pink, Indigo

Row Density

Control the spacing in table views:

  • Compact (24pt) — fits more rows on screen, ideal for large datasets
  • Regular (32pt) — balanced spacing (default)
  • Comfortable (40pt) — more breathing room, easier to read

Font Size

Adjust the base font size:

  • Small — slightly smaller text for more information density
  • Default — standard size
  • Large — larger text for accessibility

General

Configure behavior and safety settings.

Confirm Destructive Actions

When enabled, Stackpane shows a confirmation dialog before operations that delete data (deleting documents, collections, users, files, or functions). Enabled by default.

Always Dry-Run Bulk Operations

When enabled, bulk operations always show a preview of changes before executing. This adds an extra safety step to bulk deletes and bulk edits.

Rate Limiting

Throttle API calls to avoid hitting Firebase quota limits:

  • Off — no rate limiting
  • 10/s, 50/s, 100/s, 500/s — maximum requests per second

Notifications for Long Operations

Show system notifications when long-running operations (bulk imports, collection scans) complete.

Connection Health Check

  • Enable/disable — toggle periodic background connectivity checks
  • Interval — how frequently to check (in seconds)

Data

Configure how Stackpane loads and caches data.

Default Page Size

Number of documents loaded per page when browsing collections:

  • 25, 50, 100, 250, or 500

Larger page sizes load more data at once but use more memory and bandwidth.

Cache TTL

How long to cache API responses locally before refetching:

  • Off — no caching, always fetch fresh data
  • 15 seconds, 30 seconds, 60 seconds, 5 minutes

Query History Size

Number of recent queries to remember:

  • 10, 25, 50, or 100

Show Document Size

Toggle the display of estimated document sizes in the inspector.

Export

Default Export Format

Choose the default format for data exports:

  • JSON — structured data format, preserves types
  • CSV — spreadsheet-compatible format, flattens nested data

Usage

Configure activity tracking and data retention.

Retention Period

How long to keep activity tracking data:

  • Unlimited — keep all data indefinitely
  • 30 days, 90 days, 180 days, 1 year

Older records are automatically removed on app launch.

Default Chart Period

The default time range for usage trend charts:

  • Last Hour, Last Day, Last Week, Last Month

Manual Cleanup

Manually clear usage data:

  • Clear records older than 7 days
  • Clear records older than 30 days
  • Clear all usage data