btcpayserver

Use when writing, reviewing, or improving pull request descriptions for BTCPayServer. Focuses on non-technical, user-centered descriptions and useful visual evidence.

Use when editing Razor views, view components, CSS, JavaScript DOM selectors, or Playwright tests that depend on frontend selectors. Prefer BEM class selectors over ids for reusable UI hooks.

Use when updating or reviewing Changelog.md in BTCPayServer. Contains release range, inclusion, style, and verification guidance.

Use when writing, refactoring, running, or debugging Playwright tests in BTCPayServer. Covers local test setup, PMO/Page Model Object usage, selector encapsulation, and avoiding over-engineering.

Use when editing or reviewing Razor `.cshtml` files containing parameterized localized strings. Choose StringLocalizer for plain text and safely encode ViewLocalizer parameters when localized strings contain HTML.

Use when adding or reviewing BTCPay Server startup configuration options. Covers command-line registration, defaults, environment variables, tests, and documentation.

Use when creating or reviewing Entity Framework migrations in BTCPayServer. Contains repository-specific migration generation and cleanup rules.

Guide an operator through planning, installing, verifying, reconfiguring, updating, migrating, restoring, or troubleshooting BTCPay Server on a VPS with the official Docker deployment. Use for operator-side VPS work, production deployment choices, domain and…

Prepare or update BTCPay Server Docker pull requests. Use when creating, opening, drafting, editing, or reviewing a PR in btcpayserver-docker, including gh pr create and gh pr edit requests.

Add or substantially change BTCPay Server Docker Compose generator fragments. Use for files under docker-compose-generator/docker-fragments, fragment dependencies or incompatibilities, new fragment images, and cryptocurrency fragment integration.

Maintain BTCPay Docker's Nginx route catalog and fragment metadata. Use when adding or changing nginx/routes/*.conf, required-routes, optional-routes, Generated/manifest.json, or btcpay-routes.

Update Docker image versions in dockerfile-deps. Use when adding or bumping an image, Dockerfile dependency, version, or revision and opening an update/<image>/<version> PR that must pass Build Only CI.