v1.0.0 - Initial Release

Backline v1.0.0 - Initial Release

Runtime behavior diffing for pull requests. Deploy your PR and base branch, run the same checks against both, and see what actually changed at runtime.

Installation

npm install -g @backlinedev/backline

Or use as GitHub Action - no installation needed!

Features

Core Functionality

• Framework Detection: Auto-detects Next.js, Express, FastAPI, Rails, and CLI tools
• Four Probe Types: API (HTTP), CLI (commands), GraphQL (queries), Database (SQL)
• Docker Compose Support: Isolated deployments via git worktrees
• Visual Diffs: Side-by-side comparison with syntax highlighting
• Secret Scrubbing: Automatic redaction of API keys, tokens, and credentials

Developer Experience

• backline init: Interactive setup with framework detection
• OpenAPI Integration: Generate probes from Swagger/OpenAPI specs
• Enhanced CLI: init, test, validate, generate commands
• Zero Infrastructure: No hosted service, no vendor account required

Quality

• 167 tests passing
• 75%+ code coverage
• TypeScript strict mode
• Production-ready

Documentation

• npm: https://www.npmjs.com/package/@backlinedev/backline
• Quick Start: https://github.com/backlinedev/backline#quick-start
• Full Docs: https://github.com/backlinedev/backline/tree/main/docs
• Examples: https://github.com/backlinedev/backline/tree/main/examples

Quick Start

# .backline.yml
version: 1

target:
  base_url: "http://localhost:3000"
  wait_for:
    path: /health
    timeout_seconds: 30
  adapter: compose

probes:
  - type: api
    name: "User API"
    requests:
      - method: GET
        path: /api/users
    diff:
      against: base_branch
      ignore_fields:
        - "*.timestamp"
        - "*.id"

Contributing

Found a bug or have a feature request? Open an issue!

License

MIT