RoverCore.Template 1.4.1

RoverCore

RoverCore is an easy-to-use, efficient, and simple ASP.NET 6 boilerplate. A boilerplate is essentially a template, with lots of tools and key parts that a developer may need for their project. RoverCore is organized as an n-Tiered Architecture and borrows ideas from Clean Architecture. RoverCore provides a solid boilerplate that provides you with a lot of the functionality you will need for smaller projects.

RoverCore Documentation

This is a big step up from the default ASP.NET MVC template, and provides a starting point where you can implement the functionality you want within the system. As you learn how to use the framework you will become well-versed in how to develop ASP.NET applications and can begin the process of developing your own architecture ideas.

Why RoverCore?

RoverCore was designed to be a starting project that can be used both by professionals and individuals learning how to develop ASP.NET 6 applications. The project contains work by students and was designed originally for educational purposes. Don't let that scare you off, as the intention for this project is to be production-ready.

Project Features:

• 100% open-sourced (almost exclusively MIT-compatible)
• Beautiful UI based off the Tabler Theme (includes dark mode!)
• Front and backend design ready to go out of the box
• Serilog error logging
• Simple Navigation Navbar management using roles
• Automatic Seeder discovery for default users, roles, and other data
• Visual studio template scaffolds to match the built-in theme
• ASP.NET 6 Identity
• User and Role Management
• JWT authorization for API endpoints

Prerequisites

• Visual Studio 2022 with ASP.NET and web development workload

• Latest .NET 6 SDK

• Install the latest .NET & EF CLI Tools by using this command :

  dotnet tool install --global dotnet-ef
  

• Git Client

  • GitHub Desktop
  • Axosoft's GitKraken
  • Tower

Installation

Get the newest RoverCore template on nuget.org.

dotnet new --install RoverCore.Template

Setup

To create a new project create a directory and open a command line console (cmd). Change the directory to your working folder with the following command (assuming your working folder is c:\users\username\documents\)

cd c:\users\username\documents\

Then to create your project, type in the following command to generate a brand new solution with a name of your choosing. For this example I am using the name RoverDemo.

dotnet new rovercore -o RoverDemo

Give it a few moments. A new folder called RoverDemo will be created for you at c:\users\username\documents\roverdemo\

Try it out!

The RoverDemo folder that was created will have all of the files and folders you will need to run your own starter project.

Here's what you need to get your project running:

• Open the Solution in Visual Studio 2022
• Initialize the SQL Server Express LocalDB
  • In Visual Studio, go to View > Other Windows > Package Manager Console
  • In the console that appears at the bottom, type the command Update-Database and wait for the migration to finish.
• Run the project
  • Press Control + F5 to run the project without the debugger, or F5 to run the project with the debugger attached.
• Seed Data
  • When running the project for the first time, the database will be seeded with an admin user.
  • You can log in to this account with the username admin and the password Password123!. It is highly recommended that you change this password after logging in for the first time.