Files

elpatron e6fbe84d58 Add Docker-Compose setup with configurable local port via .env.

Document container startup and local port configuration in README, including a .env example for quick setup.

Made-with: Cursor

2026-04-02 18:44:07 +02:00

1.4 KiB

Raw Blame History

Elpatrons Date Calculator

A modern Python web application (Flask) that enables various date calculations through a clear, accessible web interface. Features include calculating days between dates, working days with state-specific holidays, calendar weeks, date arithmetic, and more. The application supports German and English languages, includes a REST API, and is designed with accessibility in mind.

Documentation

English Documentation - Complete documentation in English
Deutsche Dokumentation - Vollständige Dokumentation auf Deutsch

Quick Start

pip install -r requirements.txt
python app.py

Docker Compose

Run the app with Docker Compose and configure the local host port via .env.

Create a .env file in the project root (or copy .env.example):

# macOS / Linux
cp .env.example .env

# Windows (PowerShell)
Copy-Item .env.example .env

Set the local host port in .env:

LOCAL_PORT=5000

Build and start the container:

docker compose up --build -d

Open the app in your browser:

http://localhost:<LOCAL_PORT>

Visit https://date.elpatron.me for the live demo.

License

This project is licensed under the MIT License.