BaDaBoom 1.1.0

BaDaBoom - RAD Framework

Opinionated CRUD Framework providing an application-development quick-start

Using BaDaBoom in a new Project

1. Create an empty repository ⇒ <repositoryUrl>
2. Scaffold a new WEB API solution ⇒ e.g. "MyApi"
3. Run dotnet new gitignore
4. Run git remote add <repositoryUrl>
5. Create the following Solution folders:
   • "1. Web"
   • "2. Business"
   • "3. Data"
   • "4. Entities"
6. Rename the scaffolded project to "MyApi.Web" and place it in the "1. Web" folder
7. Create new class-library project "MyApi.Business" in the "2. Business" folder
8. Create new class-library project "MyApi.Data" in the "3. Data" folder
9. Create new class-library project "MyApi.Enties" in the "4. Entities" folder
10. Run Install-Package BaDaBoom -ProjectName <solutionName>.Enties
11. Add project references from "Web" to "Business", "Business" to "Data" and "Data" to "Entities".
12. Rename the scaffolded classes in the class library projects to match their projectname (e.g. "MyApiData.cs") and make them public and static
13. Add a new class "MyApiDbContext" to the "MyApi.Data" project and have that class extend "BaDaBoomDbContext"
14. Add builder.Services.AddBaDaBoom<SevenSeasDbContext>(options => options); as the first service to add in your "Program.cs" located in the "Web" project.
15. Add app.UseBaDaBoom<SevenSeasDbContext>(app.Environment); as the first call when configuring the HTTP request pipeline in your "Program.cs" and add app.UseBaDaBoomMedia(<mediaUploadPath>); after the call to app.MapControllers
16. Change the call to builder.Services.AddControllers(); to builder.Services.AddControllers(options => { options.Conventions.Add(new RouteTokenTransformerConvention(new SlugifyParameterTransformer())); });.
17. Configure the options for BaDaBoom.
18. In the "Data" project, add package "Microsoft.EntityFrameworkCore.Design" and create an "IDesignTimeDbContextFactory" for your DbContext.
19. Run dotnet ef migrations add Initial in your "Data" project.
20. Run the application, you should now see the Swagger interface, with endpoints for default BaDaBoom entities.
21. Git commit and push your changes

Database migrations

run dotnet ef migrations add "SampleMigration" --project BaDaBoomDev.Infrastructure --startup-project BaDaBoomDev --output-dir Persistence\Migrations to add a new migration.