Introduction

This project is an Image Optimization Service built using Node.js and Express. It leverages the Sharp library to perform image transformations such as format conversion, resizing, and quality adjustments. The service is designed to efficiently serve optimized images based on client requests, improving load times and reducing bandwidth usage.

Features

• Dynamic image format conversion (e.g., JPEG, PNG, WebP, AVIF)
• Image resizing capabilities
• Quality adjustment for optimized images
• Caching mechanism to store and retrieve optimized images
• Configurable source directories for image retrieval

Structure

cdn.api.pphat.stackdev.cloud/
├── images/                       # Static assets (if any)
├── uploads/                      # Static assets (if any)
├── src/
│   ├── controllers/              # Main controller handling image requests and processing
│   │   └── images.controller.ts  # Image processing logic using Sharp
│   ├── utils/
│   │   ├── config.ts             # Configuration utilities for source directories
│   │   ├── files.ts              # File handling utilities
│   │   └── image-cache.ts        # Caching utilities for optimized images
│   └── app.ts                    # Express app setup
├── dist/                         # Compiled output directory (after build)
├── package.json                  # Project metadata and dependencies
├── tsenv.json                 # TypeScript configuration
├── README.md                     # Project documentation
└── .gitignore                    # Git ignore file

Getting Started

Prerequisites

• Node.js (version 18 or higher)
• npm (Node Package Manager)

Installation

1. Clone the repository:

git clone https://github.com/pphatdev/cdn.api.pphat.stackdev.cloud.git

2. Navigate to the project directory:

cd cdn.api.pphat.stackdev.cloud

3. Install the dependencies:

npm install

Configuration

1. Create a configuration file (e.g., env.json) in the root directory to specify source directories and other settings.
2. Define the source directories where images are stored.

Example env.json:

{
  "port": 3000,
  "sourceDirectories": [
    "./images",
    "./uploads"
  ]
}

Development

To run the service in development mode with automatic restarts on file changes, use:

npm run dev

Build

After building the project, the compiled files will be located in the dist directory as ES modules.

To build the project, run:

npm run build

Running the Service

Start the server using the following command:

npm start

The server will start on the configured port (default is 3000). You can access the service at http://localhost:3000.