About xUnit.net

xUnit.net is a free, open source, community-focused unit testing tool for the .NET Framework. Written by the original inventor of NUnit v2, xUnit.net is the latest technology for unit testing C#, F#, VB.NET and other .NET languages. xUnit.net works with ReSharper, CodeRush, TestDriven.NET and Xamarin. It is part of the .NET Foundation, and operates under their code of conduct. It is licensed under Apache 2 (an OSI approved license).

Follow: xUnit.net on Mastodon, James Newkirk, Brad Wilson, Claire Novotny
Discussions are held on our discussions site.
Resharper support is provided and supported by JetBrains.
CodeRush support is provided and supported by DevExpress.
NCrunch support is provided and supported by Remco Software.
The xUnit.net logo was designed by Nathan Young.

Table of Contents

Current Releases

Stable Latest CI Build status
v2 core framework
v3 core framework (alpha docs) N/A
xunit.analyzers
xunit.runner.visualstudio

Latest Stable Release Notes

v2 core framework 2.8.1 (all releases)
xunit.analyzers 1.14.0 (all releases)
xunit.runner.visualstudio 2.8.1 (all releases)

Documentation

Getting Started

New to xUnit.net? These guides will help you get started.

Configuration

Unit Test Parallelism

Other Topics

Frequently Asked Questions

Migration

Test Runner Compatibility

  xUnit.net xunit.console MSBuild TestDriven.NET Visual Studio 2 Devices
.NET Framework
(Windows)
1.9.2+ 3a 3a 3a 3b  
.NET Core & .NET 5+
(Windows, Linux, macOS)
2.2+       3b  
  ↓ The project types below have been officially deprecated ↓
Universal Application
(Windows 8.1, Windows Phone 8.1)
2.0 - 2.1       3b 3c
Universal Windows Platform 2.1 - 2.4.2       3b 3c
Windows Phone 8 (Silverlight) 2.0 - 2.1         3c
Xamarin iOS Unified 1 2.0 - 2.4.2         3c
Xamarin MonoAndroid 1 2.0 - 2.4.2         3c
Xamarin MonoTouch (iOS Classic) 1 2.0 - 2.1         3c
  1. Requires Xamarin for Visual Studio or Xamarin Studio.
  2. Visual Studio support includes the Visual Studio Test Explorer, Visual Studio Code, vstest.console.exe,
    and dotnet test. Express editions of Visual Studio are not supported.
  3. Test runner source code availability:
    a. https://github.com/xunit/xunit
    b. https://github.com/xunit/visualstudio.xunit
    c. https://github.com/xunit/devices.xunit

Github Projects

For information on contributing to xUnit.net, please read the governance document.

Sponsors

Special thanks to the .NET on AWS Open Source Software Fund for sponsoring the ongoing development of xUnit.net.

Help support this project by becoming a sponsor through GitHub Sponsors.

Additional copyrights

Portions copyright The Legion Of The Bouncy Castle

Copyright © .NET Foundation. Contributions welcomed at https://github.com/xunit/xunit/tree/gh-pages.