Airframe
www.webkom.co Twitter

"Airframe Admin" (MVC.Net)

Thank you for purchasing my theme. If you have any questions that are beyond the scope of this help file, please feel free to email via: tomasz.owczarczyk@me.com. Thanks so much!

"Airframe Admin" - MVC.Net Version Details

This Airframe project is a standard .NET Core 3 MVC project with jQuery and modified Bootstrap 4 attached. All of the assets are handled by Gulp.

Initial Configuration

You need to have NodeJs (>= 10.0.0) and .NET Core 2.2 installed on your local machine, before attempting to run a development environment.

  1. Extract contents of the package to your local machine.

  2. Using the Terminal navigate to the extracted contents.

  3. Run npm install.

Make sure you have a file called .npmrc in the extracted directory. Those files are typically hidden in Unix based systems.

Development

To start the development environment type npm start in the console. This will start .NET Core development server.

Production

To build a production ready version you need to call from the terminal this command:

gulp build && dotnet publish "./netmvc-dashboards.csproj" -c Release

After the build completes the ready to deploy app will be available at ./bin/Release/netcoreapp2.2/.

On the server you should launch the application using the .NET Core 2.2 runtime.

Build Customization

You can adjust the build details for your own need by modifying the gulpfile.js file. This file contains the gulp configuration which is used to build static assets. Check the Gulp documentation for more details.

Project Details

This is a standrad .NET Core application, you should be able to use it swiftly if you have minimal experience witn .NET MVC. Some points of interests:

  • Assets - styles, images etc. handled by gulp

  • Controllers - controller logic here

  • Models - data models here

  • Views - HTML files bound to controllers

  • Views/Shared - Shared Views: Layouts, Includes etc.

  • wwwroot - processed assets by gulp, this directory should be clear and all of the Assets should be processed by gulp

HTML Content Guide

This Dashboard uses mainly styled Bootstrap 4 components, but has some additional classes and JS components to achieve the final effect.

Layout

This component will keep the whole layout in place it should look like this.

<div class="layout layout--theme--light--primary">
    <div class="layout__sidebar">
    <!-- Optional element: Airframe Sidebar should be placed here -->
    </div>
    <div class="layout__wrap">
        <div class="layout__navbar">
        <!-- Bootstrap Navbars should be placed here, they can be stacked on on another -->
        </div>
        <div class="container>
        <!-- Page Content should be placed here
        </div>
    </div>
</div>

The layout component also supports theming you can add a specific class related to a particular theme which will add a color scheme to the whole layout (mainly sidebar and targeted navbars). Classes which are providing this feature have this format: layout--theme--<theme style>--<theme color>. Here are the possible values for theme-style and theme-color:

theme-style

  • light

  • dark

  • color

theme-color

  • primary

  • success

  • info

  • warning

  • danger

  • indigo

  • purple

  • pink

  • yellow

Sidebar

Sidebar can contain a navigation menu and addtional information. Everything is organized in sections. It can be in a Slim state on larger displays, and collapsible on small screens. Example Sidebar:

<div class="sidebar sidebar--animations--enabled">
    <!-- This element will be displayed only on mobile and will collapse the sidebar when closed -->
    <div class="sidebar__close">
        <a href="javascript:;" class="action--sidebar-trigger">
            <i class="fa fa-times-circle fa-fw"></i>
        </a>
    </div>

    <!-- Sidebar contents are organized in sidebar__section elements -->
    <div class="sidebar__section sidebar__hide-slim">
        <!-- Some non-scrollable content, visible only on non slim sidebar -->
    </div>

    <!-- This wrap will allow scrolling all of the sections inside on Mobile Screens -->
    <div class="sidebar__mobile-fluid">
        <!--
            A fluid section will fill all of the available height in the sidebar,
            cover section will fill all of the available space inside. This combination
            is mainly designed to place SidebarMenu component inside.
        -->
        <div class="sidebar__section sidebar__section--fluid sidebar__section--cover">
            <!-- Sidebar Menu should be placed here -->
        </div>

        <!--
            This section will be at the bottom of the sidebar because
            of the fluid section defined above
        --> 
        <div class="sidebar__section">
            <!-- Sidebar Bottom content -->
        </div>
    </div>
