An open API service indexing awesome lists of open source software.

https://github.com/armanidrisi/nestjs-rest-api

Simple CRUD Rest API In Nestjs
https://github.com/armanidrisi/nestjs-rest-api

arman-idrisi armanidrisi basic-crud-api crud-api nest-js nestjs nestjs-api nestjs-backend nestjs-postgresql nestjs-restapi nodejs nodejs-api nodejs-crud typescript typescript-nestjs

Last synced: 3 months ago
JSON representation

Simple CRUD Rest API In Nestjs

Awesome Lists containing this project

README

        


Nest Logo

# NestJs Crud CRUD API ๐Ÿš€

[![GitHub license](https://img.shields.io/github/license/Armanidrisi/nestjs-rest-api.svg)](https://github.com/Armanidrisi/nestjs-rest-api/blob/master/LICENSE)
[![GitHub issues](https://img.shields.io/github/issues/Armanidrisi/nestjs-rest-api.svg)](https://github.com/Armanidrisi/nestjs-rest-api/issues)
[![GitHub stars](https://img.shields.io/github/stars/Armanidrisi/nestjs-rest-api.svg)](https://github.com/Armanidrisi/nestjs-rest-api/stargazers)

> A simple and straightforward CRUD API built with NestJS framework. ๐ŸŒŸ

## Features โœจ

- ๐ŸŒ Basic CRUD operations (Create, Read, Update, Delete).
- โš™๏ธ Modular and scalable architecture using NestJS modules.
- ๐Ÿ› ๏ธ Built-in validation and error handling.
- ๐Ÿ“ฆ Ready-to-use configuration for database connectivity.
- ๐Ÿ”„ Logging and request/response interception for debugging.
- ๐Ÿงช Unit tests with Jest for ensuring code quality.

## Installation ๐Ÿ› ๏ธ

Ensure you have [Node.js](https://nodejs.org) and [npm](https://www.npmjs.com/) installed on your system. Then, follow these steps:

1. Clone the repository:

```bash
git clone https://github.com/Armanidrisi/nestjs-rest-api.git
```

2. Navigate to the project directory:

```bash
cd nestjs-rest-api
```

3. Install the dependencies:

```bash
npm install
```

4. Set up the configuration file:

```bash
cp .env.example .env
```

5. Customize the `.env` file with your configuration settings.

## Usage ๐Ÿš€

To start the development server, run the following command:

```bash
npm run start:dev
```

Visit [http://localhost:3000](http://localhost:3000) to access the API.

## API Endpoints ๐Ÿ›ฃ๏ธ

The API exposes the following endpoints:

- `GET /items`: Get all items.
- `GET /items/:id`: Get a specific item by ID.
- `POST /items`: Create a new item.
- `PUT /items/:id`: Update an existing item.
- `DELETE /items/:id`: Delete an item.

## Testing ๐Ÿงช

To run the unit tests, execute the following command:

```bash
npm run test
```

## ๐Ÿš€ Frameworks/Technologies Used

- NestJS: Framework for building scalable and maintainable server-side applications.
- PostgreSQL: Relational database management system.

## Contributing ๐Ÿค

Contributions are welcome! Please follow these steps to contribute:

1. Fork the repository.
2. Create a new branch.
3. Make your changes.
4. Commit and push your code.
5. Submit a pull request.

## License ๐Ÿ“

This project is licensed under the [MIT License](https://opensource.org/licenses/MIT).

## Issues ๐Ÿ›

If you encounter any issues or have suggestions, please [open an issue](https://github.com/Armanidrisi/nestjs-rest-api/issues).

## Stay in Touch ๐Ÿ‘‹

- Author: Arman Idrisi
- Follow: [GitHub](https://github.com/Armanidrisi/)

Feel free to reach out if you have any questions or feedback!

---

Enjoy using the Simple CRUD API! If you find it helpful, please give it a โญ๏ธ to show your support.