Documentation

Terraform Dock

Terraform Dock (Apple-Style Bottom Bar)

The Dock is the bottom navigation bar in the Workspace Editor. It provides one-click access to all Terraform operations and workspace tools.

Dock Layout

  • Positioned at the bottom of the workspace editor
  • Can be collapsed to a single button or expanded to show all actions
  • Animated expand/collapse with smooth motion
  • Configurable position: Left, Center, or Right alignment
  • Configurable orientation: Horizontal or Vertical
  • Position and orientation preferences are saved in settings

Collapsed State

  • Shows a single icon button
  • Click to expand the dock

Expanded State

The dock shows all available operations:

TERRAFORM OPERATIONS
  1. 1
    Init (terraform.init permission required)
    • Initializes the Terraform working directory
    • Downloads required providers and modules
    • Must be run first before any other operation
    • Runs in the VS Container terminal
  2. 2
    Validate (terraform.validate permission required)
    • Checks your Terraform configuration for syntax and logical errors
    • Does not connect to the cloud provider
    • Quick check before running plan
  3. 3
    Plan (terraform.plan permission required)
    • Shows a preview of what Terraform will create, modify, or destroy
    • Opens an environment selector (Dev, Staging, Prod) to choose the target environment
    • Runs terraform plan and displays output in the terminal
    • Review the plan carefully before applying
  4. 4
    Apply (terraform.apply permission required)
    • Deploys the planned infrastructure changes to the cloud
    • Opens an environment selector to confirm the target environment
    • Prompts for confirmation before executing
    • Streams output to the terminal in real-time
    • This action creates/modifies/destroys real cloud resources
  5. 5
    Destroy (terraform.destroy permission required)
    • Destroys all infrastructure managed by this workspace's Terraform state
    • Use with extreme caution — this permanently deletes cloud resources
    • Opens a confirmation dialog with a strong warning
    • Streams output to the terminal
ADDITIONAL DOCK ITEMS
  1. 1
    Drift Check
    • Checks if actual cloud resources have drifted from your Terraform state
    • Triggers an immediate drift detection scan
    • Results shown in the Drift Detection page
  2. 2
    Preview Architecture (terraform.preview permission required)
    • Runs terraform graph and renders the dependency graph
    • Opens in the Graph tab of the right panel
    • Visualizes all resources and their dependencies
  3. 3
    Infrastructure Analysis
    • Opens the Infrastructure Analysis panel
    • Shows cost estimates, security compliance, and optimization suggestions
  4. 4
    Compliance Modal
    • Opens a compliance check dialog
    • Validates infrastructure against compliance policies
  5. 5
    Settings
    • Opens workspace settings
    • Configure dock position, orientation, and other workspace preferences
ENVIRONMENT SELECTOR

For Plan and Apply operations, the environment selector appears

  • Dev: Development environment
  • Staging: Staging/QA environment
  • Prod: Production environment
  • Selecting an environment may load environment-specific variable files

Dock Customization

  • Change position: Go to Settings > Dock Settings
  • Options: Left, Center, Right
  • Change orientation: Horizontal (side by side) or Vertical (stacked)
  • Settings are remembered across sessions