/a-simple-blog

.NET Core API

Primary LanguageC#

Simple Blog Application

Simple Blog is a .NET Core 7 application built using Entity Framework as the ORM. The application follows the hexagonal architecture, CQRS, and SOLID design principles. It includes six main methods including create, update, list, make post available, and swagger.

The application uses PostgreSQL as its database and can be easily deployed using Docker Compose. It also comes with simple tests to ensure its functionality.

This repository serves as a showcase of my programming skills and can also serve as a foundation for anyone looking to build a similar API application.

Features

  1. Create, update, and list blog posts
  2. Make blog posts available
  3. Swagger documentation
  4. Hexagonal architecture
  5. CQRS
  6. SOLID design principles
  7. PostgreSQL database
  8. Docker Compose deployment
  9. Simple tests

Getting Started

  1. Clone this repository
  2. Install Docker and Docker Compose
  3. Navigate to the root directory of the cloned repository in your terminal
  4. Run docker-compose up -d
  5. Open your browser and navigate to http://localhost/swagger/index.html to access the Swagger documentation
  6. Test the application using Swagger or your preferred API testing tool

Technologies Used

  • .NET Core 7
  • Entity Framework
  • PostgreSQL
  • Docker Compose

Contributing

If you would like to contribute to this project, please follow the standard GitHub flow:

  1. Fork this repository
  2. Create a new branch for your feature or bug fix
  3. Write your code and tests
  4. Ensure all tests pass
  5. Submit a pull request to this repository