https://github.com/alvinscheibe/fastify-ddd
🚧 A study project implementing Domain-Driven Design (DDD) architecture using Fastify and TypeScript. This repository explores best practices for structuring scalable backend applications.
https://github.com/alvinscheibe/fastify-ddd
api-rest ddd-architecture domain-driven-design fastify nodejs typescript
Last synced: about 2 months ago
JSON representation
🚧 A study project implementing Domain-Driven Design (DDD) architecture using Fastify and TypeScript. This repository explores best practices for structuring scalable backend applications.
- Host: GitHub
- URL: https://github.com/alvinscheibe/fastify-ddd
- Owner: alvinscheibe
- Created: 2025-08-02T21:16:33.000Z (11 months ago)
- Default Branch: main
- Last Pushed: 2025-09-11T02:04:29.000Z (10 months ago)
- Last Synced: 2025-09-11T05:48:48.712Z (10 months ago)
- Topics: api-rest, ddd-architecture, domain-driven-design, fastify, nodejs, typescript
- Language: TypeScript
- Homepage:
- Size: 177 KB
- Stars: 0
- Watchers: 0
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# Fastify DDD Study Project
This project is a work-in-progress study aimed at implementing an API architecture using **Domain-Driven Design (DDD)** principles with **Fastify** and **TypeScript**.
## Description
The main goal of this project is to deepen the understanding and practical application of DDD concepts in Node.js backend development. Inspired by modern architecture patterns, the structure is designed to be scalable, maintainable, and oriented around the business domain.
> **Note:** This project is under active development. Feedback and suggestions are welcome!
## Project Structure
The codebase is organized according to DDD principles, separating responsibilities into distinct layers:
- **Domain:** Contains core business entities, value objects, and repository interfaces.
- **Application:** Encapsulates use cases and application services.
- **Infra:** Holds concrete implementations for repositories, controllers, database configuration, and integrations with external services.
- **Interfaces:** Deals with external communication, including DTOs, mappers, validators, and presentation-layer controllers.
```
src/
├── domain/
├── application/
├── infra/
└── interfaces/
```
## Technologies Used
- **Node.js v20**: JavaScript runtime.
- **Fastify**: High-performance Node.js web framework.
- **TypeScript**: Static typing for JavaScript.
- **Commitlint**: Linting for commit messages.
- **ESLint**: Static code analysis for code quality.
- **Prettier**: Code formatting.
- **Husky**: Git hooks for enforcing code standards.
## Getting Started
### Prerequisites
- [Node.js](https://nodejs.org/) (v20 or higher)
- Yarn (package manager, installed globally)
### Installation
Clone the repository:
```bash
git clone https://github.com/alvinscheibe/fastify-ddd.git
```
Navigate to the project directory:
```bash
cd fastify-ddd
```
Install dependencies:
```bash
yarn
```
### Usage
To start the development server:
```bash
yarn dev
```
By default, the server will be available at [http://localhost:3333](http://localhost:3333)
API documentation should be accessible at [http://localhost:3333/docs](http://localhost:3333/docs) if enabled.
## License
This project is intended for educational purposes and does not have a specific license yet.