Plugga.Core.Templates 1.3.1

Plugga.Core.Templates

Plugga.Core lets you quickly create modular ASP .Net Core applications searching, loading and configuring any "pluggable" component. Pluggable components are a little set of commonly used objects as Controllers, DbContexts, Razor Pages, SignalR Hubs, HostedServices, static assets and, of course, your own component objects.

How to setup your development environment

A Plugga.Core enabled solution can be easaly created using one of the templates availables with th Plugga.Core.Templates package. It can be installed running the command:

dotnet new -i Plugga.Core.Templates.<version>

After installing the Plugga.Core.Templates package you can:

• Setup the Solution
• Create Components

Setup the Solution

Open a terminal and run:

dotnet new pluggarun -n PluggableApp -o PluggableApp
cd PluggableApp
dotnet build

This should produce something similar to:

PluggableApp
│   PluggableApp.sln
│
├───PluggableApp.Run
│   │   ... source files ...
|   ...
│
└───Runtime
    │   ... runtime files ...
    │
    ├───Database
    ├───Log
    │
    └───Pluggables

Note: If the build has been successfully completed but the PluggableApp\Runtime directory does not contains any binary file, please try to build the solution again.

Create Components

Open a terminal and run:

cd PluggableApp 
dotnet new pluggable -n FirstPluggable
dotnet sln PluggableApp.sln add Pluggables\Pluggable.FirstPluggable\Pluggable.FirstPluggable.csproj 
dotnet build

Note: You should run this command from your previously created solution directory.

This should produce something similar to:

PluggableApp
│   PluggableApp.sln
│
├───PluggableApp.Run
│   │   ... source files ...
|   ...
│
├───Pluggables
│   └───Pluggable.FirstPluggable
│       │   ... source files ...
│       ...
│
└───Runtime
    │   ... runtime files ...
    │
    ├───Database
    ├───Log
    │
    └───Pluggables
        └───FirstPluggable
            │   ... runtime files ...
            ... 

Note: The template creates, if not exists, a Pluggables directory and the project within this directory.

Test your environment

Open a terminal and run:

cd PluggableApp 
cd Runtime 
PluggableApp.Run.exe

Navigate to http://localhost:5123/FirstPluggable/Dashboard