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, @citizenmatt, @onovotny
Discussions are held on Slack. Not a member yet? Sign up now!
Continuous integration builds are available online via TeamCity (sponsored by CenturyLink Cloud).
CodeRush Test Runner support is provided by DevExpress.
The xUnit.net logo was designed by Nathan Young.

Table of Contents


Getting Started

Frequently Asked Questions


Release Notes



More »

Test Runner Compatibility

  xUnit.net Console MSBuild TestDriven.NET Visual Studio 2 Resharper Devices
Desktop Class Library 1.9.2+ 3a 3a 3a 3b (2012+) 3c  
Portable Class Library 2.0+ 3a 3a 3a 3b (2012+) 3c 3d
.NET CLI and .NET Core
(Windows, Linux, OS X)
2.2 beta 2+ 3e     3e (2015+)    
Universal Windows
(Windows 10, Windows 10 Mobile)
2.1+       3b (2015+)   3d
Universal Application
(Windows 8.1, Windows Phone 8.1)
2.0+       3b (2013+)   3d
Windows Phone 8 (Silverlight) 2.0+           3d
Xamarin MonoAndroid 1 2.0+           3d
Xamarin MonoTouch (iOS Classic) 1 2.0+           3d
Xamarin iOS Unified 1 2.0+           3d
Note: A GUI runner ships with xUnit.net 1.9.2, but is no longer supported.
1 Requires Xamarin for Visual Studio or Xamarin Studio
2 Visual Studio support requires Visual Studio Community, or a paid-for version of Visual Studio (Expression editions 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/resharper-xunit
    d https://github.com/xunit/devices.xunit
    e https://github.com/xunit/dotnet-test-xunit

Github Projects

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

Additional copyrights

Portions copyright Jérémie "Garuma" Laval.
Portions copyright Novell, Inc.
Portions copyright .NET Foundation
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 © 2016 .NET Foundation. Contributions welcomed at https://github.com/xunit/xunit.github.io.