fsharp-dnx-templates

Visual Studio templates for creating DNX projects with F#.

Getting started

Right now we have the following templates:

• Class library
• Console app
• Empty web app

The installation approach is identical for each template.

• The content template (e.g. FSharpConsoleApp) goes into ..\Microsoft Visual Studio 14.0\Common7\IDE\AspNetProjectTemplates\1033\
• The DNX template (e.g. FSharpDNXConsoleApp) goes into ..\Microsoft Visual Studio 14.0\Common7\IDE\ProjectTemplates\FSharp\1033

To get Visual Studio to register the templates, you can run devenv.exe /installvstemplates. (devenv.exe is in the ..\Microsoft Visual Studio 14.0\Common7\IDE\ folder.)

FAQ

Where can I find the FSharp.Dnx dependency?

The FSharp.Dnx dependency can be found in the fsprojects NuGet feed: https://www.myget.org/F/fsprojects/api/v3/index.json You can include it in your NuGet.Config file:

<?xml version="1.0" encoding="utf-8"?>
<configuration>
  <packageSources>
    <!--To inherit the global NuGet package sources remove the <clear/> line below -->
    <clear />
    <add key="fsprojects" value="https://www.myget.org/F/fsprojects/api/v3/index.json" />
    <add key="api.nuget.org" value="https://api.nuget.org/v3/index.json" />
  </packageSources>
</configuration>

If you don't have a NuGet.config file, create it yourself in the solution root. You can then add it to Visual Studio by right-clicking the solution node in the Solution Explorer and adding an existing item.

Why does an EmptyWeb application return 500 Internal Server Error when running it? I haven't changed a thing!

Because you need a newer version of Microsoft.AspNet.IISPlatformHandler which you can get by adding the ASP.NET "dev" build NuGet feed to your NuGet.Config.

Why is the Program type a class with a Main method and not a simple F# function like the standard F# Console Application template?

When DNX loads, it looks for a class called Program with a method called Main. You can do

namespace ConsoleApplication1

type Program () =
    member x.Main (argv: string array) =
        printfn "%A" argv
        0

but you can also do

module MyModule

type Program () =
    member x.Main (argv: string array) =
        printfn "%A" argv
        0

or

module Program

let Main (argv: string array) =
    printfn "%A" argv
    0

If you choose to use a Program class, you can do dependency injection, e.g. inject an IApplicationEnvironment.

Maintainer(s)

• @jbfp

The default maintainer account for projects under "fsprojects" is @fsprojectsgit - F# Community Project Incubation Space (repo management)