# Xcelerate SDK for .NET
[](https://www.nuget.org/packages/Xcelerate)
[](https://opensource.org/licenses/MIT)
Xcelerate is a high-performance, lightweight Chrome DevTools Protocol (CDP) client tailored for the .NET ecosystem. Built on a performance-optimized Rust core, it provides an idiomatic C# wrapper that combines native speed with the safety and ease of use expected by .NET developers.
## Features
- **Managed Lifecycle**: Fully supports `IDisposable` patterns to ensure clean browser and process termination.
- **Async/Await First**: Standard `Task`-based asynchronous API for modern C# applications.
- **Advanced Stealth Support**: Built-in mechanisms to neutralize automation detection (masking WebDriver, mocking Chrome APIs).
- **NativeAOT Compatible**: Designed for high performance and low memory footprints.
- **Simplified Deployment**: Bundles the required native binaries for Windows (x64), removing the need for external C++ or Rust installations on the target machine.
## Installation
Install the package via the .NET CLI:
```powershell
dotnet add package Xcelerate
```
## Basic Usage
Xcelerate emphasizes a clean, readable API. The library handles port polling, browser initialization, and handshake recovery automatically.
```csharp
using Xcelerate;
// Launch a stealth-hardened browser instance with intelligent defaults
// (Optional: headless=true, stealth=true, detached=true)
using var browser = await Browser.Launch(new BrowserConfig());
// Initialize a new page and perform navigation
using var page = await browser.NewPage("https://www.example.com");
// Capture page metadata
string title = await page.Title();
Console.WriteLine($"Current title: {title}");
// Perform interactions
using var element = await page.WaitForSelector("button.primary");
await element.Click();
// Generate high-resolution full-page screenshots
byte[] screenshot = await page.ScreenshotFull();
File.WriteAllBytes("capture.png", screenshot);
```
## Advanced Configuration
The SDK supports specialized launch options for complex automation scenarios:
- **Stealth Mode**: Applies binary patches and runtime JavaScript masking to bypass bot detection.
- **Detached Mode**: Allows the browser process to persist independently of the parent .NET application.
- **Headless=New**: Utilizes the modern Chromium headless engine for improved rendering and compatibility.
## Compatibility
- **Frameworks**: .NET 6.0, .NET 7.0, .NET 8.0+
- **Platform**: Windows x64 (Automatic binary deployment via NuGet)
## License
This project is distributed under the MIT License.