README.md

July 31, 2026 · View on GitHub

A pre-configured development environment that includes all tools, extensions, and dependencies needed for HVE Core development. Ensures consistency across all development machines.

Prerequisites

Quick Start

  1. Clone the repository:

    git clone https://github.com/microsoft/hve-core.git
cd hve-core

  2. Open in VS Code:

    code .

  3. Reopen in container:

    • Press F1 or Ctrl+Shift+P
    • Select Dev Containers: Reopen in Container
    • Wait for the container to build (first time takes 5-10 minutes)

If your network blocks public package registries, the container build fails to install dependencies. Add the registry override to the user-level dev.containers.containerEnv VS Code setting rather than to devcontainer.json, so the repository stays unchanged. See Install behind a restricted network.

Included Tools

Languages & Runtimes

  • Node.js 24
  • Python 3.11
  • PowerShell 7.x

CLI Tools

  • Git
  • GitHub CLI (gh)
  • Azure CLI (az)
  • actionlint (GitHub Actions workflow linter)

Code Quality

  • Markdown: markdownlint, markdown-table-formatter
  • Spelling: Code Spell Checker (VS Code extension)
  • Shell: shellcheck

Security

  • Gitleaks (secret scanning)
  • osv-scanner (dependency vulnerability scanning)

PowerShell Modules

  • PSScriptAnalyzer
  • PowerShell-Yaml
  • Pester 5.7.1

Pre-installed VS Code Extensions

  • Spell Checking: Street Side Software Spell Checker
  • Markdown: markdownlint, Markdown All in One, Mermaid support
  • GitHub: GitHub Pull Requests

Common Commands

Run these commands inside the container:

# Lint Markdown files
markdownlint '**/*.md' --ignore node_modules

# Check spelling
cspell '**/*.md'

# Check shell scripts
shellcheck scripts/**/*.sh

# Security scan
gitleaks detect --source . --verbose

Troubleshooting

Container won't build: Ensure Docker Desktop is running and you have sufficient disk space (5GB+).

Extensions not loading: Reload the window (F1 → Developer: Reload Window).

For more help, see SUPPORT.md.

🤖 Crafted with precision by ✨Copilot following brilliant human instruction, then carefully refined by our team of discerning human reviewers.