Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/donpotts/abpblazorwasm

abp.io Blazor WASM Project
https://github.com/donpotts/abpblazorwasm

abp blazor dotnet-core

Last synced: 6 days ago
JSON representation

abp.io Blazor WASM Project

Awesome Lists containing this project

README 

        
# abpBlazorWasm



The sites are hosted on free Azure App Services and take time to load when not in use. Go to the server URL first before navigating to the client for the best results.



Server 

![GitHub Actions Workflow Status](https://img.shields.io/github/actions/workflow/status/donpotts/abpBlazorWasm/.github/workflows/abpblazorwasmhttpapihost.yml?logo=github)



https://abpblazorwasmhttpapihost.azurewebsites.net/swagger/index.html



Client 

![GitHub Actions Workflow Status](https://img.shields.io/github/actions/workflow/status/donpotts/abpBlazorWasm/.github/workflows/abpblazorwasm.yml?logo=github)



https://abpblazorwasm.azurewebsites.net/



## License and other information



Refer to the link below for license and other related information concerning abp.io.



https://github.com/abpframework/abp



## About this solution



This is a layered startup solution based on [Domain Driven Design (DDD)](https://docs.abp.io/en/abp/latest/Domain-Driven-Design) practices. All the fundamental ABP modules are already installed. 



### Pre-requirements



* [.NET 8.0+ SDK](https://dotnet.microsoft.com/download/dotnet)

* [Node v18 or 20](https://nodejs.org/en)



### Configurations



The solution comes with a default configuration that works out of the box. However, you may consider to change the following configuration before running your solution:



* Check the `ConnectionStrings` in `appsettings.json` files under the `abpBlazorWasm.HttpApi.Host` and `abpBlazorWasm.DbMigrator` projects and change it if you need.



### Before running the application



#### Generating a Signing Certificate



In the production environment, you need to use a production signing certificate. ABP Framework sets up signing and encryption certificates in your application and expects an `openiddict.pfx` file in your application.



This certificate is already generated by ABP CLI, so most of the time you don't need to generate it yourself. However, if you need to generate a certificate, you can use the following command:



```bash

dotnet dev-certs https -v -ep openiddict.pfx -p cb928750-b262-4ec3-8ae6-ea7535db2305

```



> `cb928750-b262-4ec3-8ae6-ea7535db2305` is the password of the certificate, you can change it to any password you want.



It is recommended to use **two** RSA certificates, distinct from the certificate(s) used for HTTPS: one for encryption, and one for signing.



For more information, please refer to: https://documentation.openiddict.com/configuration/encryption-and-signing-credentials.html#registering-a-certificate-recommended-for-production-ready-scenarios



> Also, see the [Configuring OpenIddict](https://docs.abp.io/en/abp/latest/Deployment/Configuring-OpenIddict#production-environment) documentation for more information.



#### Install Client-Side Libraries



Run the following command in the directory of your final application:



```bash

abp install-libs

```



> This command installs all NPM packages for MVC/Razor Pages and Blazor Server UIs and this command is already run by the ABP CLI, so most of the time you don't need to run this command manually.



#### Create the Database



Run `abpBlazorWasm.DbMigrator` to create the initial database. This should be done in the first run. It is also needed if a new database migration is added to the solution later.



### Solution structure



This is a layered monolith application that consists of the following applications:



* `abpBlazorWasm.DbMigrator`: A console application that applies the migrations and also seeds the initial data. It is useful in development as well as in production environment.

* `abpBlazorWasm.HttpApi.Host`: ASP.NET Core API application that is used to expose the APIs to the clients.

* `abpBlazorWasm.Blazor`: ASP.NET Core Blazor Server application that is the essential web application of the solution.



### Deploying the application



Deploying an ABP application is not different than deploying any .NET or ASP.NET Core application. However, there are some topics that you should care about when you are deploying your applications. You can check ABP's [Deployment documentation](https://docs.abp.io/en/abp/latest/Deployment/Index) before deploying your application.



### Additional resources



You can see the following resources to learn more about your solution and the ABP Framework:



* [Web Application Development Tutorial](https://docs.abp.io/en/abp/latest/Tutorials/Part-1)

* [Application Startup Template Structure](https://docs.abp.io/en/abp/latest/Startup-Templates/Application)

* [LeptonX Lite Blazor UI](https://docs.abp.io/en/abp/latest/Themes/LeptonXLite/Blazor?UI=Blazor)