DockBricks

DockBricks is a desktop app for creating and managing local container-backed databases. It supports both Docker and Podman with a clean, native-feeling Tauri UI.

Highlights

• PostgreSQL, MySQL, MariaDB, and Redis presets
• Right-click context menu (copy connection string, edit, delete)
• Start/stop lifecycle control per database
• Docker and Podman engine support with onboarding + settings switcher
• Docker/Podman install and runtime checks
• Host port availability checks before container creation
• Service icons for quick database identification
• Delete flow that removes both local record and container
• Manual runtime retry flow (no aggressive background polling)

Tech Stack

• Tauri v2 (Rust backend)
• React + TypeScript + Vite
• Tailwind CSS + shadcn/ui

Requirements

• Node.js 20+
• Rust stable toolchain
• One container engine:
  • Docker Desktop / Docker Engine, or
  • Podman 5+

For Podman on macOS/Windows, make sure the machine is initialized and running:

podman machine init
podman machine start

Quick Start

npm install
npm run tauri:dev

On first launch, choose Docker or Podman in onboarding.

Development Scripts

• npm run dev: frontend only (Vite)
• npm run build: TypeScript + production frontend bundle
• npm run tauri:dev: run desktop app in development
• npm run tauri:build: build desktop release artifacts locally

Validation

npm run typecheck
npm run build
npm run test:rust
npm run check:rust

Local Data And Passwords

DockBricks is a local-first desktop app. Database metadata is stored on your machine, including the database password used to create connection strings and container environment variables. Treat your local user account and app data directory as sensitive.

DockBricks does not send database names, passwords, ports, or connection strings to a hosted backend.

Release and Signing

GitHub Actions builds all desktop targets on version tags (v*) and creates a draft release:

• CI: .github/workflows/ci.yml
• Release: .github/workflows/release.yml

Release builds currently ship for macOS only. You do not need to build releases locally on your Mac to publish. For the best macOS user experience, configure Apple signing/notarization secrets (see docs/releasing.md).

Documentation

• Contributing guide
• Architecture notes
• Release guide
• Security policy
• Code of conduct

License

MIT, see LICENSE.