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 on Twitter: @xunit, @jamesnewkirk, @bradwilson, @onovotny
Discussions are held on Slack. Not a member yet? Sign up now!
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

Latest Builds

Core framework Visual Studio runner Analyzers Devices runner
Stable
Pre-Release (on NuGet)
CI Build (on MyGet)
For information about features and bug fixes, see the release notes.

Documentation

Getting Started

New to xUnit.net? These guides will help you get started. (If you're not sure which tutorial to use, start with the Desktop CLR tutorial.)

Configuration

Unit Test Parallelism

Other Topics

Frequently Asked Questions

Migration

Release Notes

VersionReleases
2.3 Beta 3 Beta 2 Beta 1
2.2 RTM Beta 4 Beta 3 Beta 2 Beta 1
2.1 RTM RC 2 RC 1 Beta 4 Beta 3 Beta 2 Beta 1
2.0.1 RTM RC 1
2.0 RTM RC 4 RC 3 RC 2 RC 1 Beta 5

Test Runner Compatibility

  xUnit.net xunit.console dotnet xunit 2 MSBuild TestDriven.NET Visual Studio 3 Devices
Desktop Class Library 1.9.2+ 4a 4a 4a 4a 4b (2012+)  
Portable Class Library 2.0+ 4a   4a 4a   4c
.NET Core
(Windows, Linux, OS X)
2.2+   4a 2,4a   4b (2017+)  
.NET Standard Class Library 1.1+ 2.2+ 4a   4a 4a   4c
Universal Windows Platform 2.1+         4b (2015+) 4c
Xamarin MonoAndroid 1 2.0+           4c
Xamarin iOS Unified 1 2.0+           4c
  ↓ The project types below have been officially deprecated ↓
Universal Application
(Windows 8.1, Windows Phone 8.1)
2.0 - 2.1         4b (2013+) 4c
Windows Phone 8 (Silverlight) 2.0 - 2.1           4c
Xamarin MonoTouch (iOS Classic) 1 2.0 - 2.1           4c
1 Requires Xamarin for Visual Studio or Xamarin Studio.
2 dotnet xunit and the .NET Core MSBuild runner only support xUnit.net v2.3 beta 2 and later.
3 Visual Studio support includes the VS UI, vstest.console.exe, and dotnet test. Express editions are not supported.
4 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.

Additional copyrights

Portions copyright The Legion Of The Bouncy Castle

Laptop stickers!

Show your love for xUnit.net with one of our two laptop stickers, available from Sticker Mule.

Copyright © 2017 .NET Foundation. Contributions welcomed at https://github.com/xunit/xunit.github.io.