</div>

Notable classes

  • sidebar--animations--enabled - will make the sidebar animated in most of the interactions

  • sidebar--slim - will allow the sidebar to be slim when collapsed on desktop

  • sidebar--collapse - will hide the sidebar, or make it slim if defined so

  • sidebar__mobile-fluid - all of the contents of that element will be scrollable on mobile sidebar

  • sidebar__section - building block of the sidebar

  • sidebar__section--fluid - section which will fill all available height of the sidebar

  • sidebar__section--cover - removes the section padding

  • sidebar__hide-slim - (helper) hides an element when the sidebar goes into slim mode

  • sidebar__show-slim - (helper) shows an element when the sidebar goes into slim mode

Sidebar Menu

Provides navigation for the sidebar. Allows for multilevel nesting, may be in a slim form with dropdowns. Has to be placed in a fluid, covered section. Example Sidebar Menu:

<ul class="sidebar-menu">
    <!-- A single link without any nesting -->
    <li class="sidebar-menu__entry">
        <!-- Link to the target page -->
        <a href="/some-page" class="sidebar-menu__entry__link">
            <!-- Icon representing the link -->
            <i class="fa fa-fw fa-th sidebar-menu__entry__icon"></i>
            <!-- Content of the link -->
            <span>Some Page</span>
        </a>
    </li>

    <!-- Container which will have nested entries inside -->
    <li class="sidebar-menu__entry sidebar-menu__entry--nested">
        <!-- Trigger which will expand the child entries on clicking -->
        <a href="javascript:;" class="sidebar-menu__entry__link">
            <!-- Icon representing the trigger -->
            <i class="fa fa-fw fa-home sidebar-menu__entry__icon"></i>
            <!-- Content of the trigger -->
            <span>Dashboards</span>
        </a>

        <!-- Contains the child entries -->
        <ul class="sidebar-submenu">
            <!-- First Child Entry -->
            <li class="sidebar-submenu__entry">
                <a class="sidebar-submenu__entry__link" href="/nested-page-1">
                    <span>First Nested Page</span>
                </a>
            </li>
            <!-- Second Child Entry -->
            <li class="sidebar-submenu__entry">
                <a class="sidebar-submenu__entry__link" href="/nested-page-2">
                    <span>Second Nested Page</span>
                </a>
            </li>
        </ul>
    </li>
</ul>

  • sidebar-menu - parent of the menu

  • sidebar-menu--slim - should be present when the sidebar is in slim collapsed mode

  • sidebar-menu__entry - contains the 0 level link

  • sidebar-menu__entry--nested - contains the 0 level nested links

  • sidebar-menu__entry--no-caret - removes the caret which is added by nested entries

  • sidebar-menu__link - level 0 link

  • sidebar-menuentryicon - icon representing a particular entry

  • sidebar-submenu - contains the nested entries

  • sidebar-submenu__entry - contains the nth level link

  • sidebar-submenu__entry--nested - contains the nth level nested links

  • sidebar-submenuentrylink - nth level link

Navbars

Navbars are essentially Bootstraps navbars, but there are some additional classes which extend their behavior.

  • navbar-themed - will receive the theme colors from the layout theme class

  • navbar-shadow - will add a shadow at the bottom of the navbar

  • navbar-multi-collapse - allows to make the navbar collapse, not collapse all of the items, the underling container should also have navbar-collapse-wrap class

Additional Helpers

  • sidebar__brand - will add a theme color to a brand text

  • sidebar__link - should be used on additional links in sidebar, will add proper themed colors

  • sidebar__link--muted - muted modifier for the sidebar link

  • text-theme - will set the text color to the current theme

  • bg-theme - will set the background color to the current theme

JavaScript

You can add predefined script which will handle all of the sidebar behaviour: sidebar menu, sidebar collapsing, animations etc.

Credits and Sources

All of the listed dependencies are being kept up to date.

  • .NET Core 2.X.X

  • ag-grid-community 21.X.X

  • bootstrap 4.X.X

  • font-awesome 4.7.0

  • holderjs ^2.X.X

  • jquery 3.X.X

Previous"Airframe Admin" (Angular)Next"Airframe Admin" (Vue.js)

Last updated