Containerization

The Green Ecolution Frontend can be run as a Docker container. The prebuilt image is available in the GitHub Container Registry and can be pulled using the following command:

docker pull ghcr.io/green-ecolution/green-ecolution-frontend:latest

To start the container, run:

docker run -d -p 80:80 --name green-ecolution-frontend ghcr.io/green-ecolution/green-ecolution-frontend:latest

This will launch the container in the background, making it accessible via port 80.

Note

The frontend may require a running backend service to function correctly. By default, it expects the backend to be available under /api. Ensure that the backend is running and accessible before starting the frontend.

Dockerfile Overview

The Docker image follows a multi-stage build strategy to efficiently containerize the application:

• OpenAPI Builder Stage: Generates a client for backend communication from the OpenAPI specification.
• Web Builder Stage: Installs dependencies, builds the backend client, and compiles the frontend application.
• Nginx Stage: Serves the built frontend using Nginx with a custom configuration.

The frontend is built with Node.js and served via Nginx, ensuring a lightweight and performant deployment.