Create Project


Let's make our next cross platform project a success with Bit.Boilerplate.

dotnet new bit-bp --name MyFirstProject 

Name

--name MyFirstProject 

It is required to specify a name for your project.
Captcha

--captcha None 

By setting this parameter to None, CAPTCHA won't be added to the project.
Pipeline

--pipeline GitHub 

Ensure a rapid and reliable deployment by utilizing a pipeline. By selecting GitHub, CI/ CD pipelines will be set up using Github Actions.
Sample

--sample None 
Use this parameter to initialize the project with a sample pages. The two available options are Admin Panel and Todo."
Windows

--windows true 
If you set the windows parameter to false, the Maui project will still be created, but no separate Windows application will be included.
App Center

--appCenter false 
Adding --appCenter true parameter to the dotnet new command allows you to capture errors, crashes, and analytics data seamlessly across all supported platforms.
AppInsights

--appInsights false 
To enable Azure Application Insights for both server and client-side applications (including web), set the appinsights parameter to true. This option will configure the application to store logs such as errors and informational messages.
SignalR

--signalr false 
Enabling this parameter will include sample code for SignalR, which can be used to implement real-time functionalities, such as chat, in your Blazor project.

Note:
This setting does not affect the enabling or disabling of Blazor Server.
File Storage
--filesStorage Local 
The API project includes an Attachment Controller responsible for handling user images, including resizing and saving them in the WebP format using FluentStorage

Local option stores files on local hard drive.
Offline Database

--offlineDb false 
Setting this parameter to True enables SQLite and Entity Framework Core, allowing for the development of an offline-capable cross platform application.

Warning: It is advisable to use this option only when necessary, as integrating Entity Framework Core can increase application size and potentially reduce startup performance.
Server Database

--database Sqlite 
The API project requires an Entity Framework Core DbContext for tables such as ASP.NET Core Identity.

Supported options include SqlServer, PostgreSQL, MySQL, Cosmos, and Other. If you require a database not listed among the options, select Other. After project creation, you can add the desired database package and configure it in the AddDbContextPool method which is located in the Program.Services.cs file within the Server.Api project.

For the default Sqlite option, we'd recommend installing sqlite package for Visual Studio and Visual Studio Code.
API

--api Integrated 
Select the API mode that best aligns with your specific requirements.

Easily debug and deploy Server.Web projects that serves restful API services, SSR, Blazor Server, Blazor Auto and pre-rendering.



Visual Studio


Note: In second window of create new project modal, make sure to check Place solution and project in the same directory checkbox.