Added documentation on blazor (jhipster#506)

* Added documentation on blazor client and some other improvment (gitignore)

Author: nicolas63

docs/Features/RunLocal.md renamed to docs/Development/RunLocal.md

@@ -1,13 +1,9 @@
-## Running local Blueprint version for development
-
-During development of blueprint, please note the below steps. They are very important.
+# Running local Blueprint version for development
 
 1. Link your blueprint globally 
 
-Note: If you do not want to link the blueprint(step 3) to each project being created, use NPM instead of Yarn as yeoman doesn't seem to fetch globally linked Yarn modules. On the other hand, this means you have to use NPM in all the below steps as well.
-
 ```bash
-cd dotnetcore
+cd jhipster-dotnetcore
 npm link
 ```
 
@@ -18,9 +14,6 @@ You could also use Yarn for this if you prefer
 ```bash
 cd generator-jhipster
 npm link
-
-cd dotnetcore
-npm link generator-jhipster
 ```
 
 3. Create a new folder for the app to be generated and link JHipster and your blueprint there

docs/Features/fronts.md

@@ -0,0 +1,92 @@
+# Fronts 
+
+## Using Blazor
+
+### Why Blazor ? 
+
+Blazor can run your client-side C# code directly in the browser, using WebAssembly. Because it's real .NET running on WebAssembly, you can re-use code and libraries from server-side parts of your application. (https://dotnet.microsoft.com/apps/aspnet/web-apps/blazor)
+
+### Prerequisites
+
+https://dotnet.microsoft.com/download/dotnet/5.0
+
+### Generate your application 
+
+Call the generator
+
+```bash
+jhipster --blueprints dotnetcore
+```
+
+and choose Blazor (WebAssembly)
+
+![front-choice](../assets/blazor-choice.png)
+
+After that, your application is ready, and you can now use it with default user (admin admin or user user)
+
+You can run the Backend with 
+
+```bash
+dotnet run --verbosity normal --project ./src/YourAppName/YourAppName.csproj
+```
+
+And you can run the Frontend with 
+
+```bash
+dotnet run --verbosity normal --project ./src/client/YourAppName.Client/YourAppName.Client.csproj
+```
+
+You can also use the **hotreload**
+
+For the backend 
+```bash
+ dotnet watch --project ./src/YourAppName/YourAppName.csproj run --verbosity normal
+ ```
+ For the frontend 
+```bash
+ dotnet watch --project ./src/client/YourAppName.Client/YourAppName.Client.csproj run --verbosity normal
+ ```
+
+### Generate entities 
+
+Like the others front technologies you can generate entities for blazor
+
+With cli 
+```bash
+jhipster entity <entity-name>
+```
+
+or with jdl (https://start.jhipster.tech/jdl-studio/)
+```bash
+jhipster import-jdl my_file.jdl
+```
+
+### Tools 
+
+As the project used SASS, to install and consume scss third parties libraries like bootstrap we use Microsoft Library Manager (aka [libman](https://github.com/aspnet/LibraryManager)) 
+You can find libman configuration in same directory than client solution (./src/client/YourAppName.Client)
+
+To minify css we use Excubo.WebCompiler (aka [webcompiler](https://github.com/excubo-ag/WebCompiler))
+
+These two tools are installed during jhipster client generation, and you can find the execution in client csproj (./src/client/YourAppName.Client/YourAppName.Client.csproj)
+
+### UI components 
+
+To speed up our development we use [Blazored](https://github.com/Blazored) components like Blazored.Modal or Blazored.SessionStorage. 
+
+We also use [Blazorise](https://github.com/stsrki/Blazorise) which has really interesting components.
+
+### UT 
+
+For unit test we use the awesome library [bUnit](https://github.com/egil/bUnit).
+
+You can find client unit test in ./test/YourAppName.Client.Test
+
+### Limitations 
+
+For the moment, the Blazor generation has certain limitations : 
+
+- Only support DTO you can't use application without DTO 
+- No validation on entity fields (The validation is only on user management part)
+- No translation 
+- Only JWT security is implemented 

docs/assets/blazor-choice.png

@@ -23,6 +23,7 @@ You can also find lot of information in https://www.jhipster.tech
   :hidden:
   :caption: Features
 
+  Features/fronts
   Features/services
   Features/dto
   Features/repository
@@ -31,6 +32,13 @@ You can also find lot of information in https://www.jhipster.tech
   Features/monitoring
   Features/security
 
+.. toctree::
+  :maxdepth: 3
+  :hidden:
+  :caption: Development
+
+  Development/RunLocal
+
 .. toctree::
   :maxdepth: 3
   :hidden:

docs/index.rst

@@ -73,9 +73,9 @@
   </Target>
 
   <Target Name="CompileStaticAssets" AfterTargets="AfterBuild">
-    <Exec Command="webcompiler -r wwwroot/content/scss -o wwwroot/content/css -z disable -p disable" StandardOutputImportance="high" />
-    <Exec Command="webcompiler -r wwwroot/content/scss -o wwwroot/content/css -z disable -p disable -m disable" StandardOutputImportance="high" />
-   </Target>
+    <Exec Command="webcompiler -r wwwroot/content/scss -o wwwroot/content/css -z disable -m disable" Condition="'$(Configuration)'=='Debug'" StandardOutputImportance="high" />
+    <Exec Command="webcompiler -r wwwroot/content/scss -o wwwroot/content/css -p disable" Condition="'$(Configuration)'=='Release'" StandardOutputImportance="high" />
+  </Target>
 
   <ItemGroup>
     <!--specify file extensions here as needed-->

generators/client/templates/blazor/src/Project.Client/Project.Client.csproj.ejs

@@ -24,9 +24,13 @@ npm-debug.log.*
 .vs
 .vscode
 
-#Angular
-**/wwwroot/
+# Web
 **/ClientApp/dist/
+!**/wwwroot/content/css/loading.css
+!**/wwwroot/content/images/**
+!**/wwwroot/content/scss/**
+!**/wwwroot/index.html
+!**/wwwroot/favicon.ico
 
 # User-specific files
 *.suo