Ninjadog

The .NET REST API Source Generator

Ninjadog is a .NET REST API source generator that aims to save developers' time by automating the creation of boilerplate code. It follows the Domain Driven Design (DDD) approach and generates REST endpoints, API clients in C# and TypeScript, and much more. With Ninjadog, developers can focus on what's really important: the business logic.

• Ninjadog
  • The long road to MVP
  • How to start
  • The Goal
  • Features
  • Benefits
  • List of generators
    • Ninjadog
    • Ninjadog.Contracts.Data
    • Ninjadog.Contracts.Requests
    • Ninjadog.Contracts.Responses
    • Ninjadog.Database
    • Ninjadog.Endpoints
    • Ninjadog.Mapping
    • Ninjadog.Repositories
    • Ninjadog.Services
    • Ninjadog.Summaries
    • Ninjadog.Validation

The long road to MVP

• Solution that compiles
• Branding
  • Name
  • Logo
  • TagLine
• Benefits of the solution
• Target audience
• Write documentation
• A client demo

How to start

• Create a .NET8 Web API empty project
• Install the NuGet package Ninjadog
• Create your entities following the DDD pattern
• Add an attribute above your entities
• Compile :-)

The Goal

Allow every .NET developer to save their time for what is really important: the business and not the plumbing code.

Features

• Generates REST endpoints based on a DDD approach.
  • Create
  • Read All
  • Read One
  • Update
  • Delete
• Generates API clients in C# and TypeScript.
  • C# client accessible via the endpoint: /cs-client
  • TypeScript client accessible via the endpoint: /ts-client

Benefits

• A LOT of time saved
• LESS code to maintain
• LESS error
• FINISHED the "plumbing code"
• REDUCES the duration of the production launch
• Also generates API clients in C# and TypeScript

List of generators

Ninjadog

• Ninjadog | Single File

Ninjadog.Contracts.Data

• DtoGenerator | By Model

Ninjadog.Contracts.Requests

• CreateRequestGenerator | By Model
• DeleteRequestGenerator | By Model
• GetRequestGenerator | By Model
• UpdateRequestGenerator | By Model

Ninjadog.Contracts.Responses

• GetAllResponseGenerator | By Model
• ResponseGenerator | By Model

Ninjadog.Database

• DatabaseInitializerGenerator | Single File
• DbConnectionFactoryGenerator | Single File

Ninjadog.Endpoints

• CreateEndpointGenerator | By Model
• DeleteEndpointGenerator | By Model
• GetAllEndpointGenerator | By Model
• GetEndpointGenerator | By Model
• UpdateEndpointGenerator | By Model

Ninjadog.Mapping

• ApiContractToDomainMapperGenerator | Single File
• DomainToApiContractMapperGenerator | Single File
• DomainToDtoMapperGenerator | Single File
• DtoToDomainMapperGenerator | Single File

Ninjadog.Repositories

• RepositoryGenerator | By Model
• RepositoryInterfaceGenerator | By Model

Ninjadog.Services

• ServiceGenerator | By Model
• ServiceInterfaceGenerator | By Model

Ninjadog.Summaries

• CreateSummaryGenerator | By Model
• DeleteSummaryGenerator | By Model
• GetAllSummaryGenerator | By Model
• GetSummaryGenerator | By Model
• UpdateSummaryGenerator | By Model

Ninjadog.Validation

• CreateRequestValidatorGenerator | By Model
• UpdateRequestValidatorGenerator | By Model