MiniScaffold

What is MiniScaffold?

This is an F# Template for:

• creating and publishing libraries targeting .NET Full net461 and Core netstandard2.1
• creating and publishing applications targeting .NET Core netcoreapp3.1

Why use MiniScaffold?

This takes away the ambiguity that developers face when creating an OSS project. Such as:

• How do I structure my project?
• How do I create repeatable builds?
• Which test framework should I use?
• How to I create releases?
• What Issue/Pull Request templates should I use?
• How should I go about creating documentation?
• How do I setup CI?
• What's the standard .gitignore file?
• What other things would make it easier for me when starting off creating a project I might not even know about?

What does this include in the box?

All project types

• Standard project structure for your dotnet application
• Build Automation tool via FAKE
• Package management tool via Paket
• Unit Testing via Expecto
• Code Coverage via Altcover
  • Also builds an html report with ReportGenerator
• Code formatting style via Fantomas
• Release build step commits latest notes from RELEASE_NOTES.md in the body and creates a git tag.
  • If you reference a Pull Request in the RELEASE_NOTES.md it will update that Pull Request with the version it was released in.
• Release build step publishes a GitHub Release via the RELEASE_NOTES.md and adds any artifacts (nuget/zip/targz/etc).
• Continuous integration via AppVeyor (Windows) and TravisCI (Linux) or GitHub Actions

For Libraries

• Builds for both net461 and netstandard2.1 - Target Frameworks
  • To build for net461
    • On windows: Have at least .NET Framework 4.6.1 installed
    • On macOS/linux: Have mono installed
  • To build for netstandard2.1
    • Have .NET core 3.1 installed
• Sourcelink which enables a great source debugging experience for your users, by adding source control metadata to your built assets
• Documentation Generation - Generates Documentation from markdown files, fsx files, and the XML Documentation Comments from your library.
• Release build step pushes NuGet packages to NuGet
  • Generates Package Version from RELEASE_NOTES.md
  • Adds Package Release Notes metadata from RELEASE_NOTES.md

For Applications

• Basic argument parsing example via Argu
• Builds a netcoreapp3.1 application - Target Frameworks
  • To build for netcoreapp3.1
    • Have .NET core 3.1 installed
• Builds for win-x64, osx-x64 and linux-x64 - Runtime Identifiers. Bundles the application via dotnet-packaging
  • Bundles the win-x64 application in a .zip file.
  • Bundles the osx-x64 application in a .tar.gz file.
  • Bundles the linux-x64 application in a .tar.gz file.

Getting started quickly

Install the dotnet template from NuGet:

1: 

dotnet new -i "MiniScaffold::*"

I want to build a library

1: 

dotnet new mini-scaffold -n MyCoolNewLib --githubUsername MyGithubUsername

I want to build a console application

1: 

dotnet new mini-scaffold -n MyCoolNewApp --githubUsername MyGithubUsername -ou console