The Saturn App Template is best developed with Visual Studio Code or Visual Studio 2019 (Community works).
More about Saturn
This is for pure F# web applications and should be preferred over the original web app template.
Here is a list of the possible target frameworks. https://docs.microsoft.com/en-us/dotnet/standard/frameworks
- Example CAS setup
- Examples of an access restricted application using two routes
- Logged In View
- Default View
- Examples cookies setup where you can plug in EDS requests to get membership and other user details
How to get me running
Make sure you have .NET Core 3.1 SDK installed
- Clone me
- Add a hostname
- Add an environment variable. This will tell ASP.NET Core that you want to use Development settings
- key: ASPNETCORE_ENVIRONMENT
- value: Development
- Copy appsettings.json and rename it to appsettings.Development.json
- DO NOT PUT SENSITIVE SECRET SETTINGS IN appsettings.json. ONLY PUT SETTINGS IN appsettings.Development.json. NEVER COMMIT appsettings.Development.json
- You do not need to change the settings to get the app to run. Only do this when you use the temaple to build a real application.
- Install paket
dotnet tool install paket
dotnet tool restore
- Install fake
dotnet tool install fake-cli
dotnet tool restore
- Run the build and launch the app
cmdgo to the root of the application.
dotnet fake build target Run
- The app should launch in a browser
See the paket.dependencies file for all testing libraries
- TickSpec for BDD https://github.com/fsprojects/TickSpec
- Canopy for UI tests https://lefthandedgoat.github.io/canopy/
How to host development on IIS
By default this template will run as self-hosted using Kestrel, but you can host on IIS too.
- Add a site to IIS and point it to the WebHost folder
- Configure the bindings to whatever port you want to run it on. The template uses 8085.
- Configure the Application Pool to use No Managed Code
- Configure the web.config file
- Make sure processPath points to where the executable is stored when the project is built. This is template puts it here: .\bin\Debug\net461\Template.Saturn.WebHost.exe
You can also host on IIS as a published site
The above steps will get you there but instead of pointing to the WebHost folder, use Visual Studio or
dotnet publish to create a published site and use that in IIS. You may need to copy over the web.config file manually. I don't know why.
Deploying to Azure
I might be running on Azure
You can login with your Net ID.