SDK

https://github.com/maestrano/maestrano-dotnet

Demo

Source: https://github.com/maestrano/demoapp-dotnet
Packaging Platform (NuGet): http://www.nuget.org/packages/Maestrano

Development setup

.NET Development requires you to have Windows, Visual Studio and Github setup on your computer. This document explains how to do all of that.

1 - Windows Installation

If you are working on Linux or on a Mac, the best way is to install Windows is via VirtualBox.

Go to https://www.virtualbox.org/wiki/Downloads then download and install
Download a Windows 8 virtual machine here: https://www.modern.ie/en-gb/virtualization-tools
Install the VM - Check everything works

ProTip

You should also install Chrome or FF - will be convenient for browsing the .NET docs while developing within your VM

2 - Github Setup on Windows

For that, we're going to use the github windows client.

Start your Windows VM if using one
Download the Github Windows client from your VM from here: https://windows.github.com/
Follow the instructions - The setup of the SSH keys should be really straightforward
Checkout: https://github.com/<github-username>/maestrano-dotnet
Checkout: https://github.com/<github-username>/demoapp-dotnet

3 - Setup Visual Studio on Windows

For the development of the .NET SDK you will need to setup Visual Studio Express for Desktop. For maintaining the .NET demo application, you will need to setup Visual Studio Express for Web.

3.1 - Visual Studio Installations

Go here: http://www.visualstudio.com/en-us/products/visual-studio-express-vs.aspx
Download Express 2013 for Web and install
Download Express 2013 for Desktop and install

Microsoft Account

During the install, you may be requested to create a Microsoft account. This should give you a 30 day free trial of Visual Studio Express. After this period, you should be able to permanently extend this free trial period.

3.2 - Maestrano SDK Setup in VS

Open Visual Studio Express for Desktop (type "VS Express" in search bar)
Click on File > Open Project (or File > Recent Projects and Solutions if you have already opened it before)
Open <maestrano-dotnet-github-dir>/src/Maestrano.SLN (VS Solution file)

.NET 4.5 and .NET 4 assemblies

Warning! The main solution file is configured to build the project using .NET 4.5 (most widely adopted version) but Maestrano also supports .NET4

If you are compiling the library with the view to package it and push it to NuGet (online package manager) then you MUST also open the Maestrano.Net40.SLN Solution file and compile the project again.

The .NET45 version binary will be dropped in: <project-folder>\bin\Release\net45

The .NET40 binary will be dropped in: <project-folder>\bin\Release\net40

Note: there are ways to compile both in one go but it's really annoying to setup...

3.3 - Maestrano Demo Application Setup in VS

Open Visual Studio Express for Web (type "VS Express" in search bar)
Click on File > Open Project (or File > Recent Projects and Solutions if you have already opened it before)
Open <maestrano-dotnet-github-dir>/src/MnoDemoApp.SLN (VS Solution file)
You can click on the Play icon at the top to launch the web application and open it in the default browser