FullStackHero.WebAPI.Boilerplate 1.0.0

This package has at least one vulnerability with moderate severity. It may lead to specific problems in your project. Try updating the package version.

Details

Advisory: https://github.com/advisories/GHSA-75x2-6h4m-h6mx

Severity: moderate

.NET CLI

dotnet new install FullStackHero.WebAPI.Boilerplate::1.0.0

This package contains a .NET Template Package you can call from the shell/command line.

What's fullstackhero's .NET Web API Boilerplate?

fullstackhero's .NET Web API Boilerplate is a starting point for your next .NET 7 Clean Architecture Project that incorporates the most essential packages and features your projects will ever need including out of the box Multi-Tenancy support. This project can save well over 200+ hours of development time for your team.

As the name suggests, this is an API / Server Boilerplate. You can find other Client Boilerplates that consume this API under @fullstackhero handle.

Find Blazor WebAssembly Boilerplate here - https://github.com/fullstackhero/blazor-wasm-boilerplate

Goals

The goal of this repository is to provide a complete and feature-rich starting point for any .NET Developer / Team to kick-start their next major project using .NET 7 Web API. This also serves the purpose of learning advanced concepts and implementations such as Multitenancy, CQRS, Onion Architecture, Clean Coding standards, Cloud Deployments with Terraform to AWS, Docker Concepts, CICD Pipelines & Workflows and so on.

Features

<details> <summary>Click to See More!</summary>

Documentation

Read Documentation related to this Boilerplate here - https://fullstackhero.net/dotnet-webapi-boilerplate/

Feel free to contribute to the Documentation Repository - https://github.com/fullstackhero/docs

Getting Started

To get started with this Boilerplate, here are the available options.

Install using the FSH CLI tool. Use this for release versions of the Boilerplate only.
Fork the Repository. Use this if you want to always keep your version of the Boilerplate up-to date with the latest changes.

Make sure that your DEV enviroment is setup, Read the Development Environment Guide

FSH CLI Tool

Prerequisites

Before creating your first fullstackhero solution, you should ensure that your local machine has:

.NET 7 You can find the download here.
NodeJS (16+) You can find the download here.

Installation

After you have installed .NET, you will need to install the fsh console tool.

dotnet tool install --global FSH.CLI
fsh install

This isntall the FSH CLI tools and the associated Templates. You are now ready to create your first FSH project!

FSH .NET WebAPI Boilerplate

Here's how you would create a Solution using the FSH .NET WebAPI Boilerplate.

Simply navigate to a new directory (wherever you want to place your new solution), and open up Command Prompt at the opened directory.

Run the following command. Note that, in this demonstration, I am naming my new solution as FSH.Starter.

fsh api new FSH.Starter

fsh api n FSH.Starter

This will create a new .NET 7 WEBAPI solution for you using the FSH Templates. For further steps and details, Read the Getting Started Guide

Update

To update the tool & templates, run the following commands

dotnet tool update FSH.CLI --global
fsh update

Forking the Repository

You would probably need to take this approach if you want to keep your source code upto date with the latest changes. To get started based on this repository, you need to get a copy locally. You have three options: fork, clone, or download.

Make a fork of this repository in your Github account.
Create your new dotnet-webapi-boilerplate personal project by cloning the forked repository on your personal github.
Setup an upstream remote on your personal project pointing to your forked repository using command git remote add upstream https://github.com/{githubuseraccount}/dotnet-webapi-boilerplate and git remote set-url --push upstream DISABLE

For step by step instructions, follow this and this.