# Capybara::Lightpanda [](https://rubygems.org/gems/capybara-lightpanda) [](https://rubygems.org/gems/capybara-lightpanda) [](https://github.com/navidemad/capybara-lightpanda/actions/workflows/ci.yml) [](https://rubyonrails.org/) [](https://turbo.hotwired.dev/) A [Capybara](https://github.com/teamcapybara/capybara) driver for [Lightpanda](https://lightpanda.io/), the fast headless browser built in Zig.
Self-contained — built-in CDP client, no external browser-client gem required. Capybara  →  capybara-lightpanda  →    [](https://navidemad.github.io/capybara-lightpanda/) _{Configuration · dual-driver setups · Turbo Rails · capability matrix · beta-testing guide} [](https://navidemad.github.io/capybara-lightpanda/)

Install

Add this to your Gemfile and run bundle install:

group :test do
  gem "capybara-lightpanda"
end

In your test setup:

require "capybara-lightpanda"
Capybara.javascript_driver = :lightpanda

[!TIP] The Lightpanda binary is auto-downloaded on first use — no separate install step needed.

Credits

• Lightpanda — the headless browser
• Capybara — the test framework
• Inspired by the Cuprite / Ferrum architecture and lightpanda-ruby

Patterns adapted from these MIT-licensed projects (cookies API, frame switching, node call/error conventions, retry/event utilities) are acknowledged with the original copyright notices in NOTICE.md.

Contributing

Bug reports and pull requests are welcome on GitHub.
For beta-testing tips and how to file useful feedback, see BETA_TESTING.md.

License

MIT License