AdminLTE Starter Kit for ASP.NET Core

AdminLTE Starter Kit is a boilerplate projects for ASP.NET Core Web Applications with a modern UI (based on AdminLTE by Abdullah Almasaeed).

1. Getting Started

This template is open-source part of .NET Express Project. You can find samples, documentation and getting started instructions for .NET Express Project at the Templates Documentation.

These instructions will get you a copy of the project up and running on your local machine for development and testing purposes. See installing, configuration and deploy for notes on how to run the project on a live system.

2. Prerequisites

What things you need to install the software and how to install them

• Visual Studio 2017+ / Visual Studio Code
• .NET Core SDK 2.2+

3. Installing

3.1. Installing from .NET Core CLI

You can install the dotnet new templates from NuGet.org by running the following command:

dotnet new -i "Dynamic.NET.AdminLTE.ProjectTemplates"

Once installed your will have to new templates available to create AdminLTE MVC bootstrap web application.

dotnet new mvc-adminlte [options]

This will create a new web application in the current folder.

3.2. Installing from GitHub repository

You can clone source directly from GitHub

git clone https://github.com/dotnet-express/AdminLTE-Starter-Kit.git

4. Templates Settings

All configuration settings contains in appsettings.json.

4.1. Database Connection

"ConnectionStrings": {
    "DefaultConnection": "Server=(localdb)\\mssqllocaldb;Database=aspnet-Company.WebApplication1-53bc9b9d-9d6a-45d4-8429-2a2761773502;Trusted_Connection=True;MultipleActiveResultSets=true"
  },

4.2. Application Settings

All application configuration settings in appsettings.json

  "Email": {
    "EmailProvider": "", // Examples: "", "SendGrid"
    "SupportTeamEmail": "[email protected]",
    "SupportTeamName": ".NET Express - Support Team",
    "SendGrid": {
      "KeyName": "{KEY NAME}",
      "ApiKey": "{API KEY}"
    }
  },

  "Authentication": {
    "Facebook": {
      "IsEnabled": "true",
      "AppId": "{APP ID}",
      "AppSecret": "{SECRET KEY}"
    },
    "Google": {
      "IsEnabled": "false",
      "ClientId": "{CLIENT ID}",
      "ClientSecret": "{SECRET KEY}"
    }

5. Bundling and Minification

For bundling and minification files from bundleconfig.json, used BuildBundlerMinifier from NuGet. This template include "BuildBundlerMinifier 2.8.391"

After building, you must see this lines in build output:

  Bundler: Begin processing bundleconfig.json
  Bundler: Done processing bundleconfig.json

Detailed documentation you find in Bundle and minifiy static assets in ASP.NET Core.

6. Library Manager

This solution use Visual Studio Library Manager with config in libman.json and save all external libraries in \wwwroot\libs folder.

Client-side library acquisition in ASP.NET Core with LibMan

For Visual Studio:

Use LibMan with ASP.NET Core in Visual Studio

For Visual Studio Code/CLI:

Use the LibMan command-line interface (CLI) with ASP.NET Core

Contributing

Please read CONTRIBUTING.md for details on our code of conduct, and the process for submitting pull requests to us.

Versioning

We use Semantic Versioning 2.0 for versioning. For the versions available, see the releases on this repository.

Authors

• Leonid Shishkin - Initial work
• .Net Express Team - Support and development

See also the list of contributors who participated in this project.

License

This project is licensed under the MIT License - see the LICENSE file for details

Acknowledgments

• Abdullah Almasaeed for great AdminLTE Template project.