Getting Started

DevDb Pro is a zero-config VS Code extension that automatically discovers and loads your database, providing a rich database client interface and powerful development tools right inside your editor.

Requirements

• VS Code 1.83 or newer
• A VS Code project using any of the supported databases

Supported Platforms

DevDb Pro works consistently across all major platforms:

• Linux (x64, arm64, arm, Alpine-x64)
• macOS (Intel and Apple Silicon)
• Windows (x64)

Ubuntu 20.04 and Below

Ubuntu 20.04 (including equivalent distros) and below are not supported because they have reached EOL and no longer have supported runners in GitHub Actions.

How It Works

DevDb Pro uses intelligent auto-discovery to detect your database configuration from your project files:

1. Open your project in VS Code
2. DevDb automatically detects your database from configuration files (.env, database.yml, settings.py, etc.)
3. Access your database by opening the DevDb view or using keyboard shortcuts

Zero-Config Environments

DevDb automatically discovers databases in these environments:

• DDEV - Applications managed by DDEV
• Laravel - SQLite, MySQL/MariaDB, PostgreSQL, SQL Server (with default .env config)
• Laravel Sail - Containerized Laravel with Docker (including dev containers)
• Django - SQLite, MySQL, PostgreSQL (with settings.py)
• Ruby on Rails - SQLite, MySQL, PostgreSQL (with config/database.yml)
• Adonis - MySQL and PostgreSQL (with Lucid ORM and default .env)

Manual Configuration

If auto-discovery isn't available for your environment, you can use a manual configuration file.

Quick Start

1. Install DevDb Pro

Install from the VS Code Marketplace or Open VSX Registry.

2. Open Your Project

Open any project with a supported database configuration.

3. Access Your Database

Use any of these methods:

• Keyboard shortcut: Cmd+K Cmd+D (Mac) or Ctrl+K Ctrl+D (Windows/Linux) to toggle the DevDb panel
• Quick table access: Cmd+K Cmd+G (Mac) or Ctrl+K Ctrl+G (Windows/Linux) to open any table
• Command palette: Search for "DevDb" commands
• View menu: Open the DevDb view from the panel

Key Features at a Glance

UI Actions and Shortcuts

• Cmd+K+D / Ctrl+K+D - Toggle DevDb panel
• Cmd+K+G / Ctrl+K+G - Go to table (quick table access)
• Cmd+Click - Table name in sidebar to open in current tab
• Cmd+Click - Database value to edit it
• Click any value to preview it (useful for JSON strings)
• During edit: Cmd+Z to undo, Cmd+Y to redo, Cmd+S to save

One-Click Data Manipulation

• Click trash icon on a row to delete it
• Click Set null button to set a value to null
• Inline editing with real-time preview
• JSON preview for complex data structures

What's Next?

• Zero-Config Discovery - Learn how auto-discovery works
• Database Client - Explore the database client interface
• Laravel Integration - Laravel-specific features
• Configuration - Manual configuration when needed