Get started with .NET in 10 minutes

Not ready to install anything? Try our in-browser tutorial.

  1. Install .NET SDK

    To start building .NET apps you just need to download and install the .NET SDK (Software Development Kit) for macOS.

    Download .NET SDK

    If you have any problems with installation on macOS, please consult our release notes.

    A video frame showing a macOS command prompt. Select this image to start playing the video.

    Video: Creating a Simple .NET Application on macOS

  2. Create your app

    Open a new command prompt and run the following commands.

    dotnet new console -o myApp
    cd myApp

    The dotnet command will create a new application of type console for you. The -o parameter will create a directory named myApp where your app will be stored, and populates it with the required files. The cd myApp command puts you into the newly created app directory.

    The main file in the myApp folder is Program.cs. By default, it already contains the necessary code to write "Hello World!" to the Console.

    using System;
    namespace myApp
        class Program
            static void Main(string[] args)
                Console.WriteLine("Hello World!");
  3. Run your app

    In your command prompt, run the following command:

    dotnet run

    Congratulations, you've built and run your first .NET app!

  4. Get an editor

    Visual Studio for Mac is a fully-featured integrated development environment (IDE) for developing .NET apps on macOS.

    Download Visual Studio for Mac

    There are also third party tools for developing .NET apps. JetBrains Rider is a cross-platform .NET IDE built using IntelliJ and ReSharper technology.

  5. Keep learning

    Now that you've got the basics, you can keep learning with the .NET Quick Starts. In the first Quick Start you'll learn about collections.

    Quick start: Collections