Skip to main content
Version: Next 🚧

Development Setup

Note: This guide is under construction. For now, please refer to AGENTS.md for detailed setup information.

Prerequisites​

  • VS Code with Dev Container support
  • Docker installed and running
  • GitHub account (for Tibber API token)

Quick Setup​

# Clone the repository
git clone https://github.com/jpawlowski/hass.tibber_prices.git
cd hass.tibber_prices

# Open in VS Code
code .

# Reopen in DevContainer (VS Code will prompt)
# Or manually: Ctrl+Shift+P → "Dev Containers: Reopen in Container"

Development Environment​

The DevContainer includes:

  • Python (the version Home Assistant is built on, see .python-version) with .venv at /home/vscode/.venv/
  • uv package manager (fast, modern Python tooling)
  • Home Assistant development dependencies
  • Ruff linter/formatter
  • Git, GitHub CLI, Node.js, pyright, git-cliff, shellcheck, shfmt, yq

Tool Versions (mise)​

The development tools are managed by mise: their versions are pinned in mise.toml in the project root, and the same file is used in the DevContainer, in CI and locally. The Python version is the exception: it lives in .python-version, which ./scripts/setup/update-ha-version keeps at the version the configured Home Assistant release is built on.

  • Update a tool: change its version in mise.toml, then run mise install
  • Outside the DevContainer: install mise, then run mise install in the project root
  • Python packages (Home Assistant and its dependencies) are not managed by mise but by uv in ./scripts/setup/bootstrap

Running the Integration​

# Start Home Assistant in debug mode
./scripts/develop

Visit http://localhost:8123

Making Changes​

# Lint and format code
./scripts/lint

# Check-only (CI mode)
./scripts/lint-check

# Validate integration structure
./scripts/release/hassfest

See AGENTS.md for detailed patterns and conventions.