aeciopires/countdown repository overview

⁠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