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

Optonal:

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": "support@dotnet.express",
    "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. Bower Components

This template packaged with all bower scripts from bower.json and saved in \wwwroot\bower_components folder.

If you have installed and configured Bower, you can install/update bower components from bower.json:

bower install

** If you use Windows and Visual Studio 2017 with internal Node.js and Bower support, you can use bower.cmd from Visual Studio external folder. For Visual Studio 2017 Community Edition use:

"C:\Program Files (x86)\Microsoft Visual Studio\2017\Community\Web\External\bower.cmd" install --force-latest

For installing Bower you need node, npm and run command:

npm install -g bower

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.

richsch / AdminLTE-Starter-Kit