countdown

• countdown
  • Structure
  • Running using Docker
  • Running locally without Docker
  • Build image
• Developers
• License

A simple stateless web application written in Golang that simulates a countdown timer. The frontend (HTML/JS/CSS) is embedded directly in the Go binary, making deployment easy.

Structure

• Backend: Go (net/http, embed)
• Frontend: HTML5, CSS3, Vanilla JS
• Container: Docker (Multi-stage build)

Running using Docker

Install Docker: https://docs.docker.com/get-started/get-docker/

Run the container

docker run -d -p 8080:8080 --rm --name countdown aeciopires/countdown:1.0.0

Access the application at http://localhost:8080.

You can change the default port using an environment variable.

docker run -p 3000:3000 -e PORT=3000 --rm --name countdown aeciopires/countdown:1.0.0

Access the application at http://localhost:3000.

Running locally without Docker

Install Golang (1.25+): https://go.dev/doc/install

Run the application:

cd app
go mod init countdown
go run main.go

Access the application at http://localhost:8080.

Build image

Requirements:

• Install make (https://www.gnu.org/software/make/)
• Install Docker (https://docs.docker.com/get-started/get-docker/)
• Install Golang (1.25+): (https://go.dev/doc/install)

Run the command.

cd app
make image

Developers

Aécio dos Santos Pires
https://linktr.ee/aeciopires

License

GPL-3.0 2025 Aécio dos Santos Pires