Skip to content

Navigation Menu

Sign in
Appearance settings

Search code, repositories, users, issues, pull requests...

Provide feedback

We read every piece of feedback, and take your input very seriously.

Saved searches

Use saved searches to filter your results more quickly

Appearance settings

TONYOG12/DotNetApiStarter

Open more actions menu

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

10 Commits
10 Commits
 
 
 
 
 
 

Repository files navigation

DotNetApiStarter

A robust, flexible, and scalable .NET API starter template designed to accelerate the development of enterprise-grade applications. This template includes a pre-configured setup with Entity Framework Core, AutoMapper, JWT authentication, role-based access control, multitenancy, and essential services for cloud storage and logging. Perfect for developers looking to kickstart their .NET projects with a solid foundation.

Features

  • Entity Framework Core: Pre-configured for use with SQL databases and includes an in-memory database setup for testing.
  • AutoMapper: Simplifies object-to-object mapping.
  • JWT Authentication: Implements token-based authentication and role-based access control.
  • Role Management: Predefined roles and easy-to-extend role-based permissions.
  • Multitenancy: Baked-in support for multitenancy to manage multiple clients within a single application instance.
  • Cloud Storage: Integration with MinIO or Azure Blob Storage for file management.
  • Swagger Integration: Auto-generated API documentation with Swagger UI.
  • Logging: Integrated logging with Serilog for better observability and diagnostics.

Getting Started

Prerequisites

Setup Instructions

  1. Clone the repository:

    git clone https://github.com/TONYOG12/DotNetApiStarter.git
    cd DotNetApiStarter
  2. Configure environment variables:

    • Create a .env file in the root directory.
    • Add necessary configurations for the database, JWT, and cloud storage.
  3. Run the application:

    dotnet run
  4. Access Swagger UI:

    Navigate to https://localhost:5001/ to explore the API documentation.

Project Structure

  • /API: Contains the main application logic, controllers, and services.
  • /DOMAIN: Defines the domain entities and core business logic.
  • /INFRASTRUCTURE: Includes data access and external services integration.
  • /SHARED: Holds shared utilities, DTOs, and other cross-cutting concerns.
  • /TESTS: Contains unit and integration tests.

Docker Setup

For instructions on how to set up and run the application using Docker, please refer to the Docker Setup Instructions.

Contributing

Contributions are welcome! Please open an issue or submit a pull request.

About

A flexible .NET API starter template with Entity Framework Core, AutoMapper, JWT authentication, role-based access control, multitenancy, and cloud storage integration. Ideal for quickly building scalable, enterprise-grade applications with a strong foundation.

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors

Morty Proxy This is a proxified and sanitized view of the page, visit original site